tox.ini

[base]
name = dir_content_diff
files = {[base]name} tests docs/source/conf.py setup.py

[tox]
envlist =
    check-packaging
    lint
    docs
    min_versions
    py{38,39,310,311}
    coverage

minversion = 3.18

[testenv]
extras =
    pandas
    test
setenv =
    COVERAGE_FILE = {env:COVERAGE_FILE:.coverage-{envname}}
    py38,min_versions: COVERAGE_RCFILE=.coveragerc_py38
deps =
    min_versions: Requirements-Builder
commands =
    min_versions: requirements-builder --level=min --extras=pandas,test -o {envtmpdir}/requirements_min.txt setup.py
    min_versions: pip install -r {envtmpdir}/requirements_min.txt
    min_versions: pip freeze
    coverage run \
        --source={[base]name} \
        --branch \
        -m pytest \
        --basetemp={envtmpdir} \
        --html reports/pytest-{envname}.html \
        --junit-xml=reports/pytest-{envname}.xml \
        --self-contained-html \
        {posargs}
    coverage html -d reports/coverage-{envname}
    coverage xml -o reports/coverage-{envname}.xml
    coverage report --fail-under=100 -m

[testenv:check-packaging]
skip_install = true
deps =
    build
    twine
commands =
    python -m build -o {envtmpdir}/dist
    twine check {envtmpdir}/dist/*

[testenv:min_versions]
basepython = python3.8

[testenv:lint]
basepython = python3.8
deps =
    pre-commit
    pylint
commands =
    pre-commit run --all-files --show-diff-on-failure
    pylint -j {env:PYLINT_NPROCS:1} {[base]files}

[testenv:format]
basepython = python3.8
skip_install = true
deps =
    codespell
    pre-commit
commands =
    codespell -i 3 -x .codespellignorelines -w {[base]files} README.md CHANGELOG.md docs/source
    pre-commit run --all-files

[testenv:docs]
basepython = python3.9
changedir = docs
extras = docs
allowlist_externals =
    make
# set warnings as errors using the -W sphinx option
commands = make html SPHINXOPTS=-W

[gh-actions]
python =
  3.8: py38, lint
  3.9: py39, docs
  3.10: py310, check-packaging
  3.11: py311