Sync typeshed (#20415)

Source commit:

python/typeshed@2f3c3b7

---------

Co-authored-by: Shantanu <[email protected]>
Co-authored-by: hauntsaninja <[email protected]>

Author: github-actions[bot]

mypy/typeshed/stdlib/_ctypes.pyi

@@ -5,7 +5,7 @@ from abc import abstractmethod
 from collections.abc import Callable, Iterable, Iterator, Mapping, Sequence
 from ctypes import CDLL, ArgumentError as ArgumentError, c_void_p
 from types import GenericAlias
-from typing import Any, ClassVar, Final, Generic, TypeVar, final, overload, type_check_only
+from typing import Any, ClassVar, Final, Generic, Literal, TypeVar, final, overload, type_check_only
 from typing_extensions import Self, TypeAlias
 
 _T = TypeVar("_T")
@@ -266,6 +266,10 @@ class Structure(_CData, metaclass=_PyCStructType):
     if sys.version_info >= (3, 13):
         _align_: ClassVar[int]
 
+    if sys.version_info >= (3, 14):
+        # _layout_ can be defined by the user, but is not always present.
+        _layout_: ClassVar[Literal["ms", "gcc-sysv"]]
+
     def __init__(self, *args: Any, **kw: Any) -> None: ...
     def __getattr__(self, name: str) -> Any: ...
     def __setattr__(self, name: str, value: Any) -> None: ...

mypy/typeshed/stdlib/_winapi.pyi

@@ -192,6 +192,9 @@ if sys.platform == "win32":
         template_file: int,
         /,
     ) -> int: ...
+    def CreateFileMapping(
+        file_handle: int, security_attributes: int, protect: int, max_size_high: int, max_size_low: int, name: str, /
+    ) -> int: ...
     def CreateJunction(src_path: str, dst_path: str, /) -> None: ...
     def CreateNamedPipe(
         name: str,
@@ -235,6 +238,9 @@ if sys.platform == "win32":
     def GetModuleFileName(module_handle: int, /) -> str: ...
     def GetStdHandle(std_handle: int, /) -> int: ...
     def GetVersion() -> int: ...
+    def MapViewOfFile(
+        file_map: int, desired_access: int, file_offset_high: int, file_offset_low: int, number_bytes: int, /
+    ) -> int: ...
     def OpenProcess(desired_access: int, inherit_handle: bool, process_id: int, /) -> int: ...
     def PeekNamedPipe(handle: int, size: int = 0, /) -> tuple[int, int] | tuple[bytes, int, int]: ...
     if sys.version_info >= (3, 10):
@@ -251,6 +257,7 @@ if sys.platform == "win32":
         named_pipe: int, mode: int | None, max_collection_count: int | None, collect_data_timeout: int | None, /
     ) -> None: ...
     def TerminateProcess(handle: int, exit_code: int, /) -> None: ...
+    def VirtualQuerySize(address: int, /) -> int: ...
     def WaitForMultipleObjects(handle_seq: Sequence[int], wait_flag: bool, milliseconds: int = 0xFFFFFFFF, /) -> int: ...
     def WaitForSingleObject(handle: int, milliseconds: int, /) -> int: ...
     def WaitNamedPipe(name: str, timeout: int, /) -> None: ...
@@ -281,6 +288,8 @@ if sys.platform == "win32":
         def ResetEvent(event: int) -> None: ...
         def SetEvent(event: int) -> None: ...
 
+    def OpenFileMapping(desired_access: int, inherit_handle: bool, name: str, /) -> int: ...
+
     if sys.version_info >= (3, 12):
         def CopyFile2(existing_file_name: str, new_file_name: str, flags: int, progress_routine: int | None = None) -> int: ...
         def NeedCurrentDirectoryForExePath(exe_name: str, /) -> bool: ...

mypy/typeshed/stdlib/_zstd.pyi

@@ -46,7 +46,10 @@ class ZstdCompressor:
     FLUSH_BLOCK: Final = 1
     FLUSH_FRAME: Final = 2
     def __new__(
-        cls, level: int | None = None, options: Mapping[int, int] | None = None, zstd_dict: ZstdDict | None = None
+        cls,
+        level: int | None = None,
+        options: Mapping[int, int] | None = None,
+        zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     ) -> Self: ...
     def compress(
         self, /, data: ReadableBuffer, mode: _ZstdCompressorContinue | _ZstdCompressorFlushBlock | _ZstdCompressorFlushFrame = 0
@@ -58,7 +61,9 @@ class ZstdCompressor:
 
 @final
 class ZstdDecompressor:
-    def __new__(cls, zstd_dict: ZstdDict | None = None, options: Mapping[int, int] | None = None) -> Self: ...
+    def __new__(
+        cls, zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None, options: Mapping[int, int] | None = None
+    ) -> Self: ...
     def decompress(self, /, data: ReadableBuffer, max_length: int = -1) -> bytes: ...
     @property
     def eof(self) -> bool: ...

mypy/typeshed/stdlib/argparse.pyi

@@ -251,7 +251,11 @@ class ArgumentParser(_AttributeHolder, _ActionsContainer):
     def _read_args_from_files(self, arg_strings: list[str]) -> list[str]: ...
     def _match_argument(self, action: Action, arg_strings_pattern: str) -> int: ...
     def _match_arguments_partial(self, actions: Sequence[Action], arg_strings_pattern: str) -> list[int]: ...
-    def _parse_optional(self, arg_string: str) -> tuple[Action | None, str, str | None] | None: ...
+    if sys.version_info >= (3, 12):
+        def _parse_optional(self, arg_string: str) -> list[tuple[Action | None, str, str | None, str | None]] | None: ...
+    else:
+        def _parse_optional(self, arg_string: str) -> tuple[Action | None, str, str | None] | None: ...
+
     def _get_option_tuples(self, option_string: str) -> list[tuple[Action, str, str | None]]: ...
     def _get_nargs_pattern(self, action: Action) -> str: ...
     def _get_values(self, action: Action, arg_strings: list[str]) -> Any: ...

mypy/typeshed/stdlib/builtins.pyi

@@ -633,8 +633,13 @@ class bytes(Sequence[int]):
     def translate(self, table: ReadableBuffer | None, /, delete: ReadableBuffer = b"") -> bytes: ...
     def upper(self) -> bytes: ...
     def zfill(self, width: SupportsIndex, /) -> bytes: ...
-    @classmethod
-    def fromhex(cls, string: str, /) -> Self: ...
+    if sys.version_info >= (3, 14):
+        @classmethod
+        def fromhex(cls, string: str | ReadableBuffer, /) -> Self: ...
+    else:
+        @classmethod
+        def fromhex(cls, string: str, /) -> Self: ...
+
     @staticmethod
     def maketrans(frm: ReadableBuffer, to: ReadableBuffer, /) -> bytes: ...
     def __len__(self) -> int: ...
@@ -738,8 +743,13 @@ class bytearray(MutableSequence[int]):
     def translate(self, table: ReadableBuffer | None, /, delete: bytes = b"") -> bytearray: ...
     def upper(self) -> bytearray: ...
     def zfill(self, width: SupportsIndex, /) -> bytearray: ...
-    @classmethod
-    def fromhex(cls, string: str, /) -> Self: ...
+    if sys.version_info >= (3, 14):
+        @classmethod
+        def fromhex(cls, string: str | ReadableBuffer, /) -> Self: ...
+    else:
+        @classmethod
+        def fromhex(cls, string: str, /) -> Self: ...
+
     @staticmethod
     def maketrans(frm: ReadableBuffer, to: ReadableBuffer, /) -> bytes: ...
     def __len__(self) -> int: ...
@@ -846,11 +856,15 @@ class memoryview(Sequence[_I]):
     def hex(self, sep: str | bytes = ..., bytes_per_sep: SupportsIndex = 1) -> str: ...
     def __buffer__(self, flags: int, /) -> memoryview: ...
     def __release_buffer__(self, buffer: memoryview, /) -> None: ...
+    if sys.version_info >= (3, 14):
+        def index(self, value: object, start: SupportsIndex = 0, stop: SupportsIndex = sys.maxsize, /) -> int: ...
+        def count(self, value: object, /) -> int: ...
+    else:
+        # These are inherited from the Sequence ABC, but don't actually exist on memoryview.
+        # See https://github.com/python/cpython/issues/125420
+        index: ClassVar[None]  # type: ignore[assignment]
+        count: ClassVar[None]  # type: ignore[assignment]
 
-    # These are inherited from the Sequence ABC, but don't actually exist on memoryview.
-    # See https://github.com/python/cpython/issues/125420
-    index: ClassVar[None]  # type: ignore[assignment]
-    count: ClassVar[None]  # type: ignore[assignment]
     if sys.version_info >= (3, 14):
         def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
 

mypy/typeshed/stdlib/compression/zstd/__init__.pyi

@@ -44,9 +44,14 @@ def get_frame_info(frame_buffer: ReadableBuffer) -> FrameInfo: ...
 def train_dict(samples: Iterable[ReadableBuffer], dict_size: int) -> ZstdDict: ...
 def finalize_dict(zstd_dict: ZstdDict, /, samples: Iterable[ReadableBuffer], dict_size: int, level: int) -> ZstdDict: ...
 def compress(
-    data: ReadableBuffer, level: int | None = None, options: Mapping[int, int] | None = None, zstd_dict: ZstdDict | None = None
+    data: ReadableBuffer,
+    level: int | None = None,
+    options: Mapping[int, int] | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
+) -> bytes: ...
+def decompress(
+    data: ReadableBuffer, zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None, options: Mapping[int, int] | None = None
 ) -> bytes: ...
-def decompress(data: ReadableBuffer, zstd_dict: ZstdDict | None = None, options: Mapping[int, int] | None = None) -> bytes: ...
 @final
 class CompressionParameter(enum.IntEnum):
     compression_level = _zstd.ZSTD_c_compressionLevel

mypy/typeshed/stdlib/compression/zstd/_zstdfile.pyi

@@ -36,7 +36,7 @@ class ZstdFile(_streams.BaseStream):
         *,
         level: None = None,
         options: Mapping[int, int] | None = None,
-        zstd_dict: ZstdDict | None = None,
+        zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     ) -> None: ...
     @overload
     def __init__(
@@ -47,7 +47,7 @@ class ZstdFile(_streams.BaseStream):
         *,
         level: int | None = None,
         options: Mapping[int, int] | None = None,
-        zstd_dict: ZstdDict | None = None,
+        zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     ) -> None: ...
     def write(self, data: ReadableBuffer, /) -> int: ...
     def flush(self, mode: _ZstdCompressorFlushBlock | _ZstdCompressorFlushFrame = 1) -> bytes: ...  # type: ignore[override]
@@ -71,7 +71,7 @@ def open(
     *,
     level: None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,
@@ -84,7 +84,7 @@ def open(
     *,
     level: int | None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,
@@ -97,7 +97,7 @@ def open(
     *,
     level: None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,
@@ -110,7 +110,7 @@ def open(
     *,
     level: int | None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,

mypy/typeshed/stdlib/heapq.pyi

@@ -1,10 +1,15 @@
+import sys
 from _heapq import *
 from _typeshed import SupportsRichComparison
 from collections.abc import Callable, Generator, Iterable
 from typing import Any, Final, TypeVar
 
 __all__ = ["heappush", "heappop", "heapify", "heapreplace", "merge", "nlargest", "nsmallest", "heappushpop"]
 
+if sys.version_info >= (3, 14):
+    # Added to __all__ in 3.14.1
+    __all__ += ["heapify_max", "heappop_max", "heappush_max", "heappushpop_max", "heapreplace_max"]
+
 _S = TypeVar("_S")
 
 __about__: Final[str]

mypy/typeshed/stdlib/importlib/readers.pyi

@@ -52,9 +52,9 @@ if sys.version_info >= (3, 10):
         def is_file(self) -> Literal[False]: ...
 
         if sys.version_info >= (3, 12):
-            def joinpath(self, *descendants: str) -> abc.Traversable: ...
+            def joinpath(self, *descendants: StrPath) -> abc.Traversable: ...
         elif sys.version_info >= (3, 11):
-            def joinpath(self, child: str) -> abc.Traversable: ...  # type: ignore[override]
+            def joinpath(self, child: StrPath) -> abc.Traversable: ...  # type: ignore[override]
         else:
             def joinpath(self, child: str) -> abc.Traversable: ...
 

mypy/typeshed/stdlib/importlib/resources/abc.pyi

@@ -1,4 +1,5 @@
 import sys
+from _typeshed import StrPath
 from abc import ABCMeta, abstractmethod
 from collections.abc import Iterator
 from io import BufferedReader
@@ -24,7 +25,7 @@ if sys.version_info >= (3, 11):
         @abstractmethod
         def iterdir(self) -> Iterator[Traversable]: ...
         @abstractmethod
-        def joinpath(self, *descendants: str) -> Traversable: ...
+        def joinpath(self, *descendants: StrPath) -> Traversable: ...
 
         # The documentation and runtime protocol allows *args, **kwargs arguments,
         # but this would mean that all implementers would have to support them,
@@ -38,7 +39,7 @@ if sys.version_info >= (3, 11):
         @property
         @abstractmethod
         def name(self) -> str: ...
-        def __truediv__(self, child: str, /) -> Traversable: ...
+        def __truediv__(self, child: StrPath, /) -> Traversable: ...
         @abstractmethod
         def read_bytes(self) -> bytes: ...
         @abstractmethod