tox.toml

requires = [
    "tox>=4.23.2",
    "tox-uv>=1.20.2",
]
env_list = [
    "lint",
    "type",
    "type_tests",
    "3.12",
]

[env_run_base]
runner = "uv-venv-lock-runner"
description = "Run tests under {env_name}."
package = "skip"
dependency_groups = ["tests"]
commands = [
    ["pytest", { replace = "posargs", extend = true }],
]

[env.lint]
description = "Run all linters."
dependency_groups = ["lint"]
commands = [
    [
        "pre-commit",
        "run",
        "--all-files",
        "--show-diff-on-failure",
        { replace = "posargs", extend = true },
    ],
]

[env.type]
description = "Type check Python code."
base_python = ["3.12"]
dependency_groups = ["type"]
commands = [
    ["mypy", "hooks"],
]

[env.type_tests]
description = "Type check Python tests."
base_python = ["3.12"]
dependency_groups = ["tests", "type"]
commands = [
    ["mypy", "tests"],
]

[env.docs]
description = "Build the documentation."
base_python = ["3.12"]
dependency_groups = ["docs"]
commands = [
    [
        "mkdocs",
        "build",
        "--clean",
        "--strict",
        { replace = "posargs", extend = true },
    ],
]

[env.autodocs]
description = "Serve the documentation locally."
base_python = ["3.12"]
dependency_groups = ["docs"]
commands = [
    [
        "mkdocs",
        "serve",
        "--strict",
        "--open",
        { replace = "posargs", extend = true },
    ],
]

[env.changelog]
description = "Render news fragments to standard output."
dependency_groups = ["release"]
commands = [
    ["towncrier", "build", "--draft"],
]

[env.docstrings]
description = "Check documentation coverage."
dependency_groups = ["docstrings"]
commands = [
    ["interrogate", "--verbose"],
]