stdlib: fix many attributes which are read-only at runtime but read-write in the stub (#7395)

Author: AlexWaygood

stdlib/email/_header_value_parser.pyi

@@ -181,10 +181,14 @@ class InvalidMailbox(TokenList):
     token_type: str
     @property
     def display_name(self) -> None: ...
-    local_part: None
-    domain: None
-    route: None
-    addr_spec: None
+    @property
+    def local_part(self) -> None: ...
+    @property
+    def domain(self) -> None: ...
+    @property
+    def route(self) -> None: ...
+    @property
+    def addr_spec(self) -> None: ...
 
 class Domain(TokenList):
     token_type: str

stdlib/hmac.pyi

@@ -26,7 +26,8 @@ else:
 class HMAC:
     digest_size: int
     block_size: int
-    name: str
+    @property
+    def name(self) -> str: ...
     def __init__(self, key: bytes, msg: ReadableBuffer | None = ..., digestmod: _DigestMod = ...) -> None: ...
     def update(self, msg: ReadableBuffer) -> None: ...
     def digest(self) -> bytes: ...

stdlib/http/cookies.pyi

@@ -21,9 +21,12 @@ def _unquote(str: str) -> str: ...
 class CookieError(Exception): ...
 
 class Morsel(dict[str, Any], Generic[_T]):
-    value: str
-    coded_value: _T
-    key: str
+    @property
+    def value(self) -> str: ...
+    @property
+    def coded_value(self) -> _T: ...
+    @property
+    def key(self) -> str: ...
     def __init__(self) -> None: ...
     if sys.version_info >= (3, 7):
         def set(self, key: str, val: str, coded_val: _T) -> None: ...

stdlib/importlib/machinery.pyi

@@ -22,7 +22,8 @@ class ModuleSpec:
     submodule_search_locations: list[str] | None
     loader_state: Any
     cached: str | None
-    parent: str | None
+    @property
+    def parent(self) -> str | None: ...
     has_location: bool
     def __eq__(self, other: object) -> bool: ...
 

stdlib/importlib/metadata/__init__.pyi

@@ -42,7 +42,9 @@ if sys.version_info >= (3, 10):
     from importlib.metadata._meta import PackageMetadata as PackageMetadata
     def packages_distributions() -> Mapping[str, list[str]]: ...
 
-class PackageNotFoundError(ModuleNotFoundError): ...
+class PackageNotFoundError(ModuleNotFoundError):
+    @property
+    def name(self) -> str: ...  # type: ignore[override]
 
 class _EntryPointBase(NamedTuple):
     name: str

stdlib/inspect.pyi

@@ -357,9 +357,12 @@ class Parameter:
 
 class BoundArguments:
     arguments: OrderedDict[str, Any]
-    args: tuple[Any, ...]
-    kwargs: dict[str, Any]
-    signature: Signature
+    @property
+    def args(self) -> tuple[Any, ...]: ...
+    @property
+    def kwargs(self) -> dict[str, Any]: ...
+    @property
+    def signature(self) -> Signature: ...
     def __init__(self, signature: Signature, arguments: OrderedDict[str, Any]) -> None: ...
     def apply_defaults(self) -> None: ...
     def __eq__(self, other: object) -> bool: ...

stdlib/multiprocessing/dummy/__init__.pyi

@@ -3,6 +3,7 @@ import threading
 import weakref
 from queue import Queue as Queue
 from typing import Any, Callable, Iterable, Mapping, Sequence
+from typing_extensions import Literal
 
 from .connection import Pipe as Pipe
 
@@ -39,7 +40,8 @@ class DummyProcess(threading.Thread):
     _parent: threading.Thread
     _pid: None
     _start_called: int
-    exitcode: int | None
+    @property
+    def exitcode(self) -> Literal[0] | None: ...
     def __init__(
         self,
         group: Any = ...,

stdlib/pathlib.pyi

@@ -20,14 +20,22 @@ if sys.version_info >= (3, 9):
 __all__ = ["PurePath", "PurePosixPath", "PureWindowsPath", "Path", "PosixPath", "WindowsPath"]
 
 class PurePath(PathLike[str]):
-    parts: tuple[str, ...]
-    drive: str
-    root: str
-    anchor: str
-    name: str
-    suffix: str
-    suffixes: list[str]
-    stem: str
+    @property
+    def parts(self) -> tuple[str, ...]: ...
+    @property
+    def drive(self) -> str: ...
+    @property
+    def root(self) -> str: ...
+    @property
+    def anchor(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def suffix(self) -> str: ...
+    @property
+    def suffixes(self) -> list[str]: ...
+    @property
+    def stem(self) -> str: ...
     def __new__(cls: type[Self], *args: StrPath) -> Self: ...
     def __hash__(self) -> int: ...
     def __eq__(self, other: object) -> bool: ...

stdlib/pydoc.pyi

@@ -200,8 +200,10 @@ class Helper:
     symbols: dict[str, str]
     topics: dict[str, str | tuple[str, ...]]
     def __init__(self, input: IO[str] | None = ..., output: IO[str] | None = ...) -> None: ...
-    input: IO[str]
-    output: IO[str]
+    @property
+    def input(self) -> IO[str]: ...
+    @property
+    def output(self) -> IO[str]: ...
     def __call__(self, request: str | Helper | object = ...) -> None: ...
     def interact(self) -> None: ...
     def getline(self, prompt: str) -> str: ...

stdlib/shlex.pyi

@@ -29,7 +29,11 @@ class shlex(Iterable[str]):
     lineno: int
     token: str
     eof: str
-    punctuation_chars: str
+    if sys.version_info >= (3, 7):
+        @property
+        def punctuation_chars(self) -> str: ...
+    else:
+        punctuation_chars: str
     def __init__(
         self,
         instream: str | TextIO | None = ...,