From de7404bcb2ca03913bdaaa52ff20641bbdf0daf2 Mon Sep 17 00:00:00 2001
From: Semyon Moroz <donbarbos@proton.me>
Date: Thu, 24 Apr 2025 14:08:21 +0400
Subject: [PATCH] Complete `flake8-docstrings` (#13872)

---
 stubs/flake8-docstrings/METADATA.toml         |  5 +----
 stubs/flake8-docstrings/flake8_docstrings.pyi | 17 ++++++++++-------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/stubs/flake8-docstrings/METADATA.toml b/stubs/flake8-docstrings/METADATA.toml
index 10586ebd1..8d4722b27 100644
--- a/stubs/flake8-docstrings/METADATA.toml
+++ b/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"]
diff --git a/stubs/flake8-docstrings/flake8_docstrings.pyi b/stubs/flake8-docstrings/flake8_docstrings.pyi
index 49d96ed6e..0c9f9344a 100644
--- a/stubs/flake8-docstrings/flake8_docstrings.pyi
+++ b/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]]]: ...