email stubtest exceptions (#5207)

stdlib/email/headerregistry.pyi

@@ -1,7 +1,17 @@
+import sys
 from datetime import datetime as _datetime
+from email._header_value_parser import (
+    AddressList,
+    ContentDisposition,
+    ContentTransferEncoding,
+    ContentType,
+    MIMEVersion,
+    TokenList,
+    UnstructuredTokenList,
+)
 from email.errors import MessageDefect
 from email.policy import Policy
-from typing import Any, Dict, Iterable, Mapping, Optional, Tuple, Union
+from typing import Any, Dict, Iterable, Mapping, Optional, Tuple, Type, Union
 
 class BaseHeader(str):
     @property
@@ -11,27 +21,36 @@ class BaseHeader(str):
     @property
     def max_count(self) -> Optional[int]: ...
     def __new__(cls, name: str, value: Any) -> BaseHeader: ...
-    def init(self, *args: Any, **kw: Any) -> None: ...
+    def init(self, name: str, *, parse_tree: TokenList, defects: Iterable[MessageDefect]) -> None: ...
     def fold(self, *, policy: Policy) -> str: ...
 
 class UnstructuredHeader:
+    @staticmethod
+    def value_parser(value: str) -> UnstructuredTokenList: ...
     @classmethod
-    def parse(cls, string: str, kwds: Dict[str, Any]) -> None: ...
+    def parse(cls, value: str, kwds: Dict[str, Any]) -> None: ...
 
 class UniqueUnstructuredHeader(UnstructuredHeader): ...
 
 class DateHeader:
-    datetime: _datetime
+    @property
+    def datetime(self) -> _datetime: ...
+    @staticmethod
+    def value_parser(value: str) -> UnstructuredTokenList: ...
     @classmethod
-    def parse(cls, string: Union[str, _datetime], kwds: Dict[str, Any]) -> None: ...
+    def parse(cls, value: Union[str, _datetime], kwds: Dict[str, Any]) -> None: ...
 
 class UniqueDateHeader(DateHeader): ...
 
 class AddressHeader:
-    groups: Tuple[Group, ...]
-    addresses: Tuple[Address, ...]
+    @property
+    def groups(self) -> Tuple[Group, ...]: ...
+    @property
+    def addresses(self) -> Tuple[Address, ...]: ...
+    @staticmethod
+    def value_parser(value: str) -> AddressList: ...
     @classmethod
-    def parse(cls, string: str, kwds: Dict[str, Any]) -> None: ...
+    def parse(cls, value: str, kwds: Dict[str, Any]) -> None: ...
 
 class UniqueAddressHeader(AddressHeader): ...
 
@@ -42,40 +61,70 @@ class SingleAddressHeader(AddressHeader):
 class UniqueSingleAddressHeader(SingleAddressHeader): ...
 
 class MIMEVersionHeader:
-    version: Optional[str]
-    major: Optional[int]
-    minor: Optional[int]
+    @property
+    def version(self) -> Optional[str]: ...
+    @property
+    def major(self) -> Optional[int]: ...
+    @property
+    def minor(self) -> Optional[int]: ...
+    @staticmethod
+    def value_parser(value: str) -> MIMEVersion: ...
     @classmethod
-    def parse(cls, string: str, kwds: Dict[str, Any]) -> None: ...
+    def parse(cls, value: str, kwds: Dict[str, Any]) -> None: ...
 
 class ParameterizedMIMEHeader:
-    params: Mapping[str, Any]
+    @property
+    def params(self) -> Mapping[str, Any]: ...
     @classmethod
-    def parse(cls, string: str, kwds: Dict[str, Any]) -> None: ...
+    def parse(cls, value: str, kwds: Dict[str, Any]) -> None: ...
 
 class ContentTypeHeader(ParameterizedMIMEHeader):
-    content_type: str
-    maintype: str
-    subtype: str
+    @property
+    def content_type(self) -> str: ...
+    @property
+    def maintype(self) -> str: ...
+    @property
+    def subtype(self) -> str: ...
+    @staticmethod
+    def value_parser(value: str) -> ContentType: ...
 
 class ContentDispositionHeader(ParameterizedMIMEHeader):
-    content_disposition: str
+    @property
+    def content_disposition(self) -> str: ...
+    @staticmethod
+    def value_parser(value: str) -> ContentDisposition: ...
 
 class ContentTransferEncodingHeader:
-    cte: str
+    @property
+    def cte(self) -> str: ...
     @classmethod
-    def parse(cls, string: str, kwds: Dict[str, Any]) -> None: ...
+    def parse(cls, value: str, kwds: Dict[str, Any]) -> None: ...
+    @staticmethod
+    def value_parser(value: str) -> ContentTransferEncoding: ...
+
+if sys.version_info >= (3, 8):
+    from email._header_value_parser import MessageID
+    class MessageIDHeader:
+        @classmethod
+        def parse(cls, value: str, kwds: Dict[str, Any]) -> None: ...
+        @staticmethod
+        def value_parser(value: str) -> MessageID: ...
 
 class HeaderRegistry:
-    def __init__(self, base_class: BaseHeader = ..., default_class: BaseHeader = ..., use_default_map: bool = ...) -> None: ...
-    def map_to_type(self, name: str, cls: BaseHeader) -> None: ...
-    def __getitem__(self, name: str) -> BaseHeader: ...
+    def __init__(
+        self, base_class: Type[BaseHeader] = ..., default_class: Type[BaseHeader] = ..., use_default_map: bool = ...
+    ) -> None: ...
+    def map_to_type(self, name: str, cls: Type[BaseHeader]) -> None: ...
+    def __getitem__(self, name: str) -> Type[BaseHeader]: ...
     def __call__(self, name: str, value: Any) -> BaseHeader: ...
 
 class Address:
-    display_name: str
-    username: str
-    domain: str
+    @property
+    def display_name(self) -> str: ...
+    @property
+    def username(self) -> str: ...
+    @property
+    def domain(self) -> str: ...
     @property
     def addr_spec(self) -> str: ...
     def __init__(
@@ -84,7 +133,9 @@ class Address:
     def __str__(self) -> str: ...
 
 class Group:
-    display_name: Optional[str]
-    addresses: Tuple[Address, ...]
+    @property
+    def display_name(self) -> Optional[str]: ...
+    @property
+    def addresses(self) -> Tuple[Address, ...]: ...
     def __init__(self, display_name: Optional[str] = ..., addresses: Optional[Iterable[Address]] = ...) -> None: ...
     def __str__(self) -> str: ...