From 22a5840d61a7f99d8771896f21923105c231e00e Mon Sep 17 00:00:00 2001 From: Semyon Moroz Date: Mon, 7 Jul 2025 17:18:48 +0000 Subject: [PATCH] [docutils] Add missing stubs for `readers` dir (#14242) --- stubs/docutils/docutils/readers/__init__.pyi | 7 +++++-- stubs/docutils/docutils/readers/doctree.pyi | 5 +++-- stubs/docutils/docutils/readers/pep.pyi | 13 ++++++++++++- stubs/docutils/docutils/readers/standalone.pyi | 12 +++++++++++- 4 files changed, 31 insertions(+), 6 deletions(-) diff --git a/stubs/docutils/docutils/readers/__init__.pyi b/stubs/docutils/docutils/readers/__init__.pyi index 24777ae01..d29e4aa71 100644 --- a/stubs/docutils/docutils/readers/__init__.pyi +++ b/stubs/docutils/docutils/readers/__init__.pyi @@ -1,4 +1,4 @@ -from typing import Any, ClassVar, Generic, TypeVar +from typing import Any, ClassVar, Final, Generic, TypeVar from docutils import Component, nodes from docutils.frontend import Values @@ -8,6 +8,8 @@ from docutils.transforms import Transform _S = TypeVar("_S") +__docformat__: Final = "reStructuredText" + class Reader(Component, Generic[_S]): component_type: ClassVar[str] config_section: ClassVar[str] @@ -15,8 +17,9 @@ class Reader(Component, Generic[_S]): def __init__(self, parser: Parser | None = None, parser_name: str | None = None) -> None: ... parser: Parser | None source: Input[_S] | None - input: str | Any | None + input: str | None def set_parser(self, parser_name: str) -> None: ... + settings: Values def read(self, source: Input[_S], parser: Parser, settings: Values) -> nodes.document: ... document: nodes.document def parse(self) -> None: ... diff --git a/stubs/docutils/docutils/readers/doctree.pyi b/stubs/docutils/docutils/readers/doctree.pyi index 49c796cc7..a3075e569 100644 --- a/stubs/docutils/docutils/readers/doctree.pyi +++ b/stubs/docutils/docutils/readers/doctree.pyi @@ -1,7 +1,8 @@ -from typing import TypeVar +from typing import ClassVar, TypeVar from docutils import readers _S = TypeVar("_S", bound=str | bytes) -class Reader(readers.ReReader[_S]): ... +class Reader(readers.ReReader[_S]): + config_section_dependencies: ClassVar[tuple[str, ...]] diff --git a/stubs/docutils/docutils/readers/pep.pyi b/stubs/docutils/docutils/readers/pep.pyi index 5b0f74feb..ef0247369 100644 --- a/stubs/docutils/docutils/readers/pep.pyi +++ b/stubs/docutils/docutils/readers/pep.pyi @@ -1 +1,12 @@ -def __getattr__(name: str): ... # incomplete module +from typing import ClassVar, Final, TypeVar + +from docutils.parsers.rst import states +from docutils.readers import standalone + +__docformat__: Final = "reStructuredText" + +_S = TypeVar("_S", bound=str | bytes) + +class Reader(standalone.Reader[_S]): + settings_default_overrides: ClassVar[dict[str, int]] + inliner_class: ClassVar[type[states.Inliner]] diff --git a/stubs/docutils/docutils/readers/standalone.pyi b/stubs/docutils/docutils/readers/standalone.pyi index 5b0f74feb..40bdc0b93 100644 --- a/stubs/docutils/docutils/readers/standalone.pyi +++ b/stubs/docutils/docutils/readers/standalone.pyi @@ -1 +1,11 @@ -def __getattr__(name: str): ... # incomplete module +from typing import ClassVar, Final, TypeVar + +from docutils import readers + +__docformat__: Final = "reStructuredText" + +_S = TypeVar("_S", bound=str | bytes) + +class Reader(readers.Reader[_S]): + document: None # type: ignore[assignment] + config_section_dependencies: ClassVar[tuple[str, ...]]