cleanup

Author: picnixz

.ruff.toml

@@ -518,7 +518,6 @@ exclude = [
     "sphinx/ext/autodoc/directive.py",
     "sphinx/ext/autodoc/importer.py",
     "sphinx/ext/autodoc/type_comment.py",
-    "sphinx/ext/autodoc/mock.py",
     "sphinx/ext/autosummary/__init__.py",
     "sphinx/ext/autosummary/generate.py",
     "sphinx/pycode/ast.py",

pyproject.toml

@@ -258,8 +258,6 @@ module = [
     "sphinx.ext.autodoc",
     "sphinx.ext.autodoc.directive",
     "sphinx.ext.autodoc.importer",
-    "sphinx.ext.autodoc.mock",
-    "sphinx.ext.autodoc.mock",
     "sphinx.ext.autosummary.generate",
     "sphinx.ext.doctest",
     "sphinx.ext.graphviz",

sphinx/ext/autodoc/mock.py

@@ -8,13 +8,14 @@
 from importlib.abc import Loader, MetaPathFinder
 from importlib.machinery import ModuleSpec
 from types import MethodType, ModuleType
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 from sphinx.util import logging
 from sphinx.util.inspect import isboundmethod, safe_getattr
 
 if TYPE_CHECKING:
     from collections.abc import Iterator, Sequence
+    from typing import Any
 
 logger = logging.getLogger(__name__)
 
@@ -32,8 +33,12 @@ def __new__(cls, *args: Any, **kwargs: Any) -> Any:
             superclass = args[1][-1].__class__
             if superclass is cls:
                 # subclassing MockObject
-                return _make_subclass(args[0], superclass.__display_name__,
-                                      superclass=superclass, attributes=args[2])
+                return _make_subclass(
+                    args[0],
+                    superclass.__display_name__,
+                    superclass=superclass,
+                    attributes=args[2],
+                )
 
         return super().__new__(cls)
 
@@ -46,10 +51,10 @@ def __len__(self) -> int:
     def __contains__(self, key: str) -> bool:
         return False
 
-    def __iter__(self) -> Iterator:
+    def __iter__(self) -> Iterator[Any]:
         return iter([])
 
-    def __mro_entries__(self, bases: tuple) -> tuple:
+    def __mro_entries__(self, bases: tuple[Any, ...]) -> tuple[type[Any], ...]:
         return (self.__class__,)
 
     def __getitem__(self, key: Any) -> _MockObject:
@@ -67,12 +72,19 @@ def __repr__(self) -> str:
         return self.__display_name__
 
 
-def _make_subclass(name: str, module: str, superclass: Any = _MockObject,
-                   attributes: Any = None, decorator_args: tuple = ()) -> Any:
-    attrs = {'__module__': module,
-             '__display_name__': module + '.' + name,
-             '__name__': name,
-             '__sphinx_decorator_args__': decorator_args}
+def _make_subclass(
+    name: str,
+    module: str,
+    superclass: Any = _MockObject,
+    attributes: Any = None,
+    decorator_args: tuple[Any, ...] = (),
+) -> Any:
+    attrs = {
+        '__module__': module,
+        '__display_name__': module + '.' + name,
+        '__name__': name,
+        '__sphinx_decorator_args__': decorator_args,
+    }
     attrs.update(attributes or {})
 
     return type(name, (superclass,), attrs)
@@ -121,8 +133,12 @@ def __init__(self, modnames: list[str]) -> None:
         self.loader = MockLoader(self)
         self.mocked_modules: list[str] = []
 
-    def find_spec(self, fullname: str, path: Sequence[bytes | str] | None,
-                  target: ModuleType | None = None) -> ModuleSpec | None:
+    def find_spec(
+        self,
+        fullname: str,
+        path: Sequence[bytes | str] | None,
+        target: ModuleType | None = None,
+    ) -> ModuleSpec | None:
         for modname in self.modnames:
             # check if fullname is (or is a descendant of) one of our targets
             if modname == fullname or fullname.startswith(modname + '.'):