Commit Graph

13 Commits

Author SHA1 Message Date
Matthew Treinish
bdef1c77ab
Move oslo config generator config inside package
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
2016-06-22 14:39:42 -04:00
Masayuki Igawa
44ca9edd3b Disable SmartyPants for docs
This commit disables SmartyPants feature for docs because it renders
'--' to '–'(–) but it's not good for command options.

Change-Id: Ic5ef2c648e9e888dc8ce19c4038c39842b66cfd9
2016-06-10 09:25:48 +09:00
Harshada Mangesh Kakad
d11d5ee09d Fixing the deprecated library function.
os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.

Change-Id: I0751dbda085922d5e390cb7a19a9e832d399e20b
Partial-Bug: #1529836
2015-12-31 01:39:54 -08:00
David Paterson
0bf52d497b Fix init command
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
2015-09-23 09:42:07 -04:00
Matthew Treinish
1719dfeb69 Use the oslo.config sphinx module to generate sample
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
2015-08-25 14:21:43 +00:00
Matthew Treinish
13ed69fffc
Bake in oslo sample config generation to sphinx build
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
2015-08-11 10:13:03 -04:00
Christian Berendt
bf48dafdb3 Stop using intersphinx
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
2014-09-25 10:06:42 +02:00
Dirk Mueller
82ba4286e0 Switch over to oslosphinx
oslosphinx is the new name of oslo.sphinx

Closes-Bug: #1277168
Change-Id: Ibfb9e59fbb3ef51a821b4f412601e26cb7f703f4
2014-02-14 18:16:53 +01:00
Matthew Treinish
271139aa7f Update to latest pbr
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
2013-10-24 14:21:19 +00:00
Matthew Treinish
6d5c0528be Update docs config
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
2013-09-25 14:09:46 +00:00
Michael Chapman
4410ca1c56 Fix index link in footer bar
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
2013-06-28 10:54:32 +10:00
Sean Dague
7679b488ed update docs for consistency
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
2013-05-24 08:49:44 -04:00
Sean Dague
b56052b475 initial seed for tempest doc directory
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
2013-05-22 21:06:55 -04:00