Drop Python 3.10 support (#310)

Author: hoodmane

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     name: Python ${{ matrix.python-version}}
     steps:

.github/workflows/test_report.yml

@@ -9,7 +9,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     runs-on: ubuntu-latest
     steps:

.pre-commit-config.yaml

@@ -1,5 +1,5 @@
 default_language_version:
-  python: "3.10"
+  python: "3.11"
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: "v6.0.0"

CHANGELOG.md

@@ -1,5 +1,9 @@
 ## Changelog
 
+### Unreleased
+
+- Dropped support for Python 3.10; minimum supported version is now Python 3.11
+
 ### 5.0.3: (March 30th, 2026)
 
 - Test Python 3.14 in CI (#302)

noxfile.py

@@ -7,7 +7,7 @@
 PROJECT_ROOT = Path(__file__).parent
 
 
-@nox.session(python=["3.10", "3.11", "3.12", "3.13", "3.14"])
+@nox.session(python=["3.11", "3.12", "3.13", "3.14"])
 def tests(session: Session) -> None:
     session.install(".[test]")
     venvroot = Path(session.bin).parent

pyproject.toml

@@ -10,7 +10,7 @@ license = {text = "MIT"}
 authors = [
     {name = "Hood Chatham", email = "roberthoodchatham@gmail.com"},
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
     "attrs",
     "cattrs<25.1",
@@ -75,7 +75,7 @@ include = [
 packages = ["sphinx_js"]
 
 [tool.mypy]
-python_version = "3.10"
+python_version = "3.11"
 show_error_codes = true
 warn_unreachable = true
 enable_error_code = ["ignore-without-code", "redundant-expr", "truthy-bool"]
@@ -115,4 +115,4 @@ lint.select = [
   "PGH",   # pygrep-hooks
 ]
 lint.ignore = ["E402", "E501", "E731", "E741", "B904", "B020", "UP031"]
-target-version = "py310"
+target-version = "py311"

sphinx_js/suffix_tree.py

@@ -1,6 +1,5 @@
 from collections.abc import Iterable, Sequence
 from typing import (
-    Any,
     Generic,
     TypedDict,
     TypeVar,
@@ -9,10 +8,9 @@
 T = TypeVar("T")
 
 
-# In Python 3.10: Cannot inherit from TypedDict and Generic.
-class _Tree(TypedDict, total=False):
-    value: Any
-    subtree: dict[str, "_Tree"]
+class _Tree(TypedDict, Generic[T], total=False):
+    value: T
+    subtree: dict[str, "_Tree[T]"]
 
 
 class SuffixTree(Generic[T]):
@@ -24,13 +22,13 @@ class SuffixTree(Generic[T]):
     def __init__(self) -> None:
         #: Internal structure is like... ::
         #:
-        #:     Tree = {value?: Any,
+        #:     Tree = {value?: T,
         #:             subtree?: {segmentFoo: Tree, segmentBar: Tree, ...}}
         #
         #: A Tree can have a value key, a subtree key, or both. Subtree dicts
         #: always have at least 1 key. Every subtree has at least one value,
         #: directly or indirectly. ``self._tree`` itself is a Tree.
-        self._tree: _Tree = {}
+        self._tree: _Tree[T] = {}
 
     def add(self, unambiguous_segments: Sequence[str], value: T) -> None:
         """Add an item to the tree.
@@ -48,9 +46,7 @@ def add(self, unambiguous_segments: Sequence[str], value: T) -> None:
         else:
             tree["value"] = value
 
-    def add_many(
-        self, segments_and_values: Iterable[tuple[Sequence[str], Any]]
-    ) -> None:
+    def add_many(self, segments_and_values: Iterable[tuple[Sequence[str], T]]) -> None:
         """Add a batch of items to the tree all at once, and collect any
         errors.