so that we can run 'tox' locally and properly validate our spec docs. * Update tox minversion and requirements * Clean out build directory before new docs build * Run doc8 validation * Fix numerous incidental errors in the specs and templates so that doc8 now passes * Setup both py35 and py27 environments * Turn off yasfb extension until it can work with python 3 Change-Id: I722a9ad852cdfa0974322fbe29db37956dab3ee0
33 lines
848 B
INI
33 lines
848 B
INI
[tox]
|
|
minversion = 2.0
|
|
envlist = docs,py35,py27
|
|
skipsdist = True
|
|
|
|
[testenv]
|
|
usedevelop = True
|
|
install_command = pip install -U {opts} {packages}
|
|
setenv =
|
|
VIRTUAL_ENV={envdir}
|
|
deps = -r{toxinidir}/requirements.txt
|
|
-r{toxinidir}/test-requirements.txt
|
|
whitelist_externals = echo
|
|
commands = echo 'None of tests exist. It is placeholder.'
|
|
|
|
[testenv:venv]
|
|
commands = {posargs}
|
|
|
|
[testenv:docs]
|
|
whitelist_externals = rm
|
|
commands =
|
|
rm -rf doc/build
|
|
python setup.py build_sphinx
|
|
# Ignore D001 since we allow lines in excess of 79 characters.
|
|
doc8 --ignore D001 --ignore-path .tox --ignore-path .eggs --ignore-path doc/build --ignore-path manila_specs.egg-info -e txt -e rst
|
|
|
|
[testenv:spelling]
|
|
deps =
|
|
-r{toxinidir}/requirements.txt
|
|
sphinxcontrib-spelling
|
|
PyEnchant
|
|
commands = sphinx-build -b spelling doc/source doc/build/spelling
|