Add more Python 3.15 stdlib updates

Author: JelleZijlstra

stdlib/@tests/stubtest_allowlists/py315.txt

@@ -12,8 +12,6 @@ _frozen_importlib_external.SourceFileLoader.source_to_code
 _frozen_importlib_external.SourceLoader.source_to_code
 _frozen_importlib_external._LoaderBasics.load_module
 _frozen_importlib_external.cache_from_source
-_interpqueues.create
-_interpqueues.put
 _pyrepl.base_eventqueue
 _pyrepl.commands
 _pyrepl.completing_reader
@@ -62,8 +60,6 @@ codecs.namereplace_errors
 codecs.replace_errors
 codecs.strict_errors
 codecs.xmlcharrefreplace_errors
-collections.Counter.__ixor__
-collections.Counter.__xor__
 concurrent.interpreters._crossinterp.UNBOUND_ERROR
 concurrent.interpreters._crossinterp.UNBOUND_REMOVE
 concurrent.interpreters._crossinterp.UnboundItem.singleton
@@ -137,7 +133,6 @@ math.issubnormal
 math.signbit
 multiprocessing.context.BaseContext.set_forkserver_preload
 multiprocessing.forkserver.ForkServer.set_forkserver_preload
-multiprocessing.forkserver.main
 multiprocessing.managers.BaseListProxy.clear
 multiprocessing.managers.BaseListProxy.copy
 multiprocessing.managers._BaseDictProxy.__iter__
@@ -209,19 +204,8 @@ sre_parse
 symtable.symtable
 sys.__jit
 sys._monitoring
-sys.abi_info
-sys.get_lazy_imports
-sys.get_lazy_imports_filter
 sys.last_exc
-sys.lazy_modules
-sys.set_lazy_imports
-sys.set_lazy_imports_filter
 threading.Condition.locked
-threading.__all__
-threading.concurrent_tee
-threading.serialize_iterator
-threading.synchronized_iterator
-timeit.Timer.autorange
 tkinter.Grid.content
 tkinter.Grid.grid_content
 tkinter.Image.__iter__
@@ -238,20 +222,13 @@ tkinter.Text.search
 tkinter.Text.search_all
 tkinter.font.Font.__iter__
 tkinter.simpledialog.__all__
-types.AsyncGeneratorType.ag_state
-types.CodeType.co_lnotab
-types.CoroutineType.cr_state
-types.FrameLocalsProxyType
-types.GeneratorType.gi_state
-types.LazyImportType
 types.MappingProxyType.get
 types.SimpleNamespace.__delattr__
 types.SimpleNamespace.__setattr__
 types.UnionType.__class_getitem__
 types.UnionType.__mro_entries__
 types.UnionType.__name__
 types.UnionType.__qualname__
-types.__all__
 typing.LiteralString
 typing.NewType.__mro_entries__
 typing.ParamSpec.__mro_entries__
@@ -274,6 +251,4 @@ urllib.parse.urlsplit
 urllib.parse.urlunparse
 urllib.parse.urlunsplit
 xml.etree.ElementTree.__all__
-xml.is_valid_name
-xml.utils
 zipimport.zipimporter.load_module

stdlib/_interpqueues.pyi

@@ -1,3 +1,4 @@
+import sys
 from typing import Any, Literal, SupportsIndex, TypeAlias
 
 _UnboundOp: TypeAlias = Literal[1, 2, 3]
@@ -6,13 +7,25 @@ class QueueError(RuntimeError): ...
 class QueueNotFoundError(QueueError): ...
 
 def bind(qid: SupportsIndex) -> None: ...
-def create(maxsize: SupportsIndex, fmt: SupportsIndex, unboundop: _UnboundOp) -> int: ...
+
+if sys.version_info >= (3, 15):
+    def create(maxsize: SupportsIndex, unboundop: SupportsIndex = -1, fallback: SupportsIndex = -1) -> int: ...
+
+else:
+    def create(maxsize: SupportsIndex, fmt: SupportsIndex, unboundop: _UnboundOp) -> int: ...
+
 def destroy(qid: SupportsIndex) -> None: ...
 def get(qid: SupportsIndex) -> tuple[Any, int, _UnboundOp | None]: ...
 def get_count(qid: SupportsIndex) -> int: ...
 def get_maxsize(qid: SupportsIndex) -> int: ...
 def get_queue_defaults(qid: SupportsIndex) -> tuple[int, _UnboundOp]: ...
 def is_full(qid: SupportsIndex) -> bool: ...
 def list_all() -> list[tuple[int, int, _UnboundOp]]: ...
-def put(qid: SupportsIndex, obj: Any, fmt: SupportsIndex, unboundop: _UnboundOp) -> None: ...
+
+if sys.version_info >= (3, 15):
+    def put(qid: SupportsIndex, obj: Any, unboundop: SupportsIndex = -1, fallback: SupportsIndex = -1) -> None: ...
+
+else:
+    def put(qid: SupportsIndex, obj: Any, fmt: SupportsIndex, unboundop: _UnboundOp) -> None: ...
+
 def release(qid: SupportsIndex) -> None: ...

stdlib/collections/__init__.pyi

@@ -315,13 +315,18 @@ class Counter(dict[_T, int], Generic[_T]):
     def __sub__(self, other: Counter[_T]) -> Counter[_T]: ...
     def __and__(self, other: Counter[_T]) -> Counter[_T]: ...
     def __or__(self, other: Counter[_S]) -> Counter[_T | _S]: ...  # type: ignore[override]
+    if sys.version_info >= (3, 15):
+        def __xor__(self, other: Counter[_S]) -> Counter[_T | _S]: ...  # type: ignore[override]
+
     def __pos__(self) -> Counter[_T]: ...
     def __neg__(self) -> Counter[_T]: ...
     # several type: ignores because __iadd__ is supposedly incompatible with __add__, etc.
     def __iadd__(self, other: SupportsItems[_T, int]) -> Self: ...  # type: ignore[misc]
     def __isub__(self, other: SupportsItems[_T, int]) -> Self: ...
     def __iand__(self, other: SupportsItems[_T, int]) -> Self: ...
     def __ior__(self, other: SupportsItems[_T, int]) -> Self: ...  # type: ignore[override,misc]
+    if sys.version_info >= (3, 15):
+        def __ixor__(self, other: Counter[_T]) -> Self: ...  # type: ignore[misc]
 
 # The pure-Python implementations of the "views" classes
 # These are exposed at runtime in `collections/__init__.py`

stdlib/multiprocessing/forkserver.pyi

@@ -15,7 +15,20 @@ class ForkServer:
     def connect_to_new_process(self, fds: Sequence[int]) -> tuple[int, int]: ...
     def ensure_running(self) -> None: ...
 
-if sys.version_info >= (3, 14):
+if sys.version_info >= (3, 15):
+    def main(
+        listener_fd: int | None,
+        alive_r: FileDescriptorLike,
+        preload: Sequence[str],
+        main_path: str | None = None,
+        sys_path: list[str] | None = None,
+        *,
+        sys_argv: list[str] | None = None,
+        authkey_r: int | None = None,
+        on_error: str = "ignore",
+    ) -> None: ...
+
+elif sys.version_info >= (3, 14):
     # `sys_argv` parameter added in Python 3.14.3
     def main(
         listener_fd: int | None,

stdlib/sys/__init__.pyi

@@ -4,18 +4,30 @@ from _typeshed.importlib import MetaPathFinderProtocol, PathEntryFinderProtocol
 from builtins import object as _object
 from collections.abc import AsyncGenerator, Callable, Sequence
 from io import TextIOWrapper
-from types import FrameType, ModuleType, TracebackType
+from types import FrameType, ModuleType, SimpleNamespace, TracebackType
 from typing import Any, Final, Literal, NoReturn, Protocol, TextIO, TypeAlias, TypeVar, final, overload, type_check_only
 from typing_extensions import LiteralString, deprecated
 
 _T = TypeVar("_T")
+_LazyImportMode: TypeAlias = Literal["normal", "all", "none"]
+_LazyImportFilter: TypeAlias = Callable[[str, str, tuple[str, ...] | None], bool]
 
 # see https://github.com/python/typeshed/issues/8513#issue-1333671093 for the rationale behind this alias
 _ExitCode: TypeAlias = str | int | None
 
+if sys.version_info >= (3, 15):
+    @type_check_only
+    class _AbiInfo(SimpleNamespace):
+        pointer_bits: int
+        free_threaded: bool
+        debug: bool
+        byteorder: Literal["little", "big"]
+
 # ----- sys variables -----
 if sys.platform != "win32":
     abiflags: str
+if sys.version_info >= (3, 15):
+    abi_info: _AbiInfo
 argv: list[str]
 base_exec_prefix: str
 base_prefix: str
@@ -40,6 +52,8 @@ maxsize: int
 maxunicode: int
 meta_path: list[MetaPathFinderProtocol]
 modules: dict[str, ModuleType]
+if sys.version_info >= (3, 15):
+    lazy_modules: dict[str, set[str]]
 orig_argv: list[str]
 path: list[str]
 path_hooks: list[Callable[[str], PathEntryFinderProtocol]]
@@ -376,6 +390,11 @@ if sys.platform != "win32":
 
 def getfilesystemencoding() -> LiteralString: ...
 def getfilesystemencodeerrors() -> LiteralString: ...
+
+if sys.version_info >= (3, 15):
+    def get_lazy_imports() -> _LazyImportMode: ...
+    def get_lazy_imports_filter() -> _LazyImportFilter | None: ...
+
 def getrefcount(object: Any, /) -> int: ...
 def getrecursionlimit() -> int: ...
 def getsizeof(obj: object, default: int = ...) -> int: ...
@@ -486,6 +505,10 @@ def set_coroutine_origin_tracking_depth(depth: int) -> None: ...
 def set_int_max_str_digits(maxdigits: int) -> None: ...
 def get_int_max_str_digits() -> int: ...
 
+if sys.version_info >= (3, 15):
+    def set_lazy_imports(mode: _LazyImportMode) -> None: ...
+    def set_lazy_imports_filter(filter: _LazyImportFilter | None) -> None: ...
+
 if sys.version_info >= (3, 12):
     if sys.version_info >= (3, 13):
         def getunicodeinternedsize(*, _only_immortal: bool = False) -> int: ...

stdlib/tarfile.pyi

@@ -132,9 +132,8 @@ class TarFile:
     errorlevel: Literal[0, 1, 2]
     offset: int  # undocumented
     extraction_filter: _FilterFunction | None
-    if sys.version_info >= (3, 13):
-        stream: bool
     if sys.version_info >= (3, 15):
+        stream: bool
         def __init__(
             self,
             name: StrOrBytesPath | None = None,
@@ -154,6 +153,7 @@ class TarFile:
             mtime: float | None = None,
         ) -> None: ...
     elif sys.version_info >= (3, 13):
+        stream: bool
         def __init__(
             self,
             name: StrOrBytesPath | None = None,

stdlib/threading.pyi

@@ -2,11 +2,11 @@ import _thread
 import sys
 from _thread import _ExceptHookArgs, get_native_id as get_native_id
 from _typeshed import ProfileFunction, TraceFunction
-from collections.abc import Callable, Iterable, Mapping
+from collections.abc import Callable, Iterable, Iterator, Mapping
 from contextvars import Context
 from types import TracebackType
 from typing import Any, Final, TypeVar, final
-from typing_extensions import deprecated
+from typing_extensions import Self, deprecated
 
 _T = TypeVar("_T")
 
@@ -42,6 +42,9 @@ __all__ = [
 if sys.version_info >= (3, 12):
     __all__ += ["setprofile_all_threads", "settrace_all_threads"]
 
+if sys.version_info >= (3, 15):
+    __all__ += ["concurrent_tee", "serialize_iterator", "synchronized_iterator"]
+
 _profile_hook: ProfileFunction | None
 
 def active_count() -> int: ...
@@ -62,6 +65,20 @@ if sys.version_info >= (3, 12):
 
 def gettrace() -> TraceFunction | None: ...
 def getprofile() -> ProfileFunction | None: ...
+
+if sys.version_info >= (3, 15):
+    @final
+    class serialize_iterator(Iterator[_T]):
+        def __init__(self, iterable: Iterable[_T]) -> None: ...
+        def __iter__(self) -> Self: ...
+        def __next__(self) -> _T: ...
+        def send(self, value: Any, /) -> _T: ...
+        def throw(self, typ: type[BaseException], val: BaseException | object = ..., tb: TracebackType | None = ...) -> _T: ...
+        def close(self) -> None: ...
+
+    def synchronized_iterator(func: Callable[..., Iterable[_T]]) -> Callable[..., Iterator[_T]]: ...
+    def concurrent_tee(iterable: Iterable[_T], n: int = 2) -> tuple[Iterator[_T], ...]: ...
+
 def stack_size(size: int = 0, /) -> int: ...
 
 TIMEOUT_MAX: Final[float]

stdlib/timeit.pyi

@@ -1,3 +1,4 @@
+import sys
 import time
 from collections.abc import Callable, Sequence
 from typing import IO, Any, TypeAlias
@@ -20,7 +21,12 @@ class Timer:
     def print_exc(self, file: IO[str] | None = None) -> None: ...
     def timeit(self, number: int = 1000000) -> float: ...
     def repeat(self, repeat: int = 5, number: int = 1000000) -> list[float]: ...
-    def autorange(self, callback: Callable[[int, float], object] | None = None) -> tuple[int, float]: ...
+    if sys.version_info >= (3, 15):
+        def autorange(
+            self, callback: Callable[[int, float], object] | None = None, target_time: float = 0.2
+        ) -> tuple[int, float]: ...
+    else:
+        def autorange(self, callback: Callable[[int, float], object] | None = None) -> tuple[int, float]: ...
 
 def timeit(
     stmt: _Stmt = "pass",