5c86db74c8
The dev environment used by some docs developers uses an old version of tox, and does not support the allowlist_externals entry required by tox 4. The version of tox used by some other developers cannot support tox.ini that contains both allowlist_externals and whitelist_externals in the same file. The fix for now is to stay with whitelist_externals and tox<4 This fix mostly reverts and re-works these two commits https://review.opendev.org/c/starlingx/docs/+/869229 https://review.opendev.org/c/starlingx/docs/+/868621 Partial-Bug: #2000399 Signed-off-by: Al Bailey <al.bailey@windriver.com> Change-Id: Ib8a5eea5d27e7b7347bc717d11f9dc5a0be4f396
91 lines
3.2 KiB
INI
91 lines
3.2 KiB
INI
[tox]
|
|
envlist = docs,linters
|
|
minversion = 2.9
|
|
skipsdist = True
|
|
|
|
[testenv]
|
|
basepython = python3
|
|
setenv = VIRTUAL_ENV={envdir}
|
|
OS_STDOUT_CAPTURE=1
|
|
OS_STDERR_CAPTURE=1
|
|
OS_TEST_TIMEOUT=60
|
|
deps = -r{toxinidir}/test-requirements.txt
|
|
|
|
[testenv:docs]
|
|
deps =
|
|
# -c{env:TOX_CONSTRAINTS_FILE:doc/upper-constraints.txt}
|
|
-r{toxinidir}/doc/requirements.txt
|
|
commands =
|
|
git clean -dfx doc/source/fault-mgmt/
|
|
bash ./dirtyCheck.sh
|
|
bash ./get-remote-files.sh -c templates/events.sh -o file -f
|
|
python parser.py -l templates/alarms_template.rst -e tmp/events.yaml -s 100,200,300,400,500,700,800,900 -ts = -type Alarm -outputPath doc/source/fault-mgmt/kubernetes/ -sort Yes -product starlingx -replace "|,OR"
|
|
python parser.py -l templates/logs_template.rst -e tmp/events.yaml -s 100,200,300,400,500,700,800,900 -ts = -type Log -outputPath doc/source/fault-mgmt/kubernetes/ -sort Yes -product starlingx -replace "|,OR"
|
|
python parser.py -l templates/alarms_template.rst -e tmp/events.yaml -s 100,200,300,400,500,700,800,900 -ts = -type Alarm -outputPath doc/source/fault-mgmt/openstack/ -sort Yes -product openstack -replace "|,OR"
|
|
python parser.py -l templates/logs_template.rst -e tmp/events.yaml -s 100,200,300,400,500,700,800,900 -ts = -type Log -outputPath doc/source/fault-mgmt/openstack/ -sort Yes -product openstack -replace "|,OR"
|
|
bash ./normalize-includes.sh
|
|
sphinx-build -a -E -W --keep-going -d doc/build/doctrees -t starlingx -t openstack -b html doc/source doc/build/html {posargs}
|
|
git clean -dfx doc/source/fault-mgmt/
|
|
git restore doc/source/dist_cloud/kubernetes/*
|
|
bash hw-updates.sh
|
|
bash htmlChecks.sh doc/build/html
|
|
|
|
# Note: The dev env for the docs team uses a version of tox that does not yet support allowlist_externals
|
|
whitelist_externals = bash
|
|
htmlChecks.sh
|
|
get-remote-files.sh
|
|
git
|
|
# hw-updates.sh
|
|
|
|
|
|
[testenv:api-ref]
|
|
deps = {[testenv:docs]deps}
|
|
commands =
|
|
rm -rf api-ref/build
|
|
sphinx-build -W -b html -d api-ref/build/doctrees api-ref/source api-ref/build/html
|
|
whitelist_externals = rm
|
|
|
|
[testenv:linters]
|
|
whitelist_externals = bash
|
|
commands =
|
|
bash -c "find {toxinidir} \
|
|
\( -name .tox -prune \) \
|
|
-o -type f -name '*.yaml' \
|
|
-print0 | xargs -0 yamllint -d '\{extends: relaxed, rules: \{line-length: \{max: 260\}\}\}'"
|
|
# -print0 | xargs -0 yamllint"
|
|
|
|
|
|
[testenv:venv]
|
|
commands = {posargs}
|
|
|
|
|
|
[testenv:newfile]
|
|
passenv=PWD
|
|
commands =
|
|
bash -c "echo Running in {env:PWD}"
|
|
bash new-topic.sh {env:PWD} {toxinidir}
|
|
whitelist_externals = new-topic.sh
|
|
bash
|
|
|
|
[testenv:picks]
|
|
commands =
|
|
./pickCompare.sh
|
|
whitelist_externals = pickCompare.sh
|
|
bash
|
|
|
|
|
|
[testenv:linkcheck]
|
|
deps =
|
|
-r{toxinidir}/doc/requirements.txt
|
|
commands =
|
|
sphinx-build -a -E -W --keep-going -d doc/build/doctrees -t starlingx -t openstack -b linkcheck doc/source doc/build/linkcheck {posargs}
|
|
|
|
|
|
[testenv:spellcheck]
|
|
deps =
|
|
-r{toxinidir}/doc/requirements.txt
|
|
sphinxcontrib-spelling==7.3.2
|
|
commands =
|
|
sphinx-build -a -E --keep-going -d doc/build/doctrees -t starlingx -t openstack -t use_spellext -b spelling doc/source doc/build/spelling {posargs}
|
|
|