f76dc6224f
Remove obsolete niceness checking tools from tox settings (doc8 throws an encoding error on one of the old files and openstack-doc-test doesn't seem to exist at all any more). Restore the builds for all guides, but place the output under the mitaka directory. This effectively makes these mitaka-specific versions of the guides. Links to the guides on the /mitaka landing page need to be updated separately on master. Change remote include directives from stable/mitaka to mitaka-eol. Add .zuul.yaml, copied from stable/newton, and the required playbook for running the builds in tox. Add "linters" alias environment in tox.ini since that is now what the test jobs expect. Change-Id: Ifc667dd46d2282c8f843600d10ae988a8a281041 Signed-off-by: Doug Hellmann <doug@doughellmann.com>
140 lines
3.7 KiB
INI
140 lines
3.7 KiB
INI
[tox]
|
|
minversion = 1.6
|
|
envlist = checkniceness,checkbuild
|
|
skipsdist = True
|
|
|
|
[testenv]
|
|
basepython=python2.7
|
|
setenv =
|
|
VIRTUAL_ENV={envdir}
|
|
deps = -r{toxinidir}/test-requirements.txt
|
|
whitelist_externals =
|
|
bash
|
|
cp
|
|
mkdir
|
|
rm
|
|
rsync
|
|
|
|
[testenv:venv]
|
|
commands = {posargs}
|
|
|
|
[testenv:linkcheck]
|
|
commands =
|
|
{toxinidir}/tools/build-all-rst.sh --linkcheck
|
|
|
|
[testenv:checkniceness]
|
|
# Will be replaced by linters
|
|
commands =
|
|
flake8
|
|
bash -c "find doc -type f -regex '.*\.pot?' -print0|xargs -0 -n 1 msgfmt --check-format -o /dev/null"
|
|
|
|
[testenv:linters]
|
|
commands = {[testenv:checkniceness]commands}
|
|
|
|
[testenv:checkbuild]
|
|
commands =
|
|
{toxinidir}/tools/publishdocs.sh build
|
|
|
|
[testenv:docs]
|
|
commands =
|
|
{toxinidir}/tools/build-all-rst.sh
|
|
|
|
[testenv:install-guides]
|
|
commands =
|
|
{toxinidir}/tools/build-install-guides-rst.sh
|
|
|
|
[testenv:install-guide-debian]
|
|
commands =
|
|
{toxinidir}/tools/build-install-guides-rst.sh debian
|
|
|
|
[testenv:install-guide-obs]
|
|
commands =
|
|
{toxinidir}/tools/build-install-guides-rst.sh obs
|
|
|
|
[testenv:install-guide-rdo]
|
|
commands =
|
|
{toxinidir}/tools/build-install-guides-rst.sh rdo
|
|
|
|
[testenv:install-guide-ubuntu]
|
|
commands =
|
|
{toxinidir}/tools/build-install-guides-rst.sh ubuntu
|
|
|
|
[testenv:build]
|
|
commands =
|
|
{toxinidir}/tools/build-rst.sh \
|
|
doc/{posargs} \
|
|
--build build \
|
|
--target {posargs}
|
|
|
|
[testenv:publishdocs]
|
|
# Prepare all documents (except www subdir) so that they can get
|
|
# published on docs.openstack.org with just copying publish-docs/*
|
|
# over.
|
|
commands =
|
|
{toxinidir}/tools/publishdocs.sh publish
|
|
|
|
[testenv:checklang]
|
|
# Generatedocbook needs xml2po which cannot be installed
|
|
# in the venv. Since it's installed in the system, let's
|
|
# use sitepackages.
|
|
sitepackages=True
|
|
whitelist_externals = doc-tools-check-languages
|
|
commands =
|
|
doc-tools-check-languages doc-tools-check-languages.conf test all
|
|
|
|
[testenv:buildlang]
|
|
# Run as "tox -e buildlang -- $LANG"
|
|
# Generatedocbook needs xml2po which cannot be installed
|
|
# in the venv. Since it's installed in the system, let's
|
|
# use sitepackages.
|
|
sitepackages=True
|
|
whitelist_externals = doc-tools-check-languages
|
|
commands =
|
|
doc-tools-check-languages doc-tools-check-languages.conf test {posargs}
|
|
|
|
[testenv:publishlang]
|
|
# Generatedocbook needs xml2po which cannot be installed
|
|
# in the venv. Since it's installed in the system, let's
|
|
# use sitepackages.
|
|
sitepackages=True
|
|
whitelist_externals =
|
|
doc-tools-check-languages
|
|
rmdir
|
|
commands =
|
|
doc-tools-check-languages doc-tools-check-languages.conf publish all
|
|
rmdir publish-docs/id publish-docs/ja
|
|
# Manually move files around
|
|
mv publish-docs/draft publish-docs/mitaka
|
|
|
|
|
|
[testenv:generatepot-rst]
|
|
# Generate POT files for translation, needs {posargs} like:
|
|
# tox -e generatepot-rst -- user-guide
|
|
commands = {toxinidir}/tools/generatepot-rst.sh openstack-manuals 1 {posargs}
|
|
|
|
[testenv:releasenotes]
|
|
commands =
|
|
rm -rf releasenotes/build
|
|
sphinx-build -a -E -W -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html
|
|
|
|
[doc8]
|
|
# Settings for doc8:
|
|
# Ignore target directories
|
|
ignore-path = doc/*/target,doc/*/build*,doc/install-guide/source/swift-controller-include.txt,doc/install-guide-debconf/source/swift-controller-include.txt,doc/networking-guide/source/shared/*.txt
|
|
# File extensions to use
|
|
extensions = .rst,.txt
|
|
# Maximal line length should be 79 but we have some overlong lines.
|
|
# Let's not get far more in.
|
|
max-line-length = 79
|
|
# Disable some doc8 checks:
|
|
# D000: Check RST validity (cannot handle the "linenos" directive)
|
|
ignore = D000
|
|
|
|
[flake8]
|
|
show-source = True
|
|
# H803 skipped on purpose per list discussion.
|
|
# E123, E125 skipped as they are invalid PEP-8.
|
|
ignore = E123,E125,H803
|
|
builtins = _
|
|
exclude=.venv,.git,.tox,dist,*openstack/common*,*lib/python*,*egg,build,doc/common/samples,*/source/conf.py
|