🔧 chore(tox): migrate tox.ini to tox.toml

The tox ecosystem has moved to native TOML configuration. Switch from
the legacy INI format and update the pre-commit hook from tox-ini-fmt
to tox-toml-fmt v1.7.0.

Author: gaborbernat

.pre-commit-config.yaml

@@ -14,11 +14,10 @@ repos:
     hooks:
       - id: codespell
         additional_dependencies: ["tomli>=2.3"]
-  - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: "1.7.1"
+  - repo: https://github.com/tox-dev/tox-toml-fmt
+    rev: "v1.7.0"
     hooks:
-      - id: tox-ini-fmt
-        args: ["-p", "fix"]
+      - id: tox-toml-fmt
   - repo: https://github.com/tox-dev/pyproject-fmt
     rev: "v2.16.0"
     hooks:

tox.ini

@@ -0,0 +1,66 @@
+requires = [ "tox>=4.32", "tox-uv>=1.29" ]
+env_list = [ "3.14", "3.13", "3.12", "3.11", "3.14t", "fix", "pkg_meta", "type" ]
+skip_missing_interpreters = true
+
+[env_run_base]
+description = "run the unit tests with pytest under {env_name}"
+package = "wheel"
+wheel_build_env = ".pkg"
+extras = [ "testing" ]
+pass_env = [ "PYTEST_*" ]
+set_env.COVERAGE_FILE = { replace = "env", name = "COVERAGE_FILE", default = "{work_dir}{/}.coverage.{env_name}" }
+commands = [
+  [
+    "python",
+    "-m",
+    "pytest",
+    { replace = "tty", default = "", value = "--color=yes" },
+    { replace = "posargs", extend = true, default = [
+      "--cov",
+      "{env_site_packages_dir}{/}sphinx_argparse_cli",
+      "--cov",
+      "{tox_root}{/}tests",
+      "--cov-config=pyproject.toml",
+      "--no-cov-on-fail",
+      "--cov-report",
+      "term-missing:skip-covered",
+      "--cov-context=test",
+      "--cov-report",
+      "html:{env_tmp_dir}{/}htmlcov",
+      "--cov-report",
+      "xml:{work_dir}{/}coverage.{env_name}.xml",
+      "--junitxml",
+      "{work_dir}{/}junit.{env_name}.xml",
+      "tests",
+    ] },
+  ],
+]
+
+[env.fix]
+description = "format the code base to adhere to our styles, and complain about what we cannot do automatically"
+skip_install = true
+deps = [ "pre-commit-uv>=4.2" ]
+commands = [ [ "pre-commit", "run", "--all-files", "--show-diff-on-failure" ] ]
+
+[env.pkg_meta]
+description = "check that the long description is valid"
+skip_install = true
+deps = [ "check-wheel-contents>=0.6.3", "twine>=6.2", "uv>=0.9.16" ]
+commands = [
+  [ "uv", "build", "--sdist", "--wheel", "--out-dir", "{env_tmp_dir}", "." ],
+  [ "twine", "check", "{env_tmp_dir}{/}*" ],
+  [ "check-wheel-contents", "--no-config", "{env_tmp_dir}" ],
+]
+
+[env.type]
+description = "run type check on code base"
+deps = [ "mypy==1.19", "types-docutils>=0.22.3.20251115" ]
+commands = [ [ "mypy", "src", "tests", { replace = "posargs", extend = true } ] ]
+
+[env.dev]
+description = "generate a DEV environment"
+package = "editable"
+commands = [
+  [ "uv", "pip", "tree" ],
+  [ "python", "-c", "import sys; print(sys.executable)" ],
+]