🔥 build: drop Python 3.9, add Python 3.14 support (#53)

* 🔥 build: drop Python 3.9, add Python 3.14 support

Python 3.9 is end-of-life. Bump the minimum supported version to 3.10
and extend support up to Python 3.14 across packaging metadata,
type/lint tooling, and CI.

- requires-python: >=3.9 -> >=3.10
- drop the 3.9 trove classifier, add the 3.14 classifier
- mypy python_version, ruff target-version, pylint py-version -> 3.10
- CI test matrix: ["3.9", "3.13"] -> ["3.10", "3.14"]

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* ♻️ refactor: drop `from __future__ import annotations`

No longer needed now that the minimum supported Python is 3.10. Forward
references in `_core.py` (`Comparator`, `OptionalDependencyEnum`) are
quoted since they are now evaluated at runtime.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* 👷 ci: don't pull the dev group into lint/test runs

The `uv run` steps re-synced the project's default `dev` group (and its
heavy `ipykernel` -> `pyzmq` chain) on top of the selective `Install`
step, which broke on Python 3.14 / Windows + macOS where pyzmq 26.2.0
has no wheel and fails to build from source.

Use `uv run --no-sync` so the steps reuse exactly the environment the
preceding `uv sync --no-default-groups --group ...` created.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: nstarman

.github/workflows/ci.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Install
         run: uv sync --no-default-groups --group nox --group lint --locked
       - name: Lint
-        run: uv run --frozen nox -s lint
+        run: uv run --no-sync nox -s lint
 
   tests:
     name: Check Python ${{ matrix.python-version }} on ${{ matrix.runs-on }}
@@ -40,7 +40,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9", "3.13"]
+        python-version: ["3.10", "3.14"]
         runs-on: [ubuntu-latest, macos-latest, windows-latest]
 
     steps:
@@ -55,7 +55,7 @@ jobs:
 
       - name: Test package
         run: |
-          uv run --frozen nox -s test -- --cov --cov-report=xml --cov-report=term --durations=20
+          uv run --no-sync nox -s test -- --cov --cov-report=xml --cov-report=term --durations=20
 
       - name: Upload coverage report
         uses: codecov/codecov-action@57e3a136b779b570ffcdbf80b3bdc90e7fab3de2 # v6.0.0

.python-version

@@ -1 +1 @@
-3.9
+3.10

pyproject.toml

@@ -14,7 +14,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
-  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Python",
   "Topic :: Scientific/Engineering",
   "Typing :: Typed",
@@ -27,7 +27,7 @@ dynamic = ["version"]
 license.file = "LICENSE"
 name = "optional_dependencies"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 
 [project.urls]
   "Bug Tracker" = "https://github.com/GalacticDynamics/optional_dependencies/issues"
@@ -100,7 +100,7 @@ skip = ["uv.lock"]
     '^conftest\.py$',                   # nox test configuration
   ]
   files = ["src"]
-  python_version = "3.9"
+  python_version = "3.10"
   strict = true
   warn_unreachable = true
   warn_unused_configs = true
@@ -113,7 +113,7 @@ skip = ["uv.lock"]
 
 [tool.ruff]
   src            = ["src"]
-  target-version = "py39"
+  target-version = "py310"
 
   [tool.ruff.lint]
     extend-select = ["ALL"]
@@ -151,6 +151,6 @@ skip = ["uv.lock"]
     "missing-module-docstring",
     "wrong-import-position",
   ]
-  py-version = "3.9"
+  py-version = "3.10"
   reports.output-format = "colorized"
   similarities.ignore-imports = "yes"

src/optional_dependencies/_core.py

@@ -1,14 +1,13 @@
 """Optional dependencies."""
 
-from __future__ import annotations
-
 __all__: list[str] = []
 
 import operator
+from collections.abc import Callable
 from dataclasses import dataclass
 from enum import Enum
 from types import MethodType
-from typing import Callable, Literal, cast
+from typing import Literal, cast
 
 from packaging.utils import canonicalize_name
 from packaging.version import Version
@@ -25,9 +24,9 @@ class Comparator:
 
     def __get__(
         self,
-        instance: OptionalDependencyEnum | None,
-        owner: type[OptionalDependencyEnum] | None,
-    ) -> Comparator | MethodType:
+        instance: "OptionalDependencyEnum | None",
+        owner: "type[OptionalDependencyEnum] | None",
+    ) -> "Comparator | MethodType":
         """Get the descriptor.
 
         Parameters
@@ -49,7 +48,7 @@ def __get__(
         # Bind the descriptor to the instance
         return MethodType(self.__call__, instance)
 
-    def __call__(self, enum: OptionalDependencyEnum, other: object) -> bool:
+    def __call__(self, enum: "OptionalDependencyEnum", other: object) -> bool:
         """Compare two versions.
 
         Returns

src/optional_dependencies/utils.py

@@ -1,7 +1,5 @@
 """Optional dependencies."""
 
-from __future__ import annotations
-
 __all__ = [
     "InstalledState",
     "NOT_INSTALLED",