Complete flake8-docstrings (#13872)

Author: donbarbos

stubs/flake8-docstrings/METADATA.toml

@@ -1,6 +1,3 @@
 version = "1.7.*"
 upstream_repository = "https://github.com/pycqa/flake8-docstrings"
-partial_stub = true
-
-[tool.stubtest]
-ignore_missing_stub = true
+requires = ["types-flake8"]

stubs/flake8-docstrings/flake8_docstrings.pyi

@@ -1,21 +1,24 @@
 import argparse
 import ast
-from _typeshed import Incomplete
 from collections.abc import Generator, Iterable
-from typing import Any, ClassVar
+from typing import Any, ClassVar, Final, Literal
+from typing_extensions import Self
+
+from flake8.options.manager import OptionManager
+
+__version__: Final[str]
+__all__ = ("pep257Checker",)
 
 class pep257Checker:
     name: ClassVar[str]
     version: ClassVar[str]
     tree: ast.AST
     filename: str
-    checker: Any
+    checker: Any  # actual type: pep257.ConventionChecker
     source: str
     def __init__(self, tree: ast.AST, filename: str, lines: Iterable[str]) -> None: ...
     @classmethod
-    def add_options(cls, parser: Any) -> None: ...
+    def add_options(cls, parser: OptionManager) -> None: ...
     @classmethod
     def parse_options(cls, options: argparse.Namespace) -> None: ...
-    def run(self) -> Generator[tuple[int, int, str, type[Any]], None, None]: ...
-
-def __getattr__(name: str) -> Incomplete: ...
+    def run(self) -> Generator[tuple[int, Literal[0], str, type[Self]]]: ...