tox.toml

requires = [ "tox>=4.64.7", "tox-uv>=1.29" ]
env_list = [ "3.15", "type-3.15", "3.14", "3.13", "3.12", "3.11", "3.10", "3.9", "type-3.9", "3.15t", "docs", "fix", "pkg_meta" ]
skip_missing_interpreters = true

[env_run_base]
description = "run the tests with pytest"
default_base_python = [ "3.15" ]
package = "wheel"
wheel_build_env = ".pkg"
dependency_groups = [ "test" ]
pass_env = [ "DIFF_AGAINST", "PYTEST_*" ]
set_env.COVERAGE_FILE = "{work_dir}{/}.coverage.{env_name}"
commands = [
  [ "coverage", "erase" ],
  [
    "coverage",
    "run",
    "-m",
    "pytest",
    { replace = "posargs", default = [
      "--junitxml",
      "{work_dir}{/}junit.{env_name}.xml",
      "tests",
    ], extend = true },
  ],
  [ "coverage", "combine" ],
  [ "coverage", "report" ],
  [ "coverage", "html", "-d", "{env_tmp_dir}{/}htmlcov" ],
]

[env_pkg_base]
default_base_python = [ "3.15" ]

[env."type-3.15"]
description = "run type check on code base (3.15)"
deps = [ "gitpython>=3.2", "packaging>=26.2", "ty==0.0.84" ]
commands = [ [ "ty", "check", "--output-format", "concise", "--error-on-warning", "--python-version", "3.15", "." ] ]

[env."type-3.9"]
description = "run type check on code base (3.9)"
deps = [ "gitpython>=3.2", "packaging>=26.2", "ty==0.0.84" ]
commands = [ [ "ty", "check", "--output-format", "concise", "--error-on-warning", "--python-version", "3.9", "." ] ]

[env.docs]
description = "build documentation"
dependency_groups = [ "docs" ]
commands = [
  [
    "sphinx-build",
    "-d",
    "{env_tmp_dir}{/}doctree",
    "docs",
    "--color",
    "-b",
    "html",
    "-W",
    { replace = "posargs", default = [ "{work_dir}{/}docs_out" ], extend = true },
  ],
]

[env.fix]
description = "run static analysis and style check using flake8"
skip_install = true
deps = [ "pre-commit-uv>=4.2.1" ]
pass_env = [ "HOMEPATH", "PROGRAMDATA" ]
commands = [ [ "pre-commit", "run", "--all-files", "--show-diff-on-failure" ] ]

[env.pkg_meta]
description = "check that the long description is valid"
skip_install = true
dependency_groups = [ "pkg-meta" ]
commands = [
  [ "uv", "build", "--sdist", "--wheel", "--out-dir", "{env_tmp_dir}", "." ],
  [ "twine", "check", "{env_tmp_dir}{/}*" ],
  [ "check-wheel-contents", "--no-config", "{env_tmp_dir}" ],
]

[env.dev]
description = "generate a DEV environment"
package = "editable"
dependency_groups = [ "test" ]
commands = [ [ "uv", "pip", "tree" ], [ "python", "-c", "import sys; print(sys.executable)" ] ]