
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. [1] https://github.com/sphinx-doc/sphinx/commit/e3483e9b045 Change-Id: I07c753f5070fe887faf4f103b3f46bff59e3d1be
81 lines
1.8 KiB
INI
81 lines
1.8 KiB
INI
[tox]
|
||
minversion = 2.0
|
||
envlist = py27,py37,pypy,pep8
|
||
|
||
[testenv]
|
||
install_command = pip install {opts} {packages}
|
||
whitelist_externals =
|
||
/bin/sh
|
||
deps =
|
||
-c{env:UPPER_CONSTRAINTS_FILE:://releases.openstack.org/constraints/upper/master}
|
||
-r{toxinidir}/test-requirements.txt
|
||
-r{toxinidir}/requirements.txt
|
||
commands = stestr run --slowest {posargs}
|
||
|
||
[testenv:py27]
|
||
basepython = python2.7
|
||
|
||
[testenv:pep8]
|
||
basepython = python3
|
||
deps =
|
||
-r{toxinidir}/test-requirements.txt
|
||
commands =
|
||
flake8
|
||
# Run security linter
|
||
bandit -r oslo_privsep -x tests -n5 --skip B404,B603
|
||
|
||
[testenv:venv]
|
||
basepython = python3
|
||
commands = {posargs}
|
||
|
||
[testenv:docs]
|
||
basepython = python3
|
||
whitelist_externals =
|
||
rm
|
||
deps =
|
||
{[testenv]deps}
|
||
-r{toxinidir}/doc/requirements.txt
|
||
commands =
|
||
rm -rf doc/build
|
||
sphinx-build -W --keep-going -b html doc/source doc/build/html
|
||
|
||
[testenv:cover]
|
||
basepython = python3
|
||
setenv =
|
||
PYTHON=coverage run --source $project --parallel-mode
|
||
commands =
|
||
stestr run {posargs}
|
||
coverage combine
|
||
coverage html -d cover
|
||
coverage xml -o cover/coverage.xml
|
||
|
||
[flake8]
|
||
# E123, E125 skipped as they are invalid PEP-8.
|
||
# [H106] Don’t put vim configuration in source files
|
||
# [H203] Use assertIs(Not)None to check for None
|
||
|
||
show-source = True
|
||
ignore = E123,E125
|
||
builtins = _
|
||
exclude=.venv,.git,.tox,dist,doc,*lib/python*,*egg,build
|
||
enable-extensions = H106,H203
|
||
|
||
[hacking]
|
||
import_exceptions =
|
||
oslo_privsep._i18n
|
||
|
||
[testenv:releasenotes]
|
||
basepython = python3
|
||
whitelist_externals =
|
||
rm
|
||
commands =
|
||
rm -rf releasenotes/build
|
||
sphinx-build -a -E -W -d releasenotes/build/doctrees --keep-going -b html releasenotes/source releasenotes/build/html
|
||
|
||
[testenv:lower-constraints]
|
||
basepython = python3
|
||
deps =
|
||
-c{toxinidir}/lower-constraints.txt
|
||
-r{toxinidir}/test-requirements.txt
|
||
-r{toxinidir}/requirements.txt
|