This repo is now testing only with Python 3, so let's make
a few cleanups:
- Remove obsolete sections from setup.cfg
- Use warnings for sphinx-build
- Cleanup doc/source/conf.py to remove now obsolete content.
Change-Id: I49d20c142af9345125540de61e9476f317ab6a38
We want to default to running all tox environments under python 3, so
set the basepython value in each environment.
We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.
We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.
Change-Id: I7b41835ed28d6fc09cfd579b4b5a9d0b67ca10ec
Closes-Bug: #1801657
1. Sphinx 1.8 introduced [1] the '--keep-going' argument which, as its name
suggests, keeps the build running when it encounters non-fatal errors.
This is exceptionally useful in avoiding a continuous edit-build loop
when undertaking large doc reworks where multiple errors may be
introduced.
2. Remove the unnecessary blank line for tox.ini
[1] https://github.com/sphinx-doc/sphinx/commit/e3483e9b045
Depends-On: Ie837d376bb1a1d93367369d25140dd8a9d5ac14e
Change-Id: I476525b7ca565e81b4bd303263902f5bbaa80632
This patch adds a `pdf-docs` tox target that will build
PDF versions of our docs. As per the Train community goal:
https://governance.openstack.org/tc/goals/selected/train/pdf-doc-generation.html
Add sphinxcontrib-svg2pdfconverter to doc/requirements.txt
to convert our SVGs.
Change-Id: Ic5d3234ca20699222eb7c866e269fec9690a4f49
Story: 2006105
The openstack-ansible-linters job runs the linters tox environment - and
the docs jobs runs the docs environment.
Remove the docs jobs from the linters environment, there's no need to
run the docs jobs in both linters and docs environment, it just wastes
testing resources.
Change-Id: Ie72970439c498f7c4ff274138544af0611376e87
We want to default to running all tox environments under python 3, so
set the basepython value in each environment.
We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.
We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.
Change-Id: Ib2feb65b1f23578ea7ddcff4802425a5a5708a0f
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
The functional test check the responsiveness of the Blazar API. A
return of 204 code from the API verifies the success.
Rest of the changes ensure compliance with all the standards required
to make the linter and docs tests pass.
Change-Id: I640877817ad1ae312436932af87ad15094616f12
Using tox for requirements management requires in-repo
requirements files for all our repositories. Rather than
do that, we make use of the tests repo to capture our
common requirements and use this to install them.
This reduces our review requirement rate and simplifies
maintenance for us for the tox config. It also makes it
usable with 'Depends-On', which is marvellous!
The tox requirements definitions for docs/releasenotes
builds are left in-place as those are standard entries
across the community. If that changes at some point, we
can re-assess those entries too.
Some old test cruft is also removed.
Depends-On: https://review.openstack.org/579208
Change-Id: Iee798c2660f69afe7c40cd3d2e9b801434944eff
Jonathan Rosser