This commit moves the oslo config generator config file from living as
a data file, which makes it very difficult to rely on, to just living
in the package. By including it in the package we have a guaranteed
relative path we can rely on for building utilities on it, like the
tempest init command.
Change-Id: I5b9deae733f42fe3ed39418103304f71b43dccb3
Partially-implements: bp tempest-run-cmd
This commit disables SmartyPants feature for docs because it renders
'--' to '–'(–) but it's not good for command options.
Change-Id: Ic5ef2c648e9e888dc8ce19c4038c39842b66cfd9
os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.
Change-Id: I0751dbda085922d5e390cb7a19a9e832d399e20b
Partial-Bug: #1529836
Init command was not working properly as it could not locate the
configuration sample file.
Steps taken:
- Move config-generator.tempest.conf to etc so it will be installed
with pbr.
- Update all files with new path to config-generator-tempest.conf as
needed.
- Refactor init command so if it detects we are not in a virtual
environment, try to find the global config directory /etc/tempest.
If that fails fallback to [sys.prefix]/etc/tempest.
Closes-Bug: #1491058
Closes-Bug: #1490670
Change-Id: I960bc711ff78ac2b0441ef63dff8ec4fb268fd3a
This commit switches to using the oslo.config sphinx extension to
generate a sample config instead of doing it manually in the docs'
conf.py module.
Change-Id: I7032cb4f56c728911ffa5c6911eb504f53bc80af
The expectation from users is that to build docs locally all you need
to do is run build_sphinx on the repo and the docs will be fully
created. When we added the sample config to the tempest docs we ignored
this and just added the sample config generation to the docs tox job.
This commit fixes this by baking in the sample config generation to
the sphinx conf.py file which should ensure we have the sample config
generated every time that we call build_sphinx.
Change-Id: Ifd570707847f52592f5bc9bc743b8d3c98512639
Remove intersphinx from the docs build as it triggers network calls that
occasionally fail, and we don't really use intersphinx (links other
sphinx documents out on the internet)
This also removes the requirement for internet access during docs build.
This can cause docs jobs to fail if the project errors out on
warnings.
Change-Id: Icdb04bbe9eb931b07e7363ebb852fa9e73b088ea
Related-Bug: #1368910
This commit moves switches tempest from the d2to1 version of pbr and
move to the latest version of pbr. However, there is a bug with
build_spinx so it doesn't work with a doc version set so that section
is removed from the doc conf.py.
Change-Id: I4fe14eb2b2e81132f8fa99936a031176b38c437b
This commit updates the docs conf.py to make it more closely resemble
what is used it other projects(based on nova's equivilent file). It
also removes listing Sean Dague as the sole author for the Tempest
docs because it is a collaborative effort. It also fixes a pep8
failure on the imports.
Change-Id: I535858dc9d413e8d5f92d44194137f615390d117
bug 1192692
Sphinx isn't configured to load the tempest modules,
so the easiest fix is to remove the links to the
general and module indices (which don't exist).
Change-Id: Ic33e0b6ce56cb31fa51b4cdce25524d40191235d
adjust the index file to be more readable for the field guide
adjust titles to make more sense when displayed in top level index
change theme to 'nature', which is closer to the openstack default
style. Will eventually write our own style here.
Change-Id: I4f5fed65f9e26a4e4d333b1be4ed02c9ec246b9a
This is a first bit of experiment to get a doc tree for tempest
that will publish our doc content to the web as part of a larger
QA doc guide.
Update some of the base READMEs to be a little more accurate,
now that we're going to be pushing them to the web.
Added tox [venv] to ensure that docs get built
Change-Id: Id54e8fbc1d884525087630106e17b37dc1206cc9