tony · Nov 8, 2026 · Nov 8, 2026 · Nov 8, 2026
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -22,7 +22,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
+        python-version: ["3.11", "3.12", "3.13", "3.14", "3.15"]
     steps:
       - uses: actions/checkout@v7
 

diff --git a/.tool-versions b/.tool-versions
@@ -1,3 +1,3 @@
 just 1.59.0
 uv 0.13.7
-python 3.15 3.14 3.13 3.12 3.11 3.10
+python 3.15 3.14 3.13 3.12 3.11
diff --git a/CHANGES b/CHANGES
@@ -18,6 +18,17 @@ $ uv add gp-sphinx --prerelease allow
 
 <!-- To maintainers and contributors: Please add notes for the forthcoming version below -->
 
+### Breaking changes
+
+#### Python 3.11 is now required
+
+Python 3.10 reached end-of-life in October 2026. Every package in the
+workspace now requires Python 3.11 or newer. (#84)
+
+```toml
+requires-python = ">=3.11"
+```
+
 ### Fixes
 
 #### `sphinx-vite-builder`: Load the Hatchling hook with newer Hatchling

diff --git a/README.md b/README.md
@@ -12,7 +12,7 @@ cross-referenced API documentation.
 
 ## Requirements
 
-- Python 3.10+
+- Python 3.11+
 - Sphinx 8.1+
 
 ## Install

diff --git a/docs/_ext/package_reference.py b/docs/_ext/package_reference.py
@@ -77,10 +77,7 @@
 if t.TYPE_CHECKING:
     from docutils import nodes
 
-if sys.version_info >= (3, 11):
-    import tomllib
-else:
-    import tomli as tomllib  # type: ignore[import-not-found, unused-ignore]
+import tomllib
 
 logger = logging.getLogger(__name__)
 

diff --git a/docs/conftest.py b/docs/conftest.py
diff --git a/docs/packages/sphinx-autodoc-typehints-gp/how-to.md b/docs/packages/sphinx-autodoc-typehints-gp/how-to.md
@@ -90,7 +90,7 @@ Write the description on the class that *declares* the name. A subclass
 that inherits the field inherits the description with it, so a base class
 documenting forty fields does not oblige each subclass to repeat them.
 
-On Python 3.10 and 3.11, use `typing_extensions.TypedDict` to inherit
+On Python 3.11, use `typing_extensions.TypedDict` to inherit
 key descriptions. The standard-library `TypedDict` does not retain the
 base-class metadata needed to locate those descriptions until Python 3.12.
 

diff --git a/packages/gp-furo-theme/pyproject.toml b/packages/gp-furo-theme/pyproject.toml
@@ -2,7 +2,7 @@
 name = "gp-furo-theme"
 version = "0.1.0a39"
 description = "Tailwind v4 port of the Furo Sphinx theme for git-pull project documentation"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Theme",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/gp-sphinx/pyproject.toml b/packages/gp-sphinx/pyproject.toml
@@ -2,7 +2,7 @@
 name = "gp-sphinx"
 version = "0.1.0a39"
 description = "Shared Sphinx documentation platform for git-pull projects"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -13,7 +13,6 @@ classifiers = [
   "Framework :: Sphinx",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/gp-sphinx/src/gp_sphinx/config.py b/packages/gp-sphinx/src/gp_sphinx/config.py
@@ -170,7 +170,7 @@ def linkcode_resolve(domain: str, info: dict[str, str]) -> str | None:
         for part in fullname.split("."):
             try:
                 obj = getattr(obj, part)
-            except Exception:  # noqa: PERF203
+            except Exception:
                 return None
 
         try:
@@ -277,7 +277,7 @@ def linkcode_resolve(domain: str, info: dict[str, str]) -> str | None:
         for part in fullname.split("."):
             try:
                 obj = getattr(obj, part)
-            except Exception:  # noqa: PERF203
+            except Exception:
                 return None
 
         try:

diff --git a/packages/sphinx-autodoc-api-style/pyproject.toml b/packages/sphinx-autodoc-api-style/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-autodoc-api-style"
 version = "0.1.0a39"
 description = "Sphinx extension for enhanced autodoc API entry styling (badges and cards)"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-autodoc-argparse/pyproject.toml b/packages/sphinx-autodoc-argparse/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-autodoc-argparse"
 version = "0.1.0a39"
 description = "Modern Sphinx extension for documenting argparse-based CLI tools"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -15,7 +15,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-autodoc-docutils/pyproject.toml b/packages/sphinx-autodoc-docutils/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-autodoc-docutils"
 version = "0.1.0a39"
 description = "Sphinx extension for documenting docutils directives and roles as first-class reference entries"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-autodoc-fastmcp/README.md b/packages/sphinx-autodoc-fastmcp/README.md
@@ -46,7 +46,7 @@ See the package docstrings and `sphinx_autodoc_fastmcp.setup()` for defaults.
 
 ## Dependencies
 
-- Python 3.10+
+- Python 3.11+
 - Sphinx 8.1+
 - `sphinx-ux-badges`, `sphinx-ux-autodoc-layout`, and `sphinx-autodoc-typehints-gp`
   are declared dependencies and installed automatically with this package.

diff --git a/packages/sphinx-autodoc-fastmcp/pyproject.toml b/packages/sphinx-autodoc-fastmcp/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-autodoc-fastmcp"
 version = "0.1.0a39"
 description = "Sphinx extension for documenting FastMCP tools (cards, badges, cross-refs)"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-autodoc-pytest-fixtures/pyproject.toml b/packages/sphinx-autodoc-pytest-fixtures/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-autodoc-pytest-fixtures"
 version = "0.1.0a39"
 description = "Sphinx extension for documenting pytest fixtures as first-class objects"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -15,7 +15,6 @@ classifiers = [
   "Framework :: Pytest",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-autodoc-sphinx/pyproject.toml b/packages/sphinx-autodoc-sphinx/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-autodoc-sphinx"
 version = "0.1.0a39"
 description = "Sphinx extension for documenting extension config values as first-class conf.py reference entries"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-autodoc-typehints-gp/pyproject.toml b/packages/sphinx-autodoc-typehints-gp/pyproject.toml
@@ -7,7 +7,7 @@ name = "sphinx-autodoc-typehints-gp"
 version = "0.1.0a39"
 description = "Cross-referenced type annotations for Sphinx autodoc"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = "MIT"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
@@ -19,7 +19,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-autodoc-typehints-gp/src/sphinx_autodoc_typehints_gp/extension.py b/packages/sphinx-autodoc-typehints-gp/src/sphinx_autodoc_typehints_gp/extension.py
@@ -47,8 +47,8 @@ def _autodoc_annotations(env: BuildEnvironment) -> dict[str, dict[str, str]]:
     """Return autodoc's per-document annotation store.
 
     Sphinx 8.2 moved the store from ``env.temp_data["annotations"]`` to
-    ``env.current_document.autodoc_annotations``; Sphinx 8.1, the newest
-    release installable on Python 3.10, has ``temp_data`` only.
+    ``env.current_document.autodoc_annotations``; Sphinx 8.1 has
+    ``temp_data`` only.
 
     Parameters
     ----------

diff --git a/packages/sphinx-fonts/pyproject.toml b/packages/sphinx-fonts/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-fonts"
 version = "0.1.0a39"
 description = "Sphinx extension for self-hosted fonts via Fontsource CDN"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-gp-highlighting/pyproject.toml b/packages/sphinx-gp-highlighting/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-gp-highlighting"
 version = "0.1.0a39"
 description = "Reusable Pygments lexers and inline highlighting for Sphinx"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-gp-llms/pyproject.toml b/packages/sphinx-gp-llms/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-gp-llms"
 version = "0.1.0a39"
 description = "LLM-friendly documentation outputs for Sphinx — llms.txt, llms-full.txt, docs.json, per-page Markdown"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-gp-mermaid/pyproject.toml b/packages/sphinx-gp-mermaid/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-gp-mermaid"
 version = "0.1.0a39"
 description = "Build-time Mermaid diagrams for Sphinx — dual light/dark inline SVG rendered via mermaid-cli"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-gp-opengraph/pyproject.toml b/packages/sphinx-gp-opengraph/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-gp-opengraph"
 version = "0.1.0a39"
 description = "OpenGraph and Twitter meta-tag emission for Sphinx — matplotlib-free"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-gp-sitemap/pyproject.toml b/packages/sphinx-gp-sitemap/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-gp-sitemap"
 version = "0.1.0a39"
 description = "Sitemap generator for Sphinx — Sphinx 8.1+ idioms, parallel-build safe"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Extension",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",

diff --git a/packages/sphinx-gp-sitemap/src/sphinx_gp_sitemap/__init__.py b/packages/sphinx-gp-sitemap/src/sphinx_gp_sitemap/__init__.py
@@ -282,7 +282,7 @@ def _write_sitemap(app: Sphinx, exception: BaseException | None) -> None:
             timestamp, _show_sourcelink = entry
             if timestamp:
                 last_updated = dt.datetime.fromtimestamp(
-                    int(timestamp), dt.timezone.utc
+                    int(timestamp), dt.UTC
                 ).strftime("%Y-%m-%dT%H:%M:%SZ")
 
         links.append((sitemap_link, last_updated))

diff --git a/packages/sphinx-gp-theme/pyproject.toml b/packages/sphinx-gp-theme/pyproject.toml
@@ -2,7 +2,7 @@
 name = "sphinx-gp-theme"
 version = "0.1.0a39"
 description = "Furo child theme for git-pull project documentation"
-requires-python = ">=3.10,<4.0"
+requires-python = ">=3.11,<4.0"
 authors = [
   {name = "Tony Narlock", email = "tony@git-pull.com"}
 ]
@@ -14,7 +14,6 @@ classifiers = [
   "Framework :: Sphinx :: Theme",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",