Update docs building

Update docs building:
* Switch to sphinx-build
* Update requirements for Sphinx and openstackdocstheme for
  python 3, create doc/requiremetns
* Remove unneeded doc and translation sections from setup.cfg
* Remove install_command, it's unneeded, the default is fine.
* Move constraints to deps, use TOX_CONSTRAINTS instead of obsolete
  UPPER_CONSTRAINTS
* Remove now unneeded placeholder file

Change-Id: I649e6fa86c17262698cc8a01d042a87b020239d9
This commit is contained in:
Andreas Jaeger 2020-05-03 11:42:17 +02:00
parent b6d544c27f
commit 6053cba01a
5 changed files with 11 additions and 22 deletions

5
doc/requirements.txt Normal file
View File

@ -0,0 +1,5 @@
sphinx>=2.0.0,!=2.1.0 # BSD
openstackdocstheme>=2.0.0 # Apache-2.0
# releasenotes
reno>=2.5.0 # Apache-2.0

View File

@ -24,20 +24,6 @@ classifier =
packages =
murano_tempest_tests
[compile_catalog]
directory = murano_tempest_tests/locale
domain = murano_tempest_tests
[update_catalog]
domain = murano_tempest_tests
output_dir = murano_tempest_tests/locale
input_file = murano_tempest_tests/locale/murano_tempest_tests.pot
[extract_messages]
keywords = _ gettext ngettext l_ lazy_gettext
mapping_file = babel.cfg
output_file = murano_tempest_tests/locale/murano_tempest_tests.pot
[entry_points]
tempest.test_plugins =
murano_tests = murano_tempest_tests.plugin:MuranoTempestPlugin

View File

@ -6,10 +6,6 @@ hacking>=3.0,<3.1.0;python_version>='3.5' # Apache-2.0
coverage!=4.4,>=4.0 # Apache-2.0
python-subunit>=1.0.0 # Apache-2.0/BSD
sphinx!=1.6.6,!=1.6.7,>=1.6.2 # BSD
oslotest>=3.2.0 # Apache-2.0
testrepository>=0.0.18 # Apache-2.0/BSD
testtools>=2.2.0 # MIT
openstackdocstheme>=1.18.1 # Apache-2.0
# releasenotes
reno>=2.5.0 # Apache-2.0

10
tox.ini
View File

@ -1,18 +1,17 @@
[tox]
minversion = 3.1.1
envlist = py35,py27,pypy,pep8
envlist = py36,pypy,pep8
skipsdist = True
ignore_basepython_conflict = True
[testenv]
basepython = python3
usedevelop = True
install_command = pip install {opts} {packages}
setenv =
VIRTUAL_ENV={envdir}
PYTHONWARNINGS=default::DeprecationWarning
deps = -r{toxinidir}/test-requirements.txt
-c{env:UPPER_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master}
-c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master}
commands = python setup.py test --slowest --testr-args='{posargs}'
[testenv:pep8]
@ -25,9 +24,12 @@ commands = {posargs}
commands = python setup.py test --coverage --testr-args='{posargs}'
[testenv:docs]
commands = python setup.py build_sphinx
deps = -r{toxinidir}/doc/requirements.txt
-c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master}
commands = sphinx-build -W -b html doc/source doc/build/html
[testenv:releasenotes]
deps = {[testenv:docs]deps}
commands =
sphinx-build -a -E -W -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html