tox.ini

[tox]
minversion = 3.9.0
envlist =
    lint
    docs
    packaging
    py
    py-devel

# do not enable skip missing to avoid CI false positives
skip_missing_interpreters = False
isolated_build = True

[testenv]
usedevelop = True
# do not put * in passenv as it may break builds do to reduced isolation
passenv =
    CI
    CONTAINER_*
    DOCKER_*
    GITHUB_*
    HOME
    PODMAN_*
    PYTEST_*
    SSH_AUTH_SOCK
    TERM
setenv =
    ANSIBLE_CONFIG={toxinidir}/ansible.cfg
    ANSIBLE_CALLABLE_WHITELIST={env:ANSIBLE_CALLABLE_WHITELIST:timer,profile_roles}
    ANSIBLE_CALLABLE_ENABLED={env:ANSIBLE_CALLABLE_WHITELIST:timer,profile_roles}
    ANSIBLE_NOCOWS=1
    ANSIBLE_DISPLAY_FAILED_STDERR=1
    ANSIBLE_VERBOSITY=1
    PYTHONDONTWRITEBYTECODE=1
    PYTHONUNBUFFERED=1
    # Disabled new resolved due to https://github.com/pypa/pip/issues/8713
    # new resolve a must or test extras will not install right
    # PIP_USE_FEATURE=2020-resolver
    MOLECULE_NO_LOG=0
deps =
    !devel: ansible-core>=2.12
    !devel,!dockerfile: molecule[test]
    devel: git+https://github.com/ansible/ansible#egg=ansible-core
    devel: git+https://github.com/ansible-community/molecule.git@main#egg=molecule[test]
    dockerfile: ansible-core>=2.12
    selinux
extras =
    lint
    test
commands =
    # failsafe as pip may install incompatible dependencies
    pip check
    # failsafe for broken installation
    molecule --version
    # failsafe for preventing changes that may break pytest collection
    python -m pytest -p no:cov --collect-only
    python -m pytest {posargs:-l}

allowlist_externals =
    find
    rm
    sh

[testenv:lint]
description = Runs all linting tasks
commands =
    # to run a single linter you can do "pre-commit run flake8"
    python -m pre_commit run {posargs:--all}
deps = pre-commit>=1.18.1
extras =
skip_install = true
usedevelop = false

[testenv:docs]
description = Invoke sphinx-build to build the HTML docs
# doc requires py3 due to use of f'' strings and using only python3 as
# basepython risks using python3.4 which is not supported.
basepython = python3
passenv = *
usedevelop = False
commands =
    python -m sphinx \
      -a -n -W \
      -b html --color \
      -d "{toxinidir}/docs/docstree" \
      docs/ "{toxinidir}/docs/docstree/html"

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

[testenv:docs-livereload]
description = Invoke sphinx-autobuild to build and reload the HTML docs
basepython = {[testenv:docs]basepython}
passenv = {[testenv:docs]passenv}
usedevelop = {[testenv:docs]usedevelop}
commands =
    python -m sphinx_autobuild docs/ "{toxworkdir}/docs/html"
deps =
    sphinx-autobuild>=0.7.1,<1.0
extras =
    docs

[testenv:dockerfile]
description = Tests ability to build ansible enabled container images (
# This relies on system version of Ansible and does not install any
# dependencies. That is by design as it allows us to test compatibility with
# system ansible from Ubuntu, which is known to be very old.
deps =
skip_install = true
usedevelop = false
passenv = {[testenv]passenv}
setenv = {[testenv]setenv}
commands =
    ansible --version
    ansible-galaxy collection install -r requirements.yml
    ansible-playbook -i localhost, src/molecule_docker/playbooks/validate-dockerfile.yml
allowlist_externals =
    ansible
    ansible-galaxy
    ansible-playbook

[testenv:packaging]
description =
    Do packaging/distribution. If tag is not present or PEP440 compliant upload to
    PYPI could fail
# `usedevelop = true` overrides `skip_install` instruction, it's unwanted
usedevelop = false
# don't install molecule itself in this env
skip_install = true
deps =
    build >= 0.7.0
    twine >= 3.2.0  # pyup: ignore
setenv =
commands =
    rm -rfv {toxinidir}/dist/
    python -m build \
      --outdir {toxinidir}/dist/ \
      {toxinidir}
    # metadata validation
    sh -c "python -m twine check --strict {toxinidir}/dist/*"