From 3661f4b11b9fdf834021d59fafce3c0d69cde4e0 Mon Sep 17 00:00:00 2001 From: Martin Fischer Date: Sat, 19 Feb 2022 05:04:19 +0100 Subject: [PATCH 1/5] docutils: Add empty stubs for docutils.writers submodules --- stubs/docutils/docutils/writers/docutils_xml.pyi | 3 +++ stubs/docutils/docutils/writers/html4css1.pyi | 3 +++ stubs/docutils/docutils/writers/html5_polyglot.pyi | 3 +++ stubs/docutils/docutils/writers/latex2e.pyi | 3 +++ stubs/docutils/docutils/writers/manpage.pyi | 3 +++ stubs/docutils/docutils/writers/null.pyi | 3 +++ stubs/docutils/docutils/writers/odf_odt.pyi | 3 +++ stubs/docutils/docutils/writers/pep_html.pyi | 3 +++ stubs/docutils/docutils/writers/pseudoxml.pyi | 3 +++ stubs/docutils/docutils/writers/s5_html.pyi | 3 +++ stubs/docutils/docutils/writers/xetex.pyi | 3 +++ 11 files changed, 33 insertions(+) create mode 100644 stubs/docutils/docutils/writers/docutils_xml.pyi create mode 100644 stubs/docutils/docutils/writers/html4css1.pyi create mode 100644 stubs/docutils/docutils/writers/html5_polyglot.pyi create mode 100644 stubs/docutils/docutils/writers/latex2e.pyi create mode 100644 stubs/docutils/docutils/writers/manpage.pyi create mode 100644 stubs/docutils/docutils/writers/null.pyi create mode 100644 stubs/docutils/docutils/writers/odf_odt.pyi create mode 100644 stubs/docutils/docutils/writers/pep_html.pyi create mode 100644 stubs/docutils/docutils/writers/pseudoxml.pyi create mode 100644 stubs/docutils/docutils/writers/s5_html.pyi create mode 100644 stubs/docutils/docutils/writers/xetex.pyi diff --git a/stubs/docutils/docutils/writers/docutils_xml.pyi b/stubs/docutils/docutils/writers/docutils_xml.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/docutils_xml.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/html4css1.pyi b/stubs/docutils/docutils/writers/html4css1.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/html4css1.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/html5_polyglot.pyi b/stubs/docutils/docutils/writers/html5_polyglot.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/html5_polyglot.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/latex2e.pyi b/stubs/docutils/docutils/writers/latex2e.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/latex2e.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/manpage.pyi b/stubs/docutils/docutils/writers/manpage.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/manpage.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/null.pyi b/stubs/docutils/docutils/writers/null.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/null.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/odf_odt.pyi b/stubs/docutils/docutils/writers/odf_odt.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/odf_odt.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/pep_html.pyi b/stubs/docutils/docutils/writers/pep_html.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/pep_html.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/pseudoxml.pyi b/stubs/docutils/docutils/writers/pseudoxml.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/pseudoxml.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/s5_html.pyi b/stubs/docutils/docutils/writers/s5_html.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/s5_html.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/writers/xetex.pyi b/stubs/docutils/docutils/writers/xetex.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/writers/xetex.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete From 40174eef047c24fc3354b92679f72253362e65d3 Mon Sep 17 00:00:00 2001 From: Martin Fischer Date: Sat, 19 Feb 2022 05:06:44 +0100 Subject: [PATCH 2/5] docutils: Add empty stubs for docutils.parsers.rst.directives --- stubs/docutils/docutils/parsers/rst/directives/__init__.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/admonitions.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/body.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/html.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/images.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/misc.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/parts.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/references.pyi | 3 +++ stubs/docutils/docutils/parsers/rst/directives/tables.pyi | 3 +++ 9 files changed, 27 insertions(+) create mode 100644 stubs/docutils/docutils/parsers/rst/directives/__init__.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/admonitions.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/body.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/html.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/images.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/misc.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/parts.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/references.pyi create mode 100644 stubs/docutils/docutils/parsers/rst/directives/tables.pyi diff --git a/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi b/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/admonitions.pyi b/stubs/docutils/docutils/parsers/rst/directives/admonitions.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/admonitions.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/body.pyi b/stubs/docutils/docutils/parsers/rst/directives/body.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/body.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/html.pyi b/stubs/docutils/docutils/parsers/rst/directives/html.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/html.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/images.pyi b/stubs/docutils/docutils/parsers/rst/directives/images.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/images.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/misc.pyi b/stubs/docutils/docutils/parsers/rst/directives/misc.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/misc.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/parts.pyi b/stubs/docutils/docutils/parsers/rst/directives/parts.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/parts.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/references.pyi b/stubs/docutils/docutils/parsers/rst/directives/references.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/references.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/directives/tables.pyi b/stubs/docutils/docutils/parsers/rst/directives/tables.pyi new file mode 100644 index 000000000000..964e6fa3f426 --- /dev/null +++ b/stubs/docutils/docutils/parsers/rst/directives/tables.pyi @@ -0,0 +1,3 @@ +from typing import Any + +def __getattr__(name: str) -> Any: ... # incomplete From 6ec9452560fa1d8a34e48d51703106456abe0423 Mon Sep 17 00:00:00 2001 From: Martin Fischer Date: Sat, 19 Feb 2022 05:10:06 +0100 Subject: [PATCH 3/5] docutils: Remove non-existent docutils.parsers.rst.nodes --- stubs/docutils/@tests/stubtest_allowlist.txt | 1 - stubs/docutils/docutils/parsers/rst/nodes.pyi | 3 --- 2 files changed, 4 deletions(-) delete mode 100644 stubs/docutils/docutils/parsers/rst/nodes.pyi diff --git a/stubs/docutils/@tests/stubtest_allowlist.txt b/stubs/docutils/@tests/stubtest_allowlist.txt index a6aa9c57efa9..a25a445905f6 100644 --- a/stubs/docutils/@tests/stubtest_allowlist.txt +++ b/stubs/docutils/@tests/stubtest_allowlist.txt @@ -7,4 +7,3 @@ docutils.io.FileOutput.__init__ docutils.io.Input.__getattr__ docutils.io.Input.__init__ docutils.parsers.rst.Directive.__getattr__ -docutils.parsers.rst.nodes diff --git a/stubs/docutils/docutils/parsers/rst/nodes.pyi b/stubs/docutils/docutils/parsers/rst/nodes.pyi deleted file mode 100644 index 964e6fa3f426..000000000000 --- a/stubs/docutils/docutils/parsers/rst/nodes.pyi +++ /dev/null @@ -1,3 +0,0 @@ -from typing import Any - -def __getattr__(name: str) -> Any: ... # incomplete From 4f35202d48a19449f70d2d971a65a286deb4e99e Mon Sep 17 00:00:00 2001 From: Martin Fischer Date: Sat, 19 Feb 2022 05:12:25 +0100 Subject: [PATCH 4/5] docutils: Improve incomplete stubs --- stubs/docutils/@tests/stubtest_allowlist.txt | 9 +++++++ .../docutils/docutils/languages/__init__.pyi | 13 +++++++++- stubs/docutils/docutils/nodes.pyi | 20 ++++++++++++++++ stubs/docutils/docutils/parsers/__init__.pyi | 5 ++-- .../parsers/rst/directives/__init__.pyi | 9 +++++++ stubs/docutils/docutils/parsers/rst/roles.pyi | 5 ++++ .../docutils/docutils/transforms/__init__.pyi | 11 +++++++++ stubs/docutils/docutils/utils/__init__.pyi | 24 +++++++++++++++++++ 8 files changed, 93 insertions(+), 3 deletions(-) diff --git a/stubs/docutils/@tests/stubtest_allowlist.txt b/stubs/docutils/@tests/stubtest_allowlist.txt index a25a445905f6..4ce17775a14c 100644 --- a/stubs/docutils/@tests/stubtest_allowlist.txt +++ b/stubs/docutils/@tests/stubtest_allowlist.txt @@ -6,4 +6,13 @@ docutils.io.FileOutput.__getattr__ docutils.io.FileOutput.__init__ docutils.io.Input.__getattr__ docutils.io.Input.__init__ +docutils.languages.LanguageImporter.__getattr__ +docutils.nodes.Element.__getattr__ +docutils.nodes.Node.__getattr__ +docutils.nodes.document.__getattr__ +docutils.nodes.document.__init__ docutils.parsers.rst.Directive.__getattr__ +docutils.transforms.Transform.__getattr__ +docutils.transforms.Transformer.__getattr__ +docutils.utils.Reporter.__getattr__ +docutils.utils.Reporter.__init__ diff --git a/stubs/docutils/docutils/languages/__init__.pyi b/stubs/docutils/docutils/languages/__init__.pyi index 964e6fa3f426..a29787e9fb0d 100644 --- a/stubs/docutils/docutils/languages/__init__.pyi +++ b/stubs/docutils/docutils/languages/__init__.pyi @@ -1,3 +1,14 @@ from typing import Any -def __getattr__(name: str) -> Any: ... # incomplete +from docutils.utils import Reporter + +class _LanguageModule: + labels: dict[str, str] + author_separators: list[str] + bibliographic_fields: list[str] + +class LanguageImporter: + def __call__(self, language_code: str, reporter: Reporter | None = ...) -> _LanguageModule: ... + def __getattr__(self, __name: str) -> Any: ... # incomplete + +get_language: LanguageImporter diff --git a/stubs/docutils/docutils/nodes.pyi b/stubs/docutils/docutils/nodes.pyi index 964e6fa3f426..c69e9686de19 100644 --- a/stubs/docutils/docutils/nodes.pyi +++ b/stubs/docutils/docutils/nodes.pyi @@ -1,3 +1,23 @@ from typing import Any +from docutils.transforms import Transformer + +class Node: + parent: Node | None + source: str | None + line: int | None + document: document | None + def __getattr__(self, __name: str) -> Any: ... # incomplete + +class Element(Node): + def __init__(self, rawsource: str = ..., *children: Node, **attributes): ... + def __getattr__(self, __name: str) -> Any: ... # incomplete + +class Structural: ... +class Root: ... + +class document(Root, Structural, Element): + transformer: Transformer + def __getattr__(self, __name: str) -> Any: ... # incomplete + def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/__init__.pyi b/stubs/docutils/docutils/parsers/__init__.pyi index 75fd95c8956e..e663e2dcb94e 100644 --- a/stubs/docutils/docutils/parsers/__init__.pyi +++ b/stubs/docutils/docutils/parsers/__init__.pyi @@ -1,14 +1,15 @@ from typing import Any, ClassVar from docutils import Component +from docutils.nodes import document class Parser(Component): component_type: ClassVar[str] config_section: ClassVar[str] inputstring: Any # defined after call to setup_parse() document: Any # defined after call to setup_parse() - def parse(self, inputstring: str, document) -> None: ... - def setup_parse(self, inputstring: str, document) -> None: ... + def parse(self, inputstring: str, document: document) -> None: ... + def setup_parse(self, inputstring: str, document: document) -> None: ... def finish_parse(self) -> None: ... _parser_aliases: dict[str, str] diff --git a/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi b/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi index 964e6fa3f426..dfc675049485 100644 --- a/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi +++ b/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi @@ -1,3 +1,12 @@ from typing import Any +from docutils.languages import _LanguageModule +from docutils.nodes import document +from docutils.parsers.rst import Directive +from docutils.utils import SystemMessage + +def register_directive(name: str, directive: type[Directive]) -> None: ... +def directive( + directive_name: str, language_module: _LanguageModule, document: document +) -> tuple[type[Directive], list[SystemMessage]]: ... def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/parsers/rst/roles.pyi b/stubs/docutils/docutils/parsers/rst/roles.pyi index 4a319e6bbf64..b433542e16d9 100644 --- a/stubs/docutils/docutils/parsers/rst/roles.pyi +++ b/stubs/docutils/docutils/parsers/rst/roles.pyi @@ -2,6 +2,8 @@ from typing import Any, Callable import docutils.nodes import docutils.parsers.rst.states +from docutils.languages import _LanguageModule +from docutils.utils import Reporter, SystemMessage _RoleFn = Callable[ [str, str, str, int, docutils.parsers.rst.states.Inliner, dict[str, Any], list[str]], @@ -9,4 +11,7 @@ _RoleFn = Callable[ ] def register_local_role(name: str, role_fn: _RoleFn) -> None: ... +def role( + role_name: str, language_module: _LanguageModule, lineno: int, reporter: Reporter +) -> tuple[_RoleFn | None, list[SystemMessage]]: ... def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/transforms/__init__.pyi b/stubs/docutils/docutils/transforms/__init__.pyi index 964e6fa3f426..92b6fcb2ddc2 100644 --- a/stubs/docutils/docutils/transforms/__init__.pyi +++ b/stubs/docutils/docutils/transforms/__init__.pyi @@ -1,3 +1,14 @@ from typing import Any +from docutils.nodes import Node, document + +class Transform: + def __init__(self, document: document, startnode: Node | None = ...): ... + def __getattr__(self, __name: str) -> Any: ... # incomplete + +class Transformer: + def __init__(self, document: document): ... + def add_transform(self, transform_class: type[Transform], priority: int | None = ..., **kwargs) -> None: ... + def __getattr__(self, __name: str) -> Any: ... # incomplete + def __getattr__(name: str) -> Any: ... # incomplete diff --git a/stubs/docutils/docutils/utils/__init__.pyi b/stubs/docutils/docutils/utils/__init__.pyi index 189352a6770c..fc0c2f3460a9 100644 --- a/stubs/docutils/docutils/utils/__init__.pyi +++ b/stubs/docutils/docutils/utils/__init__.pyi @@ -1,7 +1,11 @@ +import optparse from collections.abc import Iterable from typing import Any +from typing_extensions import Literal +from docutils import ApplicationError from docutils.io import FileOutput +from docutils.nodes import document _list = list @@ -13,4 +17,24 @@ class DependencyList: def add(self, *filenames: str) -> None: ... def close(self) -> None: ... +_SystemMessageLevel = Literal[0, 1, 2, 3, 4] + +class Reporter: + DEBUG_LEVEL: Literal[0] + INFO_LEVEL: Literal[1] + WARNING_LEVEL: Literal[2] + ERROR_LEVEL: Literal[3] + SEVERE_LEVEL: Literal[4] + + source: str + report_level: _SystemMessageLevel + halt_level: _SystemMessageLevel + def __getattr__(self, __name: str) -> Any: ... # incomplete + +class SystemMessage(ApplicationError): + level: _SystemMessageLevel + def __init__(self, system_message: object, level: _SystemMessageLevel): ... + +def new_reporter(source_path: str, settings: optparse.Values) -> Reporter: ... +def new_document(source_path: str, settings: optparse.Values | None = ...) -> document: ... def __getattr__(name: str) -> Any: ... # incomplete From 72c48e1d0b624f6d82d7e9562e53f4eeb322aabf Mon Sep 17 00:00:00 2001 From: Martin Fischer Date: Mon, 21 Feb 2022 01:08:42 +0100 Subject: [PATCH 5/5] docutils: Address feeback by Jelle --- stubs/docutils/@tests/stubtest_allowlist.txt | 2 ++ stubs/docutils/docutils/languages/__init__.pyi | 4 ++-- stubs/docutils/docutils/parsers/__init__.pyi | 6 +++--- stubs/docutils/docutils/parsers/rst/directives/__init__.pyi | 2 +- 4 files changed, 8 insertions(+), 6 deletions(-) diff --git a/stubs/docutils/@tests/stubtest_allowlist.txt b/stubs/docutils/@tests/stubtest_allowlist.txt index 4ce17775a14c..5b0f264c1591 100644 --- a/stubs/docutils/@tests/stubtest_allowlist.txt +++ b/stubs/docutils/@tests/stubtest_allowlist.txt @@ -15,4 +15,6 @@ docutils.parsers.rst.Directive.__getattr__ docutils.transforms.Transform.__getattr__ docutils.transforms.Transformer.__getattr__ docutils.utils.Reporter.__getattr__ + +# the constructor appears to be mostly internal API, public API users are meant to use docutils.utils.new_reporter instead docutils.utils.Reporter.__init__ diff --git a/stubs/docutils/docutils/languages/__init__.pyi b/stubs/docutils/docutils/languages/__init__.pyi index a29787e9fb0d..d8747739d3ae 100644 --- a/stubs/docutils/docutils/languages/__init__.pyi +++ b/stubs/docutils/docutils/languages/__init__.pyi @@ -1,8 +1,8 @@ -from typing import Any +from typing import Any, Protocol from docutils.utils import Reporter -class _LanguageModule: +class _LanguageModule(Protocol): labels: dict[str, str] author_separators: list[str] bibliographic_fields: list[str] diff --git a/stubs/docutils/docutils/parsers/__init__.pyi b/stubs/docutils/docutils/parsers/__init__.pyi index e663e2dcb94e..04683301d1e2 100644 --- a/stubs/docutils/docutils/parsers/__init__.pyi +++ b/stubs/docutils/docutils/parsers/__init__.pyi @@ -1,15 +1,15 @@ from typing import Any, ClassVar from docutils import Component -from docutils.nodes import document +from docutils.nodes import document as _document class Parser(Component): component_type: ClassVar[str] config_section: ClassVar[str] inputstring: Any # defined after call to setup_parse() document: Any # defined after call to setup_parse() - def parse(self, inputstring: str, document: document) -> None: ... - def setup_parse(self, inputstring: str, document: document) -> None: ... + def parse(self, inputstring: str, document: _document) -> None: ... + def setup_parse(self, inputstring: str, document: _document) -> None: ... def finish_parse(self) -> None: ... _parser_aliases: dict[str, str] diff --git a/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi b/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi index dfc675049485..790329106fac 100644 --- a/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi +++ b/stubs/docutils/docutils/parsers/rst/directives/__init__.pyi @@ -8,5 +8,5 @@ from docutils.utils import SystemMessage def register_directive(name: str, directive: type[Directive]) -> None: ... def directive( directive_name: str, language_module: _LanguageModule, document: document -) -> tuple[type[Directive], list[SystemMessage]]: ... +) -> tuple[type[Directive] | None, list[SystemMessage]]: ... def __getattr__(name: str) -> Any: ... # incomplete