tox.ini

# Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0
# For details: https://github.com/coveragepy/coveragepy/blob/main/NOTICE.txt

[tox]
# When changing this list, be sure to check the [gh] list below.
# PYVERSIONS
envlist = py3{10-15}, py3{14-15}t, pypy3, doc, lint, mypy
labels =
    py = py3{10-15}, py3{14-15}t, pypy3
    qual = lint, mypy
skip_missing_interpreters = {env:COVERAGE_SKIP_MISSING_INTERPRETERS:True}
toxworkdir = {env:TOXWORKDIR:.tox}

[testenv]
download = True
extras =
    toml

# PYVERSIONS
deps =
    -r requirements/pip.pip
    -r requirements/pytest.pip
    py3{10-14}: -r requirements/light-threads.pip

# Windows can't update the pip version with pip running, so use Python
# to install things.
install_command = python -m pip install -U {env:COVERAGE_PIP_ARGS} {opts} {packages}

passenv = *
setenv =
    pypy3{,10,11}: COVERAGE_TEST_CORES=pytrace
    PYTHONWARNDEFAULTENCODING=1
    PYTHONWARNINGS=ignore::EncodingWarning:pip._internal.utils.subprocess,ignore::EncodingWarning:pip._internal.configuration
    # Disable CPython's color output
    PYTHON_COLORS=0

# $set_env.py: COVERAGE_PIP_ARGS - Extra arguments for `pip install`
# `--no-build-isolation` will let tox work with no network.
commands =
    # Create tests/zipmods.zip
    python igor.py zip_mods

    # Build the C extension and test with the CTracer
    python setup.py --quiet build_ext --inplace
    # Installing with -e means with metacov we can measure ourselves without
    # getting all of site-packages measured also.
    python -m pip install {env:COVERAGE_PIP_ARGS} -q -e .
    python igor.py clean_for_core ctrace
    python igor.py test_with_core ctrace {posargs}

    # Test with the PyTracer
    python igor.py clean_for_core pytrace
    python igor.py test_with_core pytrace {posargs}

    # Test with sys.monitoring
    py3{12-16}{,t},anypy: python igor.py clean_for_core sysmon
    py3{12-16}{,t},anypy: python igor.py test_with_core sysmon {posargs}

[testenv:anypy]
# $set_env.py: COVERAGE_ANYPY - The custom Python for "tox -e anypy"
# For running against my own builds of CPython, or any other specific Python.
basepython = {env:COVERAGE_ANYPY}

[testenv:doc]
# One of the PYVERSIONS, that's currently supported by Sphinx. Make sure it
# matches the `python:version:` in the .readthedocs.yml file, and the
# python-version in the `doc` job in the .github/workflows/quality.yml workflow.
basepython = python3.12

# Build the docs so we know if they are successful.  We build twice: once with
# -q to get all warnings, and once with -QW to get a success/fail status
# return.
deps =
    -r doc/requirements.pip

allowlist_externals =
    make

setenv =
    {[testenv]setenv}
    PYTHONWARNDEFAULTENCODING=

commands =
    # If cog fails, it means the docs need to be updated. Run `make prebuild`.
    python -m cogapp -cP --check --check-fail-msg='run `make prebuild`' --verbosity=1 doc/*.rst doc/*/*.rst
    doc8 -q --ignore-path 'doc/_*' doc CHANGES.rst README.rst
    sphinx-lint doc CHANGES.rst README.rst
    sphinx-build -b html -aEnqW doc doc/_build/html
    sphinx-build -b rediraffecheckdiff doc/ doc/_build/html
    rst2html --verbose --strict README.rst doc/_build/README.html
    - sphinx-build -b html -b linkcheck -aEnq doc doc/_build/html
    - sphinx-build -b html -b linkcheck -aEnQW doc doc/_build/html

[testenv:lint]
# Minimum of PYVERSIONS
basepython = python3.10
deps =
    -r requirements/dev.pip

setenv =
    {[testenv]setenv}
    PYTHONWARNDEFAULTENCODING=
    LINTABLE=coverage tests doc ci igor.py setup.py __main__.py

commands =
    # If cog fails, it means the docs need to be updated. Run `make prebuild`.
    python -m cogapp -cP --check --check-fail-msg='run `make prebuild`' --verbosity=1 doc/*.rst doc/*/*.rst
    # If cog fails, it means the workflow files need to be updated. Run `make workflows`.
    python -m cogapp -cP --check --check-fail-msg='run `make workflows`' --verbosity=1 .github/workflows/*.yml
    ruff format --check
    python -m pylint -j 0 --notes= --ignore-paths 'doc/_build/.*' {env:LINTABLE}
    check-manifest --ignore "doc/sample_html/*,a1_coverage.pth"
    actionlint -ignore SC2129
    python -m build -qq
    twine check dist/*

[testenv:mypy]
basepython = python3.10

deps =
    -r requirements/mypy.pip

setenv =
    {[testenv]setenv}
    PYTHONWARNDEFAULTENCODING=
    TYPEABLE=coverage tests setup.py

commands =
    # PYVERSIONS
    mypy --python-version=3.14 --strict {env:TYPEABLE}

[gh]
# https://pypi.org/project/tox-gh/
# PYVERSIONS
python =
    3.10 = py310
    3.11 = py311
    3.12 = py312
    3.13 = py313
    3.14 = py314
    3.14t = py314t
    3.15 = py315
    3.15t = py315t
    3.16 = py316
    3.16t = py316t
    pypy-3 = pypy3
    pypy-3 = pypy3
    pypy-3.11 = pypy3