typehints + formatting

Author: sid-rl

docs/conf.py

@@ -3,9 +3,13 @@
 # For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
+from __future__ import annotations
+
 import os
 import sys
 
+from sphinx.application import Sphinx
+
 # Add the src directory to the path so we can import the package
 sys.path.insert(0, os.path.abspath("../src"))
 
@@ -55,7 +59,7 @@
 autodoc_typehints_description_target = "documented"
 
 
-def _inject_type_submodules(app, docname, source):
+def _inject_type_submodules(_app: Sphinx, docname: str, source: list[str]) -> None:
     """Auto-generate automodule directives for all type submodules.
 
     Replaces the ``.. auto-all-types::`` placeholder in types.rst with
@@ -70,23 +74,19 @@ def _inject_type_submodules(app, docname, source):
 
     import runloop_api_client.types as types_pkg
 
-    directives = []
+    directives: list[str] = []
     for _, modname, ispkg in sorted(
         pkgutil.walk_packages(types_pkg.__path__, types_pkg.__name__ + "."),
         key=lambda x: x[1],
     ):
         if ispkg:
             continue
-        directives.append(
-            f".. automodule:: {modname}\n"
-            f"   :members:\n"
-            f"   :undoc-members:\n"
-        )
+        directives.append(f".. automodule:: {modname}\n   :members:\n   :undoc-members:\n")
     source[0] = source[0].replace(".. auto-all-types::", "\n".join(directives))
 
 
-def setup(app):
-    app.connect("source-read", _inject_type_submodules)
+def setup(app: Sphinx) -> None:
+    app.connect("source-read", _inject_type_submodules)  # pyright: ignore[reportUnknownMemberType]
 
 
 # Intersphinx mapping