basedpyright 1.1.389 → 1.1.392

package/dist/typeshed-fallback/stdlib/email/_policybase.pyi

@@ -1,75 +1,77 @@
-from abc import ABCMeta, abstractmethod
-from email.errors import MessageDefect
-from email.header import Header
-from email.message import Message
-from typing import Generic, Protocol, TypeVar, type_check_only
-from typing_extensions import Self
-
-_MessageT = TypeVar("_MessageT", bound=Message, default=Message)
-
-@type_check_only
-class _MessageFactory(Protocol[_MessageT]):
-    def __call__(self, policy: Policy[_MessageT]) -> _MessageT: ...
-
-# Policy below is the only known direct subclass of _PolicyBase. We therefore
-# assume that the __init__ arguments and attributes of _PolicyBase are
-# the same as those of Policy.
-class _PolicyBase(Generic[_MessageT]):
-    max_line_length: int | None
-    linesep: str
-    cte_type: str
-    raise_on_defect: bool
-    mangle_from_: bool
-    message_factory: _MessageFactory[_MessageT] | None
-    # Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
-    verify_generated_headers: bool
-
-    def __init__(
-        self,
-        *,
-        max_line_length: int | None = 78,
-        linesep: str = "\n",
-        cte_type: str = "8bit",
-        raise_on_defect: bool = False,
-        mangle_from_: bool = ...,  # default depends on sub-class
-        message_factory: _MessageFactory[_MessageT] | None = None,
-        # Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
-        verify_generated_headers: bool = True,
-    ) -> None: ...
-    def clone(
-        self,
-        *,
-        max_line_length: int | None = ...,
-        linesep: str = ...,
-        cte_type: str = ...,
-        raise_on_defect: bool = ...,
-        mangle_from_: bool = ...,
-        message_factory: _MessageFactory[_MessageT] | None = ...,
-        # Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
-        verify_generated_headers: bool = ...,
-    ) -> Self: ...
-    def __add__(self, other: Policy) -> Self: ...
-
-class Policy(_PolicyBase[_MessageT], metaclass=ABCMeta):
-    def handle_defect(self, obj: _MessageT, defect: MessageDefect) -> None: ...
-    def register_defect(self, obj: _MessageT, defect: MessageDefect) -> None: ...
-    def header_max_count(self, name: str) -> int | None: ...
-    @abstractmethod
-    def header_source_parse(self, sourcelines: list[str]) -> tuple[str, str]: ...
-    @abstractmethod
-    def header_store_parse(self, name: str, value: str) -> tuple[str, str]: ...
-    @abstractmethod
-    def header_fetch_parse(self, name: str, value: str) -> str: ...
-    @abstractmethod
-    def fold(self, name: str, value: str) -> str: ...
-    @abstractmethod
-    def fold_binary(self, name: str, value: str) -> bytes: ...
-
-class Compat32(Policy[_MessageT]):
-    def header_source_parse(self, sourcelines: list[str]) -> tuple[str, str]: ...
-    def header_store_parse(self, name: str, value: str) -> tuple[str, str]: ...
-    def header_fetch_parse(self, name: str, value: str) -> str | Header: ...  # type: ignore[override]
-    def fold(self, name: str, value: str) -> str: ...
-    def fold_binary(self, name: str, value: str) -> bytes: ...
-
-compat32: Compat32[Message]
+from abc import ABCMeta, abstractmethod
+from email.errors import MessageDefect
+from email.header import Header
+from email.message import Message
+from typing import Generic, Protocol, TypeVar, type_check_only
+from typing_extensions import Self
+
+__all__ = ["Policy", "Compat32", "compat32"]
+
+_MessageT = TypeVar("_MessageT", bound=Message, default=Message)
+
+@type_check_only
+class _MessageFactory(Protocol[_MessageT]):
+    def __call__(self, policy: Policy[_MessageT]) -> _MessageT: ...
+
+# Policy below is the only known direct subclass of _PolicyBase. We therefore
+# assume that the __init__ arguments and attributes of _PolicyBase are
+# the same as those of Policy.
+class _PolicyBase(Generic[_MessageT]):
+    max_line_length: int | None
+    linesep: str
+    cte_type: str
+    raise_on_defect: bool
+    mangle_from_: bool
+    message_factory: _MessageFactory[_MessageT] | None
+    # Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
+    verify_generated_headers: bool
+
+    def __init__(
+        self,
+        *,
+        max_line_length: int | None = 78,
+        linesep: str = "\n",
+        cte_type: str = "8bit",
+        raise_on_defect: bool = False,
+        mangle_from_: bool = ...,  # default depends on sub-class
+        message_factory: _MessageFactory[_MessageT] | None = None,
+        # Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
+        verify_generated_headers: bool = True,
+    ) -> None: ...
+    def clone(
+        self,
+        *,
+        max_line_length: int | None = ...,
+        linesep: str = ...,
+        cte_type: str = ...,
+        raise_on_defect: bool = ...,
+        mangle_from_: bool = ...,
+        message_factory: _MessageFactory[_MessageT] | None = ...,
+        # Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
+        verify_generated_headers: bool = ...,
+    ) -> Self: ...
+    def __add__(self, other: Policy) -> Self: ...
+
+class Policy(_PolicyBase[_MessageT], metaclass=ABCMeta):
+    def handle_defect(self, obj: _MessageT, defect: MessageDefect) -> None: ...
+    def register_defect(self, obj: _MessageT, defect: MessageDefect) -> None: ...
+    def header_max_count(self, name: str) -> int | None: ...
+    @abstractmethod
+    def header_source_parse(self, sourcelines: list[str]) -> tuple[str, str]: ...
+    @abstractmethod
+    def header_store_parse(self, name: str, value: str) -> tuple[str, str]: ...
+    @abstractmethod
+    def header_fetch_parse(self, name: str, value: str) -> str: ...
+    @abstractmethod
+    def fold(self, name: str, value: str) -> str: ...
+    @abstractmethod
+    def fold_binary(self, name: str, value: str) -> bytes: ...
+
+class Compat32(Policy[_MessageT]):
+    def header_source_parse(self, sourcelines: list[str]) -> tuple[str, str]: ...
+    def header_store_parse(self, name: str, value: str) -> tuple[str, str]: ...
+    def header_fetch_parse(self, name: str, value: str) -> str | Header: ...  # type: ignore[override]
+    def fold(self, name: str, value: str) -> str: ...
+    def fold_binary(self, name: str, value: str) -> bytes: ...
+
+compat32: Compat32[Message]

package/dist/typeshed-fallback/stdlib/email/base64mime.pyi

@@ -1,13 +1,13 @@
-__all__ = ["body_decode", "body_encode", "decode", "decodestring", "header_encode", "header_length"]
-
-from _typeshed import ReadableBuffer
-
-def header_length(bytearray: str | bytes | bytearray) -> int: ...
-def header_encode(header_bytes: str | ReadableBuffer, charset: str = "iso-8859-1") -> str: ...
-
-# First argument should be a buffer that supports slicing and len().
-def body_encode(s: bytes | bytearray, maxlinelen: int = 76, eol: str = "\n") -> str: ...
-def decode(string: str | ReadableBuffer) -> bytes: ...
-
-body_decode = decode
-decodestring = decode
+__all__ = ["body_decode", "body_encode", "decode", "decodestring", "header_encode", "header_length"]
+
+from _typeshed import ReadableBuffer
+
+def header_length(bytearray: str | bytes | bytearray) -> int: ...
+def header_encode(header_bytes: str | ReadableBuffer, charset: str = "iso-8859-1") -> str: ...
+
+# First argument should be a buffer that supports slicing and len().
+def body_encode(s: bytes | bytearray, maxlinelen: int = 76, eol: str = "\n") -> str: ...
+def decode(string: str | ReadableBuffer) -> bytes: ...
+
+body_decode = decode
+decodestring = decode

package/dist/typeshed-fallback/stdlib/email/charset.pyi

@@ -1,36 +1,36 @@
-from collections.abc import Callable, Iterator
-from email.message import Message
-from typing import Final, overload
-
-__all__ = ["Charset", "add_alias", "add_charset", "add_codec"]
-
-QP: Final[int]  # undocumented
-BASE64: Final[int]  # undocumented
-SHORTEST: Final[int]  # undocumented
-
-class Charset:
-    input_charset: str
-    header_encoding: int
-    body_encoding: int
-    output_charset: str | None
-    input_codec: str | None
-    output_codec: str | None
-    def __init__(self, input_charset: str = "us-ascii") -> None: ...
-    def get_body_encoding(self) -> str | Callable[[Message], None]: ...
-    def get_output_charset(self) -> str | None: ...
-    def header_encode(self, string: str) -> str: ...
-    def header_encode_lines(self, string: str, maxlengths: Iterator[int]) -> list[str | None]: ...
-    @overload
-    def body_encode(self, string: None) -> None: ...
-    @overload
-    def body_encode(self, string: str | bytes) -> str: ...
-    def __eq__(self, other: object) -> bool: ...
-    def __ne__(self, value: object, /) -> bool:
-        """Return self!=value."""
-        ...
-
-def add_charset(
-    charset: str, header_enc: int | None = None, body_enc: int | None = None, output_charset: str | None = None
-) -> None: ...
-def add_alias(alias: str, canonical: str) -> None: ...
-def add_codec(charset: str, codecname: str) -> None: ...
+from collections.abc import Callable, Iterator
+from email.message import Message
+from typing import Final, overload
+
+__all__ = ["Charset", "add_alias", "add_charset", "add_codec"]
+
+QP: Final[int]  # undocumented
+BASE64: Final[int]  # undocumented
+SHORTEST: Final[int]  # undocumented
+
+class Charset:
+    input_charset: str
+    header_encoding: int
+    body_encoding: int
+    output_charset: str | None
+    input_codec: str | None
+    output_codec: str | None
+    def __init__(self, input_charset: str = "us-ascii") -> None: ...
+    def get_body_encoding(self) -> str | Callable[[Message], None]: ...
+    def get_output_charset(self) -> str | None: ...
+    def header_encode(self, string: str) -> str: ...
+    def header_encode_lines(self, string: str, maxlengths: Iterator[int]) -> list[str | None]: ...
+    @overload
+    def body_encode(self, string: None) -> None: ...
+    @overload
+    def body_encode(self, string: str | bytes) -> str: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, value: object, /) -> bool:
+        """Return self!=value."""
+        ...
+
+def add_charset(
+    charset: str, header_enc: int | None = None, body_enc: int | None = None, output_charset: str | None = None
+) -> None: ...
+def add_alias(alias: str, canonical: str) -> None: ...
+def add_codec(charset: str, codecname: str) -> None: ...

package/dist/typeshed-fallback/stdlib/email/contentmanager.pyi

@@ -1,11 +1,11 @@
-from collections.abc import Callable
-from email.message import Message
-from typing import Any
-
-class ContentManager:
-    def get_content(self, msg: Message, *args: Any, **kw: Any) -> Any: ...
-    def set_content(self, msg: Message, obj: Any, *args: Any, **kw: Any) -> Any: ...
-    def add_get_handler(self, key: str, handler: Callable[..., Any]) -> None: ...
-    def add_set_handler(self, typekey: type, handler: Callable[..., Any]) -> None: ...
-
-raw_data_manager: ContentManager
+from collections.abc import Callable
+from email.message import Message
+from typing import Any
+
+class ContentManager:
+    def get_content(self, msg: Message, *args: Any, **kw: Any) -> Any: ...
+    def set_content(self, msg: Message, obj: Any, *args: Any, **kw: Any) -> Any: ...
+    def add_get_handler(self, key: str, handler: Callable[..., Any]) -> None: ...
+    def add_set_handler(self, typekey: type, handler: Callable[..., Any]) -> None: ...
+
+raw_data_manager: ContentManager

package/dist/typeshed-fallback/stdlib/email/encoders.pyi

@@ -1,8 +1,8 @@
-from email.message import Message
-
-__all__ = ["encode_7or8bit", "encode_base64", "encode_noop", "encode_quopri"]
-
-def encode_base64(msg: Message) -> None: ...
-def encode_quopri(msg: Message) -> None: ...
-def encode_7or8bit(msg: Message) -> None: ...
-def encode_noop(msg: Message) -> None: ...
+from email.message import Message
+
+__all__ = ["encode_7or8bit", "encode_base64", "encode_noop", "encode_quopri"]
+
+def encode_base64(msg: Message) -> None: ...
+def encode_quopri(msg: Message) -> None: ...
+def encode_7or8bit(msg: Message) -> None: ...
+def encode_noop(msg: Message) -> None: ...

package/dist/typeshed-fallback/stdlib/email/errors.pyi

@@ -1,42 +1,42 @@
-import sys
-
-class MessageError(Exception): ...
-class MessageParseError(MessageError): ...
-class HeaderParseError(MessageParseError): ...
-class BoundaryError(MessageParseError): ...
-class MultipartConversionError(MessageError, TypeError): ...
-class CharsetError(MessageError): ...
-
-# Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
-class HeaderWriteError(MessageError): ...
-
-class MessageDefect(ValueError):
-    def __init__(self, line: str | None = None) -> None: ...
-
-class NoBoundaryInMultipartDefect(MessageDefect): ...
-class StartBoundaryNotFoundDefect(MessageDefect): ...
-class FirstHeaderLineIsContinuationDefect(MessageDefect): ...
-class MisplacedEnvelopeHeaderDefect(MessageDefect): ...
-class MultipartInvariantViolationDefect(MessageDefect): ...
-class InvalidMultipartContentTransferEncodingDefect(MessageDefect): ...
-class UndecodableBytesDefect(MessageDefect): ...
-class InvalidBase64PaddingDefect(MessageDefect): ...
-class InvalidBase64CharactersDefect(MessageDefect): ...
-class InvalidBase64LengthDefect(MessageDefect): ...
-class CloseBoundaryNotFoundDefect(MessageDefect): ...
-class MissingHeaderBodySeparatorDefect(MessageDefect): ...
-
-MalformedHeaderDefect = MissingHeaderBodySeparatorDefect
-
-class HeaderDefect(MessageDefect): ...
-class InvalidHeaderDefect(HeaderDefect): ...
-class HeaderMissingRequiredValue(HeaderDefect): ...
-
-class NonPrintableDefect(HeaderDefect):
-    def __init__(self, non_printables: str | None) -> None: ...
-
-class ObsoleteHeaderDefect(HeaderDefect): ...
-class NonASCIILocalPartDefect(HeaderDefect): ...
-
-if sys.version_info >= (3, 10):
-    class InvalidDateDefect(HeaderDefect): ...
+import sys
+
+class MessageError(Exception): ...
+class MessageParseError(MessageError): ...
+class HeaderParseError(MessageParseError): ...
+class BoundaryError(MessageParseError): ...
+class MultipartConversionError(MessageError, TypeError): ...
+class CharsetError(MessageError): ...
+
+# Added in Python 3.8.20, 3.9.20, 3.10.15, 3.11.10, 3.12.5
+class HeaderWriteError(MessageError): ...
+
+class MessageDefect(ValueError):
+    def __init__(self, line: str | None = None) -> None: ...
+
+class NoBoundaryInMultipartDefect(MessageDefect): ...
+class StartBoundaryNotFoundDefect(MessageDefect): ...
+class FirstHeaderLineIsContinuationDefect(MessageDefect): ...
+class MisplacedEnvelopeHeaderDefect(MessageDefect): ...
+class MultipartInvariantViolationDefect(MessageDefect): ...
+class InvalidMultipartContentTransferEncodingDefect(MessageDefect): ...
+class UndecodableBytesDefect(MessageDefect): ...
+class InvalidBase64PaddingDefect(MessageDefect): ...
+class InvalidBase64CharactersDefect(MessageDefect): ...
+class InvalidBase64LengthDefect(MessageDefect): ...
+class CloseBoundaryNotFoundDefect(MessageDefect): ...
+class MissingHeaderBodySeparatorDefect(MessageDefect): ...
+
+MalformedHeaderDefect = MissingHeaderBodySeparatorDefect
+
+class HeaderDefect(MessageDefect): ...
+class InvalidHeaderDefect(HeaderDefect): ...
+class HeaderMissingRequiredValue(HeaderDefect): ...
+
+class NonPrintableDefect(HeaderDefect):
+    def __init__(self, non_printables: str | None) -> None: ...
+
+class ObsoleteHeaderDefect(HeaderDefect): ...
+class NonASCIILocalPartDefect(HeaderDefect): ...
+
+if sys.version_info >= (3, 10):
+    class InvalidDateDefect(HeaderDefect): ...

package/dist/typeshed-fallback/stdlib/email/feedparser.pyi

@@ -1,23 +1,23 @@
-from collections.abc import Callable
-from email.message import Message
-from email.policy import Policy
-from typing import Generic, TypeVar, overload
-
-__all__ = ["FeedParser", "BytesFeedParser"]
-
-_MessageT = TypeVar("_MessageT", bound=Message, default=Message)
-
-class FeedParser(Generic[_MessageT]):
-    @overload
-    def __init__(self: FeedParser[Message], _factory: None = None, *, policy: Policy[Message] = ...) -> None: ...
-    @overload
-    def __init__(self, _factory: Callable[[], _MessageT], *, policy: Policy[_MessageT] = ...) -> None: ...
-    def feed(self, data: str) -> None: ...
-    def close(self) -> _MessageT: ...
-
-class BytesFeedParser(FeedParser[_MessageT]):
-    @overload
-    def __init__(self: BytesFeedParser[Message], _factory: None = None, *, policy: Policy[Message] = ...) -> None: ...
-    @overload
-    def __init__(self, _factory: Callable[[], _MessageT], *, policy: Policy[_MessageT] = ...) -> None: ...
-    def feed(self, data: bytes | bytearray) -> None: ...  # type: ignore[override]
+from collections.abc import Callable
+from email.message import Message
+from email.policy import Policy
+from typing import Generic, TypeVar, overload
+
+__all__ = ["FeedParser", "BytesFeedParser"]
+
+_MessageT = TypeVar("_MessageT", bound=Message, default=Message)
+
+class FeedParser(Generic[_MessageT]):
+    @overload
+    def __init__(self: FeedParser[Message], _factory: None = None, *, policy: Policy[Message] = ...) -> None: ...
+    @overload
+    def __init__(self, _factory: Callable[[], _MessageT], *, policy: Policy[_MessageT] = ...) -> None: ...
+    def feed(self, data: str) -> None: ...
+    def close(self) -> _MessageT: ...
+
+class BytesFeedParser(FeedParser[_MessageT]):
+    @overload
+    def __init__(self: BytesFeedParser[Message], _factory: None = None, *, policy: Policy[Message] = ...) -> None: ...
+    @overload
+    def __init__(self, _factory: Callable[[], _MessageT], *, policy: Policy[_MessageT] = ...) -> None: ...
+    def feed(self, data: bytes | bytearray) -> None: ...  # type: ignore[override]

package/dist/typeshed-fallback/stdlib/email/generator.pyi

@@ -1,77 +1,77 @@
-from _typeshed import SupportsWrite
-from email.message import Message
-from email.policy import Policy
-from typing import Any, Generic, TypeVar, overload
-from typing_extensions import Self
-
-__all__ = ["Generator", "DecodedGenerator", "BytesGenerator"]
-
-# By default, generators do not have a message policy.
-_MessageT = TypeVar("_MessageT", bound=Message, default=Any)
-
-class Generator(Generic[_MessageT]):
-    maxheaderlen: int | None
-    policy: Policy[_MessageT] | None
-    @overload
-    def __init__(
-        self: Generator[Any],  # The Policy of the message is used.
-        outfp: SupportsWrite[str],
-        mangle_from_: bool | None = None,
-        maxheaderlen: int | None = None,
-        *,
-        policy: None = None,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        outfp: SupportsWrite[str],
-        mangle_from_: bool | None = None,
-        maxheaderlen: int | None = None,
-        *,
-        policy: Policy[_MessageT],
-    ) -> None: ...
-    def write(self, s: str) -> None: ...
-    def flatten(self, msg: _MessageT, unixfrom: bool = False, linesep: str | None = None) -> None: ...
-    def clone(self, fp: SupportsWrite[str]) -> Self: ...
-
-class BytesGenerator(Generator[_MessageT]):
-    @overload
-    def __init__(
-        self: BytesGenerator[Any],  # The Policy of the message is used.
-        outfp: SupportsWrite[bytes],
-        mangle_from_: bool | None = None,
-        maxheaderlen: int | None = None,
-        *,
-        policy: None = None,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        outfp: SupportsWrite[bytes],
-        mangle_from_: bool | None = None,
-        maxheaderlen: int | None = None,
-        *,
-        policy: Policy[_MessageT],
-    ) -> None: ...
-
-class DecodedGenerator(Generator[_MessageT]):
-    @overload
-    def __init__(
-        self: DecodedGenerator[Any],  # The Policy of the message is used.
-        outfp: SupportsWrite[str],
-        mangle_from_: bool | None = None,
-        maxheaderlen: int | None = None,
-        fmt: str | None = None,
-        *,
-        policy: None = None,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        outfp: SupportsWrite[str],
-        mangle_from_: bool | None = None,
-        maxheaderlen: int | None = None,
-        fmt: str | None = None,
-        *,
-        policy: Policy[_MessageT],
-    ) -> None: ...
+from _typeshed import SupportsWrite
+from email.message import Message
+from email.policy import Policy
+from typing import Any, Generic, TypeVar, overload
+from typing_extensions import Self
+
+__all__ = ["Generator", "DecodedGenerator", "BytesGenerator"]
+
+# By default, generators do not have a message policy.
+_MessageT = TypeVar("_MessageT", bound=Message, default=Any)
+
+class Generator(Generic[_MessageT]):
+    maxheaderlen: int | None
+    policy: Policy[_MessageT] | None
+    @overload
+    def __init__(
+        self: Generator[Any],  # The Policy of the message is used.
+        outfp: SupportsWrite[str],
+        mangle_from_: bool | None = None,
+        maxheaderlen: int | None = None,
+        *,
+        policy: None = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        outfp: SupportsWrite[str],
+        mangle_from_: bool | None = None,
+        maxheaderlen: int | None = None,
+        *,
+        policy: Policy[_MessageT],
+    ) -> None: ...
+    def write(self, s: str) -> None: ...
+    def flatten(self, msg: _MessageT, unixfrom: bool = False, linesep: str | None = None) -> None: ...
+    def clone(self, fp: SupportsWrite[str]) -> Self: ...
+
+class BytesGenerator(Generator[_MessageT]):
+    @overload
+    def __init__(
+        self: BytesGenerator[Any],  # The Policy of the message is used.
+        outfp: SupportsWrite[bytes],
+        mangle_from_: bool | None = None,
+        maxheaderlen: int | None = None,
+        *,
+        policy: None = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        outfp: SupportsWrite[bytes],
+        mangle_from_: bool | None = None,
+        maxheaderlen: int | None = None,
+        *,
+        policy: Policy[_MessageT],
+    ) -> None: ...
+
+class DecodedGenerator(Generator[_MessageT]):
+    @overload
+    def __init__(
+        self: DecodedGenerator[Any],  # The Policy of the message is used.
+        outfp: SupportsWrite[str],
+        mangle_from_: bool | None = None,
+        maxheaderlen: int | None = None,
+        fmt: str | None = None,
+        *,
+        policy: None = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        outfp: SupportsWrite[str],
+        mangle_from_: bool | None = None,
+        maxheaderlen: int | None = None,
+        fmt: str | None = None,
+        *,
+        policy: Policy[_MessageT],
+    ) -> None: ...

package/dist/typeshed-fallback/stdlib/email/header.pyi

@@ -1,33 +1,33 @@
-from collections.abc import Iterable
-from email.charset import Charset
-from typing import Any
-
-__all__ = ["Header", "decode_header", "make_header"]
-
-class Header:
-    def __init__(
-        self,
-        s: bytes | bytearray | str | None = None,
-        charset: Charset | str | None = None,
-        maxlinelen: int | None = None,
-        header_name: str | None = None,
-        continuation_ws: str = " ",
-        errors: str = "strict",
-    ) -> None: ...
-    def append(self, s: bytes | bytearray | str, charset: Charset | str | None = None, errors: str = "strict") -> None: ...
-    def encode(self, splitchars: str = ";, \t", maxlinelen: int | None = None, linesep: str = "\n") -> str: ...
-    def __eq__(self, other: object) -> bool: ...
-    def __ne__(self, value: object, /) -> bool:
-        """Return self!=value."""
-        ...
-
-# decode_header() either returns list[tuple[str, None]] if the header
-# contains no encoded parts, or list[tuple[bytes, str | None]] if the header
-# contains at least one encoded part.
-def decode_header(header: Header | str) -> list[tuple[Any, Any | None]]: ...
-def make_header(
-    decoded_seq: Iterable[tuple[bytes | bytearray | str, str | None]],
-    maxlinelen: int | None = None,
-    header_name: str | None = None,
-    continuation_ws: str = " ",
-) -> Header: ...
+from collections.abc import Iterable
+from email.charset import Charset
+from typing import Any
+
+__all__ = ["Header", "decode_header", "make_header"]
+
+class Header:
+    def __init__(
+        self,
+        s: bytes | bytearray | str | None = None,
+        charset: Charset | str | None = None,
+        maxlinelen: int | None = None,
+        header_name: str | None = None,
+        continuation_ws: str = " ",
+        errors: str = "strict",
+    ) -> None: ...
+    def append(self, s: bytes | bytearray | str, charset: Charset | str | None = None, errors: str = "strict") -> None: ...
+    def encode(self, splitchars: str = ";, \t", maxlinelen: int | None = None, linesep: str = "\n") -> str: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, value: object, /) -> bool:
+        """Return self!=value."""
+        ...
+
+# decode_header() either returns list[tuple[str, None]] if the header
+# contains no encoded parts, or list[tuple[bytes, str | None]] if the header
+# contains at least one encoded part.
+def decode_header(header: Header | str) -> list[tuple[Any, Any | None]]: ...
+def make_header(
+    decoded_seq: Iterable[tuple[bytes | bytearray | str, str | None]],
+    maxlinelen: int | None = None,
+    header_name: str | None = None,
+    continuation_ws: str = " ",
+) -> Header: ...