From a2bc47a68273146c1199a34d52159f4b84714a1b Mon Sep 17 00:00:00 2001
From: Sam Martin <samjackmartin@gmail.com>
Date: Sat, 14 Aug 2021 18:35:02 +0100
Subject: [PATCH] docutils - added missing stubs for __init__ methods (#5924)

Co-authored-by: Akuli <akuviljanen17@gmail.com>
---
 stubs/docutils/@tests/stubtest_allowlist.txt     |  2 --
 stubs/docutils/METADATA.toml                     |  2 +-
 stubs/docutils/docutils/frontend.pyi             | 12 +++++++++++-
 stubs/docutils/docutils/parsers/rst/__init__.pyi | 13 +++++++++++++
 4 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/stubs/docutils/@tests/stubtest_allowlist.txt b/stubs/docutils/@tests/stubtest_allowlist.txt
index 1896cda62..a6aa9c57e 100644
--- a/stubs/docutils/@tests/stubtest_allowlist.txt
+++ b/stubs/docutils/@tests/stubtest_allowlist.txt
@@ -2,11 +2,9 @@ docutils.TransformSpec.unknown_reference_resolvers
 docutils.frontend.ConfigParser.__getattr__
 docutils.frontend.ConfigParser.read
 docutils.frontend.OptionParser.__getattr__
-docutils.frontend.OptionParser.__init__
 docutils.io.FileOutput.__getattr__
 docutils.io.FileOutput.__init__
 docutils.io.Input.__getattr__
 docutils.io.Input.__init__
 docutils.parsers.rst.Directive.__getattr__
-docutils.parsers.rst.Directive.__init__
 docutils.parsers.rst.nodes
diff --git a/stubs/docutils/METADATA.toml b/stubs/docutils/METADATA.toml
index 5f1541084..b3849f7d0 100644
--- a/stubs/docutils/METADATA.toml
+++ b/stubs/docutils/METADATA.toml
@@ -1 +1 @@
-version = "0.1"
+version = "0.17"
diff --git a/stubs/docutils/docutils/frontend.pyi b/stubs/docutils/docutils/frontend.pyi
index f482a037a..c32dc44ff 100644
--- a/stubs/docutils/docutils/frontend.pyi
+++ b/stubs/docutils/docutils/frontend.pyi
@@ -1,8 +1,10 @@
 import optparse
+from collections.abc import Iterable, Mapping
 from configparser import RawConfigParser
-from typing import Any, ClassVar, Tuple
+from typing import Any, ClassVar, Tuple, Type
 
 from docutils import SettingsSpec
+from docutils.parsers import Parser
 from docutils.utils import DependencyList
 
 __docformat__: str
@@ -60,6 +62,14 @@ class OptionParser(optparse.OptionParser, SettingsSpec):
     default_error_encoding_error_handler: ClassVar[str]
     config_section: ClassVar[str]
     version_template: ClassVar[str]
+    def __init__(
+        self,
+        components: Iterable[Type[Parser]] = ...,
+        defaults: Mapping[str, Any] | None = ...,
+        read_config_files: bool | None = ...,
+        *args,
+        **kwargs,
+    ) -> None: ...
     def __getattr__(self, name: str) -> Any: ...  # incomplete
 
 class ConfigParser(RawConfigParser):
diff --git a/stubs/docutils/docutils/parsers/rst/__init__.pyi b/stubs/docutils/docutils/parsers/rst/__init__.pyi
index d58522203..f605176c4 100644
--- a/stubs/docutils/docutils/parsers/rst/__init__.pyi
+++ b/stubs/docutils/docutils/parsers/rst/__init__.pyi
@@ -2,6 +2,7 @@ from typing import Any, ClassVar, Tuple
 from typing_extensions import Literal
 
 from docutils import parsers
+from docutils.parsers.rst import states
 
 class Parser(parsers.Parser):
     config_section_dependencies: ClassVar[Tuple[str, ...]]
@@ -16,6 +17,18 @@ class DirectiveError(Exception):
     def __init__(self, level: Any, message: str) -> None: ...
 
 class Directive:
+    def __init__(
+        self,
+        name: str,
+        arguments: list[Any],
+        options: dict[str, Any],
+        content: list[str],
+        lineno: int,
+        content_offset: int,
+        block_text: str,
+        state: states.RSTState,
+        state_machine: states.RSTStateMachine,
+    ) -> None: ...
     def __getattr__(self, name: str) -> Any: ...  # incomplete
 
 def convert_directive_function(directive_fn): ...