jenkins-job-builder/tox.ini
Darragh Bailey 3faecfd76a Add separate linkcheck env and allow dev to select builder
Add separate linkcheck tox environment to be used in non-voting Jenkins
job to watch for stale and broken links in the sphinx generated html
documentation. Include a small addition to make it easier for
contributors to select individual builders when executing the docs tox
environment.

Add minimum dependency of pbr 1.0.0, as that was the first version to
allow passing of sphinx builders on the command line to override the
internal defaults or those set in the configuration file.

This will make it easier to spot problems with just the links, and also
ensure that when the sphinx project releases with proper warniserror fix
for the linkcheck builder, that html and man page documentation can
continue to be built even if a previous valid link has become stale or
is temporarily unreachable.

Change-Id: I80446abe96824a444a04cc526df6cc38632a4607
2016-01-11 13:06:17 +00:00

50 lines
1.3 KiB
INI

[tox]
minversion = 1.6
envlist = pep8, py34, py27
[testenv]
# Note(Vek): JJB is not compatible with a non-zero PYTHONHASHSEED
setenv = VIRTUAL_ENV={envdir}
SUBUNIT_FORMATTER=tee testr_subunit_log
OS_STDOUT_NOCAPTURE=False
PYTHONHASHSEED=0
LANG=en_US.UTF-8
usedevelop = True
install_command = pip install {opts} {packages}
deps = -r{toxinidir}/test-requirements.txt
commands = python setup.py testr --slowest --testr-args='{posargs}'
[testenv:cover]
commands =
python setup.py test --coverage --coverage-package-name=jenkins_jobs
coverage report
[testenv:pep8]
commands = flake8
[testenv:pyflakes]
deps = pyflakes
commands = pyflakes jenkins_jobs tests setup.py
[testenv:compare-xml-old]
commands = jenkins-jobs test -o .test/old/out/ .test/old/config/
[testenv:compare-xml-new]
commands = jenkins-jobs test -o .test/new/out/ .test/new/config/
[testenv:docs]
commands = python setup.py build_sphinx {posargs}
[testenv:docs-linkcheck]
commands = python setup.py build_sphinx -b linkcheck
[testenv:venv]
commands = {posargs}
[flake8]
# These are ignored intentionally in openstack-infra projects; please
# don't submit patches that solely correct them or enable them.
ignore = E125,H
show-source = True
exclude = .venv,.tox,dist,doc,build,*.egg,.test