Sync typeshed (#18114)

 Source commit: python/typeshed@3d853d5

Author: github-actions[bot]

mypy/typeshed/stdlib/_frozen_importlib_external.pyi

@@ -107,9 +107,9 @@ class FileLoader:
  def get_filename(self, name: str | None = None) -> str: ...
  def load_module(self, name: str | None = None) -> types.ModuleType: ...
  if sys.version_info >= (3, 10):
- def get_resource_reader(self, module: types.ModuleType) -> importlib.readers.FileReader: ...
+ def get_resource_reader(self, name: str | None = None) -> importlib.readers.FileReader: ...
  else:
- def get_resource_reader(self, module: types.ModuleType) -> Self | None: ...
+ def get_resource_reader(self, name: str | None = None) -> Self | None: ...
  def open_resource(self, resource: str) -> _io.FileIO: ...
  def resource_path(self, resource: str) -> str: ...
  def is_resource(self, name: str) -> bool: ...

mypy/typeshed/stdlib/_io.pyi

@@ -33,10 +33,10 @@ class _IOBase:
  def readable(self) -> bool: ...
  read: Callable[..., Any]
  def readlines(self, hint: int = -1, /) -> list[bytes]: ...
- def seek(self, offset: int, whence: int = ..., /) -> int: ...
+ def seek(self, offset: int, whence: int = 0, /) -> int: ...
  def seekable(self) -> bool: ...
  def tell(self) -> int: ...
- def truncate(self, size: int | None = ..., /) -> int: ...
+ def truncate(self, size: int | None = None, /) -> int: ...
  def writable(self) -> bool: ...
  write: Callable[..., Any]
  def writelines(self, lines: Iterable[ReadableBuffer], /) -> None: ...
@@ -59,8 +59,8 @@ class _BufferedIOBase(_IOBase):
  def readinto(self, buffer: WriteableBuffer, /) -> int: ...
  def write(self, buffer: ReadableBuffer, /) -> int: ...
  def readinto1(self, buffer: WriteableBuffer, /) -> int: ...
- def read(self, size: int | None = ..., /) -> bytes: ...
- def read1(self, size: int = ..., /) -> bytes: ...
+ def read(self, size: int | None = -1, /) -> bytes: ...
+ def read1(self, size: int = -1, /) -> bytes: ...
 
 class FileIO(RawIOBase, _RawIOBase, BinaryIO): # type: ignore[misc] # incompatible definitions of writelines in the base classes
  mode: str
@@ -69,30 +69,38 @@ class FileIO(RawIOBase, _RawIOBase, BinaryIO): # type: ignore[misc] # incompat
  # "name" is a str. In the future, making FileIO generic might help.
  name: Any
  def __init__(
- self, file: FileDescriptorOrPath, mode: str = ..., closefd: bool = ..., opener: _Opener | None = ...
+ self, file: FileDescriptorOrPath, mode: str = "r", closefd: bool = True, opener: _Opener | None = None
  ) -> None: ...
  @property
  def closefd(self) -> bool: ...
+ def seek(self, pos: int, whence: int = 0, /) -> int: ...
+ def read(self, size: int | None = -1, /) -> bytes | MaybeNone: ...
 
 class BytesIO(BufferedIOBase, _BufferedIOBase, BinaryIO): # type: ignore[misc] # incompatible definitions of methods in the base classes
- def __init__(self, initial_bytes: ReadableBuffer = ...) -> None: ...
+ def __init__(self, initial_bytes: ReadableBuffer = b"") -> None: ...
  # BytesIO does not contain a "name" field. This workaround is necessary
  # to allow BytesIO sub-classes to add this field, as it is defined
  # as a read-only property on IO[].
  name: Any
  def getvalue(self) -> bytes: ...
  def getbuffer(self) -> memoryview: ...
  def read1(self, size: int | None = -1, /) -> bytes: ...
+ def readlines(self, size: int | None = None, /) -> list[bytes]: ...
+ def seek(self, pos: int, whence: int = 0, /) -> int: ...
 
 class BufferedReader(BufferedIOBase, _BufferedIOBase, BinaryIO): # type: ignore[misc] # incompatible definitions of methods in the base classes
  raw: RawIOBase
  def __init__(self, raw: RawIOBase, buffer_size: int = 8192) -> None: ...
  def peek(self, size: int = 0, /) -> bytes: ...
+ def seek(self, target: int, whence: int = 0, /) -> int: ...
+ def truncate(self, pos: int | None = None, /) -> int: ...
 
 class BufferedWriter(BufferedIOBase, _BufferedIOBase, BinaryIO): # type: ignore[misc] # incompatible definitions of writelines in the base classes
  raw: RawIOBase
  def __init__(self, raw: RawIOBase, buffer_size: int = 8192) -> None: ...
  def write(self, buffer: ReadableBuffer, /) -> int: ...
+ def seek(self, target: int, whence: int = 0, /) -> int: ...
+ def truncate(self, pos: int | None = None, /) -> int: ...
 
 class BufferedRandom(BufferedIOBase, _BufferedIOBase, BinaryIO): # type: ignore[misc] # incompatible definitions of methods in the base classes
  mode: str
@@ -101,10 +109,11 @@ class BufferedRandom(BufferedIOBase, _BufferedIOBase, BinaryIO): # type: ignore
  def __init__(self, raw: RawIOBase, buffer_size: int = 8192) -> None: ...
  def seek(self, target: int, whence: int = 0, /) -> int: ... # stubtest needs this
  def peek(self, size: int = 0, /) -> bytes: ...
+ def truncate(self, pos: int | None = None, /) -> int: ...
 
 class BufferedRWPair(BufferedIOBase, _BufferedIOBase):
  def __init__(self, reader: RawIOBase, writer: RawIOBase, buffer_size: int = 8192) -> None: ...
- def peek(self, size: int = ..., /) -> bytes: ...
+ def peek(self, size: int = 0, /) -> bytes: ...
 
 class _TextIOBase(_IOBase):
  encoding: str
@@ -115,9 +124,9 @@ class _TextIOBase(_IOBase):
  def detach(self) -> BinaryIO: ...
  def write(self, s: str, /) -> int: ...
  def writelines(self, lines: Iterable[str], /) -> None: ... # type: ignore[override]
- def readline(self, size: int = ..., /) -> str: ... # type: ignore[override]
+ def readline(self, size: int = -1, /) -> str: ... # type: ignore[override]
  def readlines(self, hint: int = -1, /) -> list[str]: ... # type: ignore[override]
- def read(self, size: int | None = ..., /) -> str: ...
+ def read(self, size: int | None = -1, /) -> str: ...
 
 @type_check_only
 class _WrappedBuffer(Protocol):
@@ -177,19 +186,22 @@ class TextIOWrapper(TextIOBase, _TextIOBase, TextIO, Generic[_BufferT_co]): # t
  # TextIOWrapper's version of seek only supports a limited subset of
  # operations.
  def seek(self, cookie: int, whence: int = 0, /) -> int: ...
+ def truncate(self, pos: int | None = None, /) -> int: ...
 
 class StringIO(TextIOBase, _TextIOBase, TextIO): # type: ignore[misc] # incompatible definitions of write in the base classes
- def __init__(self, initial_value: str | None = ..., newline: str | None = ...) -> None: ...
+ def __init__(self, initial_value: str | None = "", newline: str | None = "\n") -> None: ...
  # StringIO does not contain a "name" field. This workaround is necessary
  # to allow StringIO sub-classes to add this field, as it is defined
  # as a read-only property on IO[].
  name: Any
  def getvalue(self) -> str: ...
  @property
  def line_buffering(self) -> bool: ...
+ def seek(self, pos: int, whence: int = 0, /) -> int: ...
+ def truncate(self, pos: int | None = None, /) -> int: ...
 
 class IncrementalNewlineDecoder:
- def __init__(self, decoder: codecs.IncrementalDecoder | None, translate: bool, errors: str = ...) -> None: ...
+ def __init__(self, decoder: codecs.IncrementalDecoder | None, translate: bool, errors: str = "strict") -> None: ...
  def decode(self, input: ReadableBuffer | str, final: bool = False) -> str: ...
  @property
  def newlines(self) -> str | tuple[str, ...] | None: ...

mypy/typeshed/stdlib/_threading_local.pyi

@@ -1,5 +1,5 @@
 from typing import Any
-from typing_extensions import TypeAlias
+from typing_extensions import Self, TypeAlias
 from weakref import ReferenceType
 
 __all__ = ["local"]
@@ -12,6 +12,7 @@ class _localimpl:
  def create_dict(self) -> _LocalDict: ...
 
 class local:
+ def __new__(cls, /, *args: Any, **kw: Any) -> Self: ...
  def __getattribute__(self, name: str) -> Any: ...
  def __setattr__(self, name: str, value: Any) -> None: ...
  def __delattr__(self, name: str) -> None: ...

mypy/typeshed/stdlib/distutils/ccompiler.pyi

@@ -1,5 +1,5 @@
 from _typeshed import BytesPath, StrPath, Unused
-from collections.abc import Callable, Iterable
+from collections.abc import Callable, Iterable, Sequence
 from distutils.file_util import _BytesPathT, _StrPathT
 from typing import Literal, overload
 from typing_extensions import TypeAlias, TypeVarTuple, Unpack
@@ -63,7 +63,7 @@ class CCompiler:
  def set_executables(self, **args: str) -> None: ...
  def compile(
  self,
- sources: list[str],
+ sources: Sequence[StrPath],
  output_dir: str | None = None,
  macros: list[_Macro] | None = None,
  include_dirs: list[str] | None = None,

mypy/typeshed/stdlib/getopt.pyi

@@ -1,7 +1,11 @@
+from collections.abc import Iterable
+
 __all__ = ["GetoptError", "error", "getopt", "gnu_getopt"]
 
-def getopt(args: list[str], shortopts: str, longopts: list[str] = []) -> tuple[list[tuple[str, str]], list[str]]: ...
-def gnu_getopt(args: list[str], shortopts: str, longopts: list[str] = []) -> tuple[list[tuple[str, str]], list[str]]: ...
+def getopt(args: list[str], shortopts: str, longopts: Iterable[str] | str = []) -> tuple[list[tuple[str, str]], list[str]]: ...
+def gnu_getopt(
+ args: list[str], shortopts: str, longopts: Iterable[str] | str = []
+) -> tuple[list[tuple[str, str]], list[str]]: ...
 
 class GetoptError(Exception):
  msg: str

mypy/typeshed/stdlib/ipaddress.pyi

@@ -128,19 +128,6 @@ class _BaseNetwork(_IPAddressBase, Generic[_A]):
  @property
  def hostmask(self) -> _A: ...
 
-class _BaseInterface(_BaseAddress, Generic[_A, _N]):
- hostmask: _A
- netmask: _A
- network: _N
- @property
- def ip(self) -> _A: ...
- @property
- def with_hostmask(self) -> str: ...
- @property
- def with_netmask(self) -> str: ...
- @property
- def with_prefixlen(self) -> str: ...
-
 class _BaseV4:
  @property
  def version(self) -> Literal[4]: ...
@@ -154,9 +141,21 @@ class IPv4Address(_BaseV4, _BaseAddress):
 
 class IPv4Network(_BaseV4, _BaseNetwork[IPv4Address]): ...
 
-class IPv4Interface(IPv4Address, _BaseInterface[IPv4Address, IPv4Network]):
+class IPv4Interface(IPv4Address):
+ netmask: IPv4Address
+ network: IPv4Network
  def __eq__(self, other: object) -> bool: ...
  def __hash__(self) -> int: ...
+ @property
+ def hostmask(self) -> IPv4Address: ...
+ @property
+ def ip(self) -> IPv4Address: ...
+ @property
+ def with_hostmask(self) -> str: ...
+ @property
+ def with_netmask(self) -> str: ...
+ @property
+ def with_prefixlen(self) -> str: ...
 
 class _BaseV6:
  @property
@@ -184,9 +183,21 @@ class IPv6Network(_BaseV6, _BaseNetwork[IPv6Address]):
  @property
  def is_site_local(self) -> bool: ...
 
-class IPv6Interface(IPv6Address, _BaseInterface[IPv6Address, IPv6Network]):
+class IPv6Interface(IPv6Address):
+ netmask: IPv6Address
+ network: IPv6Network
  def __eq__(self, other: object) -> bool: ...
  def __hash__(self) -> int: ...
+ @property
+ def hostmask(self) -> IPv6Address: ...
+ @property
+ def ip(self) -> IPv6Address: ...
+ @property
+ def with_hostmask(self) -> str: ...
+ @property
+ def with_netmask(self) -> str: ...
+ @property
+ def with_prefixlen(self) -> str: ...
 
 def v4_int_to_packed(address: int) -> bytes: ...
 def v6_int_to_packed(address: int) -> bytes: ...

mypy/typeshed/stdlib/multiprocessing/managers.pyi

@@ -10,6 +10,7 @@ from typing_extensions import Self, TypeAlias
 from .connection import Connection
 from .context import BaseContext
 from .shared_memory import _SLT, ShareableList as _ShareableList, SharedMemory as _SharedMemory
+from .util import Finalize as _Finalize
 
 __all__ = ["BaseManager", "SyncManager", "BaseProxy", "Token", "SharedMemoryManager"]
 
@@ -156,7 +157,7 @@ class BaseManager:
  def get_server(self) -> Server: ...
  def connect(self) -> None: ...
  def start(self, initializer: Callable[..., object] | None = None, initargs: Iterable[Any] = ()) -> None: ...
- def shutdown(self) -> None: ... # only available after start() was called
+ shutdown: _Finalize # only available after start() was called
  def join(self, timeout: float | None = None) -> None: ... # undocumented
  @property
  def address(self) -> Any: ...

mypy/typeshed/stdlib/multiprocessing/spawn.pyi

@@ -23,7 +23,7 @@ def get_command_line(**kwds: Any) -> list[str]: ...
 def spawn_main(pipe_handle: int, parent_pid: int | None = None, tracker_fd: int | None = None) -> None: ...
 
 # undocumented
-def _main(fd: int) -> Any: ...
+def _main(fd: int, parent_sentinel: int) -> int: ...
 def get_preparation_data(name: str) -> dict[str, Any]: ...
 
 old_main_modules: list[ModuleType]

mypy/typeshed/stdlib/tarfile.pyi

@@ -1,7 +1,7 @@
 import bz2
 import io
 import sys
-from _typeshed import StrOrBytesPath, StrPath
+from _typeshed import StrOrBytesPath, StrPath, SupportsRead
 from builtins import list as _list # aliases to avoid name clashes with fields named "type" or "list"
 from collections.abc import Callable, Iterable, Iterator, Mapping
 from gzip import _ReadableFileobj as _GzipReadableFileobj, _WritableFileobj as _GzipWritableFileobj
@@ -481,7 +481,7 @@ class TarFile:
  *,
  filter: Callable[[TarInfo], TarInfo | None] | None = None,
  ) -> None: ...
- def addfile(self, tarinfo: TarInfo, fileobj: IO[bytes] | None = None) -> None: ...
+ def addfile(self, tarinfo: TarInfo, fileobj: SupportsRead[bytes] | None = None) -> None: ...
  def gettarinfo(
  self, name: StrOrBytesPath | None = None, arcname: str | None = None, fileobj: IO[bytes] | None = None
  ) -> TarInfo: ...