tox.ini

# spell-checker:ignore linkcheck basepython changedir envdir envlist envname envsitepackagesdir passenv setenv testenv toxinidir toxworkdir usedevelop doctrees envpython posargs
[tox]
minversion = 4.0.0
envlist =
  lint
  pkg
  hook
  docs
  schemas
  py
  py-devel
  eco
isolated_build = true
skip_missing_interpreters = True

[testenv]
description =
  Run the tests under {basepython} and
  devel: ansible devel branch
deps =
  --editable .[test]
  devel: ansible-core @ git+https://github.com/ansible/ansible.git  # GPLv3+
commands =
  # safety measure to assure we do not accidentally run tests with broken dependencies
  {envpython} -m pip check
  coverage run -m pytest {posargs:\
    -n auto \
    -ra \
    --showlocals \
    --doctest-modules \
    --durations=10 \
    -m "not eco" \
    }
passenv =
  CURL_CA_BUNDLE  # https proxies, https://github.com/tox-dev/tox/issues/1437
  FORCE_COLOR
  HOME
  NO_COLOR
  PYTEST_*  # allows developer to define their own preferences
  PYTEST_REQPASS  # needed for CI
  PYTHON*  # PYTHONPYCACHEPREFIX, PYTHONIOENCODING, PYTHONBREAKPOINT,...
  PY_COLORS
  RTD_TOKEN
  REQUESTS_CA_BUNDLE  # https proxies
  SETUPTOOLS_SCM_DEBUG
  SSL_CERT_FILE  # https proxies
  LANG
  LC_*
# recreate = True
setenv =
  # Avoid runtime warning that might affect our devel testing
  devel: ANSIBLE_DEVEL_WARNING = false
  COVERAGE_FILE = {env:COVERAGE_FILE:{toxworkdir}/.coverage.{envname}}
  COVERAGE_PROCESS_START={toxinidir}/pyproject.toml
  PIP_CONSTRAINT = {toxinidir}/.config/requirements.txt
  devel,py38,pkg: PIP_CONSTRAINT = /dev/null
  PIP_DISABLE_PIP_VERSION_CHECK = 1
  PRE_COMMIT_COLOR = always
  FORCE_COLOR = 1
allowlist_externals =
  git
  sh
  tox
  rm
  pwd
# both options needed to workaround https://github.com/tox-dev/tox/issues/2197
usedevelop = false
skip_install = true

[testenv:lint]
description = Run all linters
# pip compile includes python version in output constraints, so we want to
# be sure that version does not change randomly.
basepython = python3.9
deps =
  pre-commit>=2.6.0
  setuptools>=51.1.1
  pytest>=7.2.0  # to updated schemas
skip_install = true
commands =
  {envpython} -m pre_commit run --all-files --show-diff-on-failure {posargs:}
passenv =
  {[testenv]passenv}
  PRE_COMMIT_HOME
setenv =
  {[testenv]setenv}
  # avoid messing pre-commit with out own constraints
  PIP_CONSTRAINT=

[testenv:hook]
description = Validate pre-commit hook definition
deps = pre-commit
commands =
  sh -c "mkdir -p .tox/x && cd .tox/x && git init && python3 -m pre_commit try-repo -v {toxinidir} ansible-lint"
setenv =
  PIP_CONSTRAINT=/dev/null

[testenv:deps]
description = Bump all test dependencies
# we reuse the lint environment
envdir = {toxworkdir}/lint
skip_install = true
basepython = python3.9
deps =
  {[testenv:lint]deps}
setenv =
  # without his upgrade would likely not do anything
  PIP_CONSTRAINT = /dev/null
commands =
  pre-commit run --all-files --show-diff-on-failure --hook-stage manual lock
  pre-commit run --all-files --show-diff-on-failure --hook-stage manual up
  # Update pre-commit hooks
  pre-commit autoupdate
  # Update npm deps
  sh -c "cd test/schemas && npm run deps"
  # We fail if files are modified at the end
  git diff --exit-code

[testenv:docs]
description = Builds docs
deps =
  --editable .[docs,test]
commands =
  # regenerate docs for rules
  sh -c "cd {toxinidir} && ansible-lint -L -f docs"
  sh -c "rm -f {toxinidir}/docs/pkg/*.rst"
  {envpython} -m sphinx \
    -j auto \
    -b linkcheck \
    -a \
    -n \
    -W --keep-going \
    {tty:--color} \
    -d "{envdir}/.doctrees" \
    . \
    "{envdir}/html"

  # Build the html docs with Sphinx:
  {envpython} -m sphinx \
    -j auto \
    -b html \
    --color \
    -a \
    -n \
    -W --keep-going \
    -d "{envdir}/.doctrees" \
    . \
    "{envdir}/html"

  # Print out the output docs dir and a way to serve html:
  - {envpython} -c \
  'import pathlib, webbrowser; docs_dir = pathlib.Path(r"{envdir}") / "html"; index_file = docs_dir / "index.html"; '\
  'print(f"\nTo serve docs, use `python3 -m http.server --directory \{docs_dir\} 0`\n"); webbrowser.open(f"file://\{index_file\}")'

changedir = {toxinidir}/docs

[testenv:redirects]
description = Update documentation redirections for readthedocs
deps =
  readthedocs-cli
commands =
  # This assumes you loaded RTD_TOKEN in your environment
  rtd projects ansible-lint redirects sync -f docs/redirects.yml --wet-run

[testenv:schemas]
description = Rebuild and test JSON Schemas
deps =
  check-jsonschema
skip_install = true
changedir = test/schemas
commands_pre =
  npm install
commands =
  npm test
allowlist_externals =
  npm

[testenv:eco]
description = Perform ecosystem impact (downstream testing) https://github.com/ansible/ansible-lint/discussions/1403
skip_install = true
deps =
  {[testenv]deps}
commands =
  python -m venv .tox/venv
  .tox/venv/bin/pip install -q git+https://github.com/ansible/ansible-lint@main
  pytest -n auto --durations=3 -m eco
allowlist_externals =
  .tox/venv/bin/pip
setenv =
  PYTEST_REQPASS=9

[testenv:pkg]
description =
  Build package, verify metadata, install package and assert behavior when ansible is missing.
deps =
  build >= 0.9.0
  twine >= 4.0.1
skip_install = true
# Ref: https://twitter.com/di_codes/status/1044358639081975813
commands =
  # build wheel and sdist using PEP-517
  {envpython} -c 'import os.path, shutil, sys; \
  dist_dir = os.path.join("{toxinidir}", "dist"); \
  os.path.isdir(dist_dir) or sys.exit(0); \
  print("Removing \{!s\} contents...".format(dist_dir), file=sys.stderr); \
  shutil.rmtree(dist_dir)'
  {envpython} -m build --outdir {toxinidir}/dist/ {toxinidir}
  # Validate metadata using twine
  twine check --strict {toxinidir}/dist/*
  # Install the wheel
  sh -c 'python3 -m pip install "ansible-lint[lock] @ file://$(echo {toxinidir}/dist/*.whl)"'
  # Uninstall it
  python3 -m pip uninstall -y ansible-lint

[testenv:clean]
skip_install = true
deps =
commands =
  find . -type f -name '*.py[co]' -delete -o -type d -name __pycache__
  rm -rf .mypy_cache

[testenv:coverage]
description = Combines and displays coverage results
commands =
  sh -c "coverage combine -q .tox/.coverage.*"
  # needed by codecov github actions:
  coverage xml
  # just for humans running it:
  coverage report
deps =
  coverage[toml]