Support Sphinx 9+

Signed-off-by: Bernát Gábor <[email protected]>

Author: gaborbernat

.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.3"]
   - repo: https://github.com/tox-dev/tox-ini-fmt
     rev: "1.7.0"
     hooks:
@@ -34,7 +34,7 @@ repos:
     hooks:
       - id: prettier
         additional_dependencies:
-          - prettier@3.6.2
+          - prettier@3.7.4
           - "@prettier/[email protected]"
   - 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]
@@ -41,17 +41,17 @@ dynamic = [
   "version",
 ]
 dependencies = [
-  "sphinx>=8.2.3",
+  "sphinx>=9.0.4",
 ]
 optional-dependencies.docs = [
   "furo>=2025.9.25",
 ]
 optional-dependencies.testing = [
   "covdefaults>=2.3",
-  "coverage>=7.10.7",
+  "coverage>=7.13",
   "defusedxml>=0.7.1",       # required by sphinx.testing
-  "diff-cover>=9.7.1",
-  "pytest>=8.4.2",
+  "diff-cover>=9.7.2",
+  "pytest>=9.0.2",
   "pytest-cov>=7",
   "sphobjinv>=2.3.1.3",
   "typing-extensions>=4.15",

src/sphinx_autodoc_typehints/patches.py

@@ -25,12 +25,16 @@ def fix_autodoc_typehints_for_overloaded_methods() -> None:
     Normally, `FunctionDocumenter.format_signature` and `MethodDocumenter.format_signature` call
     `super().format_signature` which ends up going to `Documenter.format_signature`, and this last method emits the
     `autodoc-process-signature` event. However, if there are overloads, `FunctionDocumenter.format_signature` does
-    something else and the event never occurs. Here we remove this alternative code path by brute force.
+    something else and the event never occurs.
+
+    We delete the format_signature methods to force using the parent implementation, which emits the event.
 
     See https://github.com/tox-dev/sphinx-autodoc-typehints/issues/296
     """
     from sphinx.ext.autodoc import FunctionDocumenter, MethodDocumenter  # noqa: PLC0415
 
+    # Delete the format_signature methods that add overloads
+    # This forces everything to use Documenter.format_signature which emits the event
     del FunctionDocumenter.format_signature
     del MethodDocumenter.format_signature
 

tests/roots/test-integration/conf.py

@@ -14,3 +14,5 @@
     "sphinx.ext.napoleon",
     "sphinx_autodoc_typehints",
 ]
+
+autodoc_use_legacy_class_based = True

tests/test_integration.py

@@ -746,7 +746,7 @@ class mod.TestClassAttributeDocs
 
    A class
 
-   code: "CodeType" | "None"
+   code: CodeType | None
 
       An attribute
 """,
@@ -1013,7 +1013,7 @@ class mod.ParamAndAttributeHaveSameName(blah)
        Parameters:
           **blah** ("CodeType") -- Description of parameter blah
 
-       blah: "ModuleType"
+       blah: ModuleType
 
           Description of attribute blah
 

tox.ini

@@ -1,7 +1,7 @@
 [tox]
 requires =
-    tox>=4.30.2
-    tox-uv>=1.28
+    tox>=4.32
+    tox-uv>=1.29
 env_list =
     fix
     3.14
@@ -39,15 +39,15 @@ commands =
 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.1.5
+    pre-commit-uv>=4.2
 commands =
     pre-commit run --all-files --show-diff-on-failure
 
 [testenv:type]
 description = run type check on code base
 deps =
-    mypy==1.18.2
-    types-docutils>=0.22.2.20250924
+    mypy==1.19
+    types-docutils>=0.22.3.20251115
 commands =
     mypy src
     mypy tests
@@ -58,7 +58,7 @@ skip_install = true
 deps =
     check-wheel-contents>=0.6.3
     twine>=6.2
-    uv>=0.8.22
+    uv>=0.9.16
 commands =
     uv build --sdist --wheel --out-dir {env_tmp_dir} .
     twine check {env_tmp_dir}{/}*