chore: upgrade to sphinx 8.2.1 and resolve issues

JohnVillalovos · nejch · commit d0b5ae36bd0b · 2025-03-05T22:26:24.000+01:00
sphinx-doc/sphinx@7ba7628 broke us.
diff --git a/docs/ext/docstrings.py b/docs/ext/docstrings.py
@@ -1,9 +1,11 @@
 import inspect
 import os
+from typing import Sequence
 
 import jinja2
 import sphinx
 import sphinx.ext.napoleon as napoleon
+from sphinx.config import _ConfigRebuild
 from sphinx.ext.napoleon.docstring import GoogleDocstring
 
 
@@ -20,9 +22,11 @@ def setup(app):
     app.connect("autodoc-process-docstring", _process_docstring)
     app.connect("autodoc-skip-member", napoleon._skip_member)
 
-    conf = napoleon.Config._config_values
+    conf: Sequence[tuple[str, bool | None, _ConfigRebuild, set[type]]] = (
+        napoleon.Config._config_values
+    )
 
-    for name, (default, rebuild) in conf.items():
+    for name, default, rebuild, _ in conf:
         app.add_config_value(name, default, rebuild)
     return {"version": sphinx.__display_version__, "parallel_read_safe": True}
 
diff --git a/requirements-docs.txt b/requirements-docs.txt
@@ -2,6 +2,6 @@
 furo==2024.8.6
 jinja2==3.1.5
 myst-parser==4.0.1
-sphinx==8.1.3
+sphinx==8.2.1
 sphinxcontrib-autoprogram==0.1.9
 sphinx-autobuild==2024.10.3
