156 lines
5.1 KiB
INI
156 lines
5.1 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
|
|
mkdir
|
|
mv
|
|
rsync
|
|
|
|
[testenv:venv]
|
|
commands = {posargs}
|
|
|
|
[testenv:checkniceness]
|
|
commands =
|
|
doc8 firstapp
|
|
doc8 api-quick-start
|
|
|
|
[testenv:checkbuild]
|
|
commands =
|
|
# Build and copy RST Guides
|
|
{toxinidir}/tools/build-all-rst.sh
|
|
# Build website index
|
|
{toxinidir}/tools/build-index.sh build
|
|
|
|
[testenv:publishdocs-api]
|
|
# Prepare documents (without www) so that they can get published on
|
|
# developer.openstack.org with just copying publish-docs/api-ref over.
|
|
commands =
|
|
# Build and copy RST Guides
|
|
{toxinidir}/tools/build-firstapp-rst.sh
|
|
# Build and copy API Quick Start
|
|
{toxinidir}/tools/build-api-quick-start.sh
|
|
# Build website index
|
|
{toxinidir}/tools/build-index.sh publish
|
|
|
|
[testenv:checklang]
|
|
# openstack-generate-docbook 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"
|
|
# openstack-generate-docbook 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]
|
|
# openstack-generate-docbook needs xml2po which cannot be installed
|
|
# in the venv. Since it's installed in the system, let's
|
|
# use sitepackages.
|
|
# NOTE(jaegerandi): Remove this as soon as job has been removed.
|
|
sitepackages=True
|
|
# Do nothing for now
|
|
commands = true
|
|
|
|
[testenv:publishlang-api]
|
|
# openstack-generate-docbook needs xml2po which cannot be installed
|
|
# in the venv. Since it's installed in the system, let's
|
|
# use sitepackages.
|
|
# Publish translated documents to developer.openstack.org with just
|
|
# copying publish-docs/api-ref over.
|
|
sitepackages=True
|
|
whitelist_externals =
|
|
doc-tools-check-languages
|
|
mkdir
|
|
mv
|
|
rm
|
|
ls
|
|
commands =
|
|
# Cleanup first - important when this environment runs locally
|
|
# multiple times.
|
|
rm -rf publish-docs
|
|
doc-tools-check-languages doc-tools-check-languages.conf publish all
|
|
# Move directories to proper place, we publish translated
|
|
# quick-start guides at
|
|
# developer.openstack.org/LANG/api-guide/quick-start or
|
|
# developer.openstack.org/draft/LANG/api-guide/quick-start.
|
|
mkdir -p publish-docs/api-ref
|
|
mkdir -p publish-docs/api-ref/de/api-guide
|
|
mkdir -p publish-docs/api-ref/id/api-guide
|
|
mkdir -p publish-docs/api-ref/ja/api-guide
|
|
mkdir -p publish-docs/api-ref/ko_KR/api-guide
|
|
mkdir -p publish-docs/api-ref/tr_TR/api-guide
|
|
mkdir -p publish-docs/api-ref/zh_CN/api-guide
|
|
mv publish-docs/de/api-quick-start/ publish-docs/api-ref/de/api-guide/quick-start
|
|
mv publish-docs/id/api-quick-start/ publish-docs/api-ref/id/api-guide/quick-start
|
|
mv publish-docs/ja/api-quick-start/ publish-docs/api-ref/ja/api-guide/quick-start
|
|
mv publish-docs/ko_KR/api-quick-start/ publish-docs/api-ref/ko_KR/api-guide/quick-start
|
|
mv publish-docs/tr_TR/api-quick-start/ publish-docs/api-ref/tr_TR/api-guide/quick-start
|
|
mv publish-docs/zh_CN/api-quick-start/ publish-docs/api-ref/zh_CN/api-guide/quick-start
|
|
{toxinidir}/tools/mv-firstapp-trans.sh de
|
|
{toxinidir}/tools/mv-firstapp-trans.sh id
|
|
{toxinidir}/tools/mv-firstapp-trans.sh tr_TR
|
|
|
|
[testenv:generatepot-rst]
|
|
# Generate POT files for translation, needs {posargs} like:
|
|
# tox -e generatepot-rst -- firstapp
|
|
commands = {toxinidir}/tools/generatepot-rst.sh api-site 0 {posargs}
|
|
|
|
[testenv:docs]
|
|
commands =
|
|
{toxinidir}/tools/build-all-rst.sh
|
|
|
|
[testenv:firstapp-libcloud]
|
|
commands = sphinx-build -E -W -t libcloud firstapp/source firstapp/build-libcloud/html
|
|
|
|
[testenv:firstapp-jclouds]
|
|
commands = sphinx-build -E -W -t jclouds firstapp/source firstapp/build-jclouds/html
|
|
|
|
[testenv:firstapp-fog]
|
|
commands = sphinx-build -E -W -t fog firstapp/source firstapp/build-fog/html
|
|
|
|
[testenv:firstapp-dotnet]
|
|
commands = sphinx-build -E -W -t dotnet firstapp/source firstapp/build-dotnet/html
|
|
|
|
[testenv:firstapp-pkgcloud]
|
|
commands = sphinx-build -E -W -t pkgcloud firstapp/source firstapp/build-pkgcloud/html
|
|
|
|
[testenv:firstapp-openstacksdk]
|
|
commands = sphinx-build -E -W -t openstacksdk firstapp/source firstapp/build-openstacksdk/html
|
|
|
|
[testenv:firstapp-todos]
|
|
commands = sphinx-build -E -W -t libcloud firstapp/source firstapp/build/html
|
|
|
|
[testenv:firstapp-shade]
|
|
commands = sphinx-build -E -W -t shade firstapp/source firstapp/build-shade/html
|
|
|
|
[testenv:firstapp-gophercloud]
|
|
commands = sphinx-build -E -W -t gophercloud firstapp/source firstapp/build-gophercloud/html
|
|
|
|
[testenv:api-quick-start]
|
|
commands =
|
|
{toxinidir}/tools/build-api-quick-start.sh
|
|
|
|
[doc8]
|
|
# Settings for doc8:
|
|
# Ignore target directories
|
|
ignore-path = firstapp/build*,common/
|
|
# File extensions to use
|
|
extensions = .rst,.txt
|
|
# Ignore lines longer than 79 chars
|
|
ignore = D001
|