🔧 build(ty): type check against both 3.8 and 3.14

The codebase needs to be validated against both the oldest supported
Python (3.8) and the newest (3.14) because some constructs like
distutils imports are only valid on one version. Split the single
`type` tox env into `type-3.8` and `type-3.14` with explicit
`--python-version` flags.

Use per-file ty overrides instead of globally ignoring
unused-ignore-comment, so only the two files with version-conditional
ignores (distutils imports in _py_info.py, type: ignore on tkinter
fallback in test_py_info_extra.py) are exempted. Suppress ruff B905
(zip-without-explicit-strict) since the `strict` parameter does not
exist in Python 3.8.

Author: gaborbernat

.github/workflows/check.yaml

@@ -24,7 +24,8 @@ jobs:
           - "3.12"
           - "3.11"
           - "3.10"
-          - type
+          - type-3.8
+          - type-3.14
           - dev
           - pkg_meta
     steps:

.pre-commit-config.yaml

@@ -13,7 +13,7 @@ repos:
     rev: v2.4.1
     hooks:
       - id: codespell
-        additional_dependencies: ["tomli>=2.2.1"]
+        additional_dependencies: ["tomli>=2.4"]
   - repo: https://github.com/tox-dev/pyproject-fmt
     rev: "v2.11.1"
     hooks:
@@ -29,7 +29,7 @@ repos:
     hooks:
       - id: prettier
         additional_dependencies:
-          - prettier@3.6.2
+          - prettier@3.8.1
           - "@prettier/plugin-xml@3.4.2"
   - repo: meta
     hooks:

pyproject.toml

@@ -2,7 +2,7 @@
 build-backend = "hatchling.build"
 requires = [
   "hatch-vcs>=0.5",
-  "hatchling>=1.27",
+  "hatchling>=1.28",
 ]
 
 [project]
@@ -40,21 +40,21 @@ dynamic = [
   "version",
 ]
 dependencies = [
-  "filelock>=3.16.1",
-  "platformdirs>=3.9.1,<5",
+  "filelock>=3.24.2",
+  "platformdirs<5,>=4.9.2",
 ]
 optional-dependencies.docs = [
-  "furo>=2024.8.6",
-  "sphinx>=8.1.3",
-  "sphinx-autodoc-typehints>=2.5",
-  "sphinxcontrib-mermaid>=1",
+  "furo>=2025.12.19",
+  "sphinx>=9.1",
+  "sphinx-autodoc-typehints>=3.6.3",
+  "sphinxcontrib-mermaid>=2",
 ]
 optional-dependencies.testing = [
   "covdefaults>=2.3",
-  "coverage>=7.10.7",
-  "pytest>=8.4.2",
+  "coverage>=7.13.4",
+  "pytest>=9.0.2",
   "pytest-mock>=3.15.1",
-  "setuptools>=68",
+  "setuptools>=82",
 ]
 urls.Changelog = "https://github.com/tox-dev/py-discovery/releases"
 urls.Documentation = "https://py-discovery.readthedocs.io"
@@ -84,6 +84,7 @@ lint.ignore = [
   "ANN401",  # Dynamically typed expressions (typing.Any)
   "ARG001",  # Unused function argument
   "ARG005",  # Unused lambda argument
+  "B905",    # zip-without-explicit-strict (conflicts with ty on 3.8)
   "C901",    # Too complex
   "COM812",  # Conflict with formatter
   "CPY",     # No copyright statements
@@ -170,5 +171,8 @@ paths.source = [
 ]
 
 [tool.ty]
-environment.python-version = "3.14"
 src.exclude = [ "tests/windows/winreg_mock_values.py" ]
+
+[[tool.ty.overrides]]
+include = [ "src/py_discovery/_py_info.py", "tests/test_py_info_extra.py" ]
+rules.unused-ignore-comment = "ignore"

src/py_discovery/_py_info.py

@@ -506,7 +506,7 @@ def satisfies(self, spec: PythonSpec, impl_must_match: bool) -> bool:
             if not spec.version_specifier.contains(release):
                 return False
 
-        for our, req in zip(self.version_info[0:3], (spec.major, spec.minor, spec.micro), strict=False):
+        for our, req in zip(self.version_info[0:3], (spec.major, spec.minor, spec.micro)):
             if req is not None and our is not None and our != req:
                 return False
         return True

src/py_discovery/_py_spec.py

@@ -209,7 +209,7 @@ def satisfies(self, spec: PythonSpec) -> bool:
         if spec.version_specifier is not None and not self._check_version_specifier(spec):
             return False
 
-        for our, req in zip((self.major, self.minor, self.micro), (spec.major, spec.minor, spec.micro), strict=False):
+        for our, req in zip((self.major, self.minor, self.micro), (spec.major, spec.minor, spec.micro)):
             if req is not None and our is not None and our != req:
                 return False
         return True

tests/py_info/test_py_info.py

@@ -437,7 +437,7 @@ def test_select_most_likely_prefers_machine_match(
     target = copy.deepcopy(CURRENT)
     target.sysconfig_platform = target_platform
     discovered = [copy.deepcopy(CURRENT) for _ in discovered_platforms]
-    for d, plat in zip(discovered, discovered_platforms, strict=False):
+    for d, plat in zip(discovered, discovered_platforms):
         d.sysconfig_platform = plat
     result = PythonInfo._select_most_likely(discovered, target)
     assert result.sysconfig_platform == discovered_platforms[expected_idx]

tests/test_py_info_extra.py

@@ -54,7 +54,7 @@ def test_get_tcl_tk_libs_returns_tuple() -> None:
 @pytest.mark.skipif(tk is None, reason="tkinter not available")
 def test_get_tcl_tk_libs_tcl_error(mocker) -> None:  # pragma: no cover
     mock_tcl = MagicMock()
-    mock_tcl.eval.side_effect = tk.TclError("fail")  # type: ignore[union-attr]
+    mock_tcl.eval.side_effect = tk.TclError("fail")
     mocker.patch("tkinter.Tcl", return_value=mock_tcl)
 
     tcl, _tk = PythonInfo._get_tcl_tk_libs()

tox.toml

@@ -1,5 +1,5 @@
-requires = ["tox>=4.30.3", "tox-uv>=1.28"]
-env_list = ["fix", "3.14", "3.13", "3.12", "3.11", "3.10", "type", "docs", "pkg_meta"]
+requires = ["tox>=4.38", "tox-uv>=1.29"]
+env_list = ["fix", "3.14", "3.13", "3.12", "3.11", "3.10", "type-3.8", "type-3.14", "docs", "pkg_meta"]
 skip_missing_interpreters = true
 
 [env_run_base]
@@ -30,14 +30,19 @@ commands = [
 [env.fix]
 description = "run static analysis and style check using flake8"
 skip_install = true
-deps = ["pre-commit-uv>=4.1.5"]
+deps = ["pre-commit-uv>=4.2.1"]
 pass_env = ["HOMEPATH", "PROGRAMDATA"]
 commands = [["pre-commit", "run", "--all-files", "--show-diff-on-failure"]]
 
-[env.type]
-description = "run type check on code base"
+[env."type-3.8"]
+description = "run type check on code base (3.8)"
 deps = ["ty==0.0.17"]
-commands = [["ty", "check", "--output-format", "concise", "--error-on-warning", "."]]
+commands = [["ty", "check", "--output-format", "concise", "--error-on-warning", "--python-version", "3.8", "."]]
+
+[env."type-3.14"]
+description = "run type check on code base (3.14)"
+deps = ["ty==0.0.17"]
+commands = [["ty", "check", "--output-format", "concise", "--error-on-warning", "--python-version", "3.14", "."]]
 
 [env.docs]
 description = "build documentation"
@@ -59,7 +64,7 @@ commands = [
 [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.8.22"]
+deps = ["check-wheel-contents>=0.6.3", "twine>=6.2", "uv>=0.10.4"]
 commands = [
   ["uv", "build", "--sdist", "--wheel", "--out-dir", "{env_tmp_dir}", "."],
   ["twine", "check", "{env_tmp_dir}{/}*"],