zuul-jobs/roles/sphinx
Ian Wienand eee316ce7b Enable Python 2.7 unit tests
Add a testenv:py27 environment that overrides basepython to 2.7

Unfortunately implicit namespace packages are a Python3 thing [1] so
we have to scatter a few __init__.py's around for the test loader
under python2 to be able to find the unit test directories.

Update documenation to mention this

Needed-By: https://review.openstack.org/592768

[1] https://www.python.org/dev/peps/pep-0420/

Change-Id: I9a653666e8a083fb7f3fbb92589fe0467a41e6e6
2018-08-17 10:23:20 +10:00
..
defaults Add general sphinx and reno jobs and role 2017-11-20 17:59:28 -06:00
library Add a python unit test framework 2018-07-25 09:11:25 -07:00
tasks Fix non-standard docs build 2017-12-26 13:29:12 +01:00
__init__.py Enable Python 2.7 unit tests 2018-08-17 10:23:20 +10:00
README.rst Default warning-is-error to True for non-legacy Sphinx projects 2018-05-10 09:23:57 +01:00

Run sphinx to generate documentation

Role Variables

Whether to treat sphinx build warnings as errors. Defaults to the value of [build_sphinx] warning-is-error in setup.cfg if defined, False if the [build_sphinx] section is present but the warning-is-error option is undefined, or True if the entire section is undefined.