tox.ini

[tox]
minversion = 3.1
envlist = py3,pep8
skipsdist = True
ignore_basepython_conflict = True

[testenv]
install_command = pip install {opts} {packages}
deps =
    -r{toxinidir}/requirements.txt
    -r{toxinidir}/test-requirements.txt
# commands = stestr run {posargs}
#            stestr slowest

[testenv:pep8]
commands =
    flake8
    doc8 doc/source README.rst

[testenv:venv]
deps =
    -r{toxinidir}/requirements.txt
commands = {posargs}

[testenv:docs]
deps =
    -r{toxinidir}/doc/requirements.txt
    -e .
allowlist_externals =
    sphinx-build
commands =
    sphinx-build -W --keep-going -b html doc/source/ doc/build/html

[flake8]
# The following are ignored on purpose. It's not super worth it to fix them.
# However, if you feel strongly about it, patches will be accepted to fix them
# if they fix ALL of the occurances of one and only one of them.
# H306 Is about alphabetical imports - there's a lot to fix.
# H4 Are about docstrings and there's just a huge pile of pre-existing issues.
# W503 Is supposed to be off by default but in the latest pycodestyle isn't.
#      Also, both openstacksdk and Donald Knuth disagree with the rule. Line
#      breaks should occur before the binary operator for readability.
ignore = H306,H4,W503, E501
show-source = True
exclude=.venv,.git,.tox,dist,doc,*lib/python*,*egg,build

[doc8]
ignore = D001
extensions = .rst, .yaml