Skip to content

[docutils] Type Publisher attributes and the source/destination classes in docutils.core #16268

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
srittau merged 2 commits into from
Aug 20, 2026
Merged

[docutils] Type Publisher attributes and the source/destination classes in docutils.core #16268

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
de54bf1
[docutils] Type Publisher attributes and the source/destination class…
ekanshul Aug 19, 2026
43348e2
Merge branch 'main' into docutils-core-publisher
srittau Aug 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions stubs/docutils/docutils/core.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@ from _typeshed import Incomplete, StrPath
from typing import Final
from typing_extensions import deprecated

from docutils import SettingsSpec
from docutils.io import FileInput, Input, Output
from docutils import SettingsSpec, nodes
from docutils.io import Input, Output
from docutils.parsers import Parser
from docutils.readers import Reader
from docutils.utils import SystemMessage
Expand All @@ -12,24 +12,24 @@ from docutils.writers import Writer, _WriterParts
__docformat__: Final = "reStructuredText"

class Publisher:
document: Incomplete | None
document: nodes.document | None
reader: Reader[Incomplete]
parser: Parser
writer: Writer[Incomplete]
source: Input[Incomplete]
source_class: Incomplete
source_class: type[Input[Incomplete]]
destination: Output | None
destination_class: Incomplete
destination_class: type[Output]
settings: dict[str, Incomplete]
def __init__(
self,
reader: Reader[Incomplete] | None = None,
parser: Parser | None = None,
writer: Writer[Incomplete] | None = None,
source: Input[Incomplete] | None = None,
source_class=...,
source_class: type[Input[Incomplete]] = ...,
destination: Output | None = None,
destination_class=...,
destination_class: type[Output] = ...,
settings: dict[str, Incomplete] | None = None,
) -> None: ...
def set_reader(self, reader: str, parser: Parser | None = None, parser_name: str | None = None) -> None: ...
Expand Down Expand Up @@ -129,7 +129,7 @@ def publish_string(
def publish_parts(
source,
source_path: StrPath | None = None,
source_class=...,
source_class: type[Input[Incomplete]] = ...,
destination_path: StrPath | None = None,
reader=None,
reader_name: str | None = None,
Expand All @@ -146,7 +146,7 @@ def publish_parts(
def publish_doctree(
source,
source_path: StrPath | None = None,
source_class=...,
source_class: type[Input[Incomplete]] = ...,
reader=None,
reader_name: str | None = None,
parser=None,
Expand Down Expand Up @@ -185,13 +185,13 @@ def publish_cmdline_to_binary(
usage: str = "%prog [options] [<source> [<destination>]]",
description: str = ...,
destination=None,
destination_class=...,
destination_class: type[Output] = ...,
): ...
def publish_programmatically(
source_class: type[FileInput],
source_class: type[Input[Incomplete]],
source,
source_path: StrPath | None,
destination_class,
destination_class: type[Output],
destination,
destination_path: StrPath | None,
reader,
Expand Down