blob: 907cc637540d73cc4f54262da6dcc9e59c7112fd [file] [log] [blame]
Rich Bennett22ef0852017-07-19 18:05:55 -04001[tox]
2minversion = 1.6
Rich Bennett3beeced2017-09-18 10:01:25 -04003envlist = docs
Rich Bennett22ef0852017-07-19 18:05:55 -04004skipsdist = true
5
6[testenv:docs]
mrichommeeb7de502019-11-29 11:11:27 +01007basepython = python3
Aric Gardner0fb94b12020-01-28 15:21:34 -05008deps = -r{toxinidir}/docs/requirements-docs.txt
Rich Bennett22ef0852017-07-19 18:05:55 -04009commands =
mrichomme4de8b082019-11-29 15:14:23 +010010 sphinx-build -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
Rich Bennett22ef0852017-07-19 18:05:55 -040011 echo "Generated docs available in {toxinidir}/docs/_build/html"
Rich Bennett169c1342018-11-02 06:47:43 -040012whitelist_externals =
13 echo
14 git
15 sh
Rich Bennett22ef0852017-07-19 18:05:55 -040016
Cédric Ollivier268209c2017-11-10 11:31:53 +010017[testenv:local]
mrichommeeb7de502019-11-29 11:11:27 +010018basepython = python3
Aric Gardner0fb94b12020-01-28 15:21:34 -050019deps = -r{toxinidir}/docs/requirements-docs.txt
Cédric Ollivier268209c2017-11-10 11:31:53 +010020commands =
Hagop Bozawglanian4cc3e882019-09-04 21:17:28 +000021 git submodule update --depth 100 --init
mrichomme4de8b082019-11-29 15:14:23 +010022 sphinx-build -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
Cédric Ollivier268209c2017-11-10 11:31:53 +010023 echo "Generated docs available in {toxinidir}/docs/_build/html"
24whitelist_externals =
25 echo
26 git
27
Rich Bennett9c3af502018-04-26 09:30:57 -040028[testenv:linkcheck]
mrichommeeb7de502019-11-29 11:11:27 +010029basepython = python3
Rich Bennett22ef0852017-07-19 18:05:55 -040030deps = -r{toxinidir}/etc/requirements.txt
mrichomme4de8b082019-11-29 15:14:23 +010031commands = sphinx-build -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck
Rich Bennett9c3af502018-04-26 09:30:57 -040032
33[testenv:spellcheck]
mrichommeeb7de502019-11-29 11:11:27 +010034basepython = python3
Rich Bennett9c3af502018-04-26 09:30:57 -040035deps =
36 -r{toxinidir}/etc/requirements.txt
37 sphinxcontrib-spelling
38commands =
39 sphinx-build -b spelling -Dextensions=sphinxcontrib.spelling -Dspelling_word_list_filename=validwords.txt -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/spellcheck