Merge branch 'main' into patch-6

Author: jonathandung

stdlib/@tests/stubtest_allowlists/linux-py315.txt

@@ -1,61 +1,11 @@
-# ============================================
-# TODO: Allowlist entries that should be fixed
-# ============================================
+# =============================================================
+# Allowlist entries that cannot or should not be fixed; >= 3.15
+# =============================================================
 
 # GitHub Actions' Python 3.15 Linux build currently lacks _decimal, so
 # decimal falls back to _pydecimal with different runtime signatures.
-decimal\..*
 _decimal
-os.AT_NO_AUTOMOUNT
-os.AT_STATX_DONT_SYNC
-os.AT_STATX_FORCE_SYNC
-os.AT_STATX_SYNC_AS_STAT
-os.STATX_ATIME
-os.STATX_BASIC_STATS
-os.STATX_BLOCKS
-os.STATX_BTIME
-os.STATX_CTIME
-os.STATX_DIOALIGN
-os.STATX_GID
-os.STATX_INO
-os.STATX_MNT_ID
-os.STATX_MNT_ID_UNIQUE
-os.STATX_MODE
-os.STATX_MTIME
-os.STATX_NLINK
-os.STATX_SIZE
-os.STATX_TYPE
-os.STATX_UID
-os.__all__
-os._clearenv
-os.statx
-os.statx_result
-posix.AT_NO_AUTOMOUNT
-posix.AT_STATX_DONT_SYNC
-posix.AT_STATX_FORCE_SYNC
-posix.AT_STATX_SYNC_AS_STAT
-posix.STATX_ATIME
-posix.STATX_BASIC_STATS
-posix.STATX_BLOCKS
-posix.STATX_BTIME
-posix.STATX_CTIME
-posix.STATX_DIOALIGN
-posix.STATX_GID
-posix.STATX_INO
-posix.STATX_MNT_ID
-posix.STATX_MNT_ID_UNIQUE
-posix.STATX_MODE
-posix.STATX_MTIME
-posix.STATX_NLINK
-posix.STATX_SIZE
-posix.STATX_TYPE
-posix.STATX_UID
-posix.statx
-
-
-# =============================================================
-# Allowlist entries that cannot or should not be fixed; >= 3.15
-# =============================================================
+decimal\..*
 
 # Depends on how readline was built.
 readline.get_pre_input_hook

stdlib/@tests/stubtest_allowlists/py315.txt

@@ -18,11 +18,10 @@ _struct.pack_into
 _thread.RLock.__exit__
 _thread.lock.__exit__
 copy.deepcopy
-dataclasses._MISSING_TYPE
 dataclasses.MISSING
+dataclasses._MISSING_TYPE
 dataclasses.field
 doctest.DocTestRunner.report_skip
-enum.__all__
 importlib._abc.Loader.load_module
 importlib._bootstrap_external.NamespacePath
 importlib.abc.InspectLoader.source_to_code
@@ -37,9 +36,6 @@ threading.Condition.locked
 tkinter.Image.__iter__
 tkinter.Misc.__iter__
 tkinter.font.Font.__iter__
-tkinter.simpledialog.__all__
-typing_extensions.__all__
-xml.etree.ElementTree.__all__
 
 # =============================================================
 # Allowlist entries that cannot or should not be fixed; >= 3.15
@@ -50,6 +46,9 @@ base64.b64decode
 urllib.parse.urlunparse
 urllib.parse.urlunsplit
 
+# Runtime __all__ includes no_type_check_decorator, but the attribute does not exist on Python 3.15.
+typing_extensions.__all__
+
 # Internal implementation details of the sampling profiler.
 profiling.sampling.binary_collector
 profiling.sampling.binary_reader

stdlib/@tests/stubtest_allowlists/win32-py315.txt

@@ -1,20 +1,3 @@
-# ============================================
-# TODO: Allowlist entries that should be fixed
-# ============================================
-
-_winapi.DeregisterEventSource
-_winapi.EVENTLOG_AUDIT_FAILURE
-_winapi.EVENTLOG_AUDIT_SUCCESS
-_winapi.EVENTLOG_ERROR_TYPE
-_winapi.EVENTLOG_INFORMATION_TYPE
-_winapi.EVENTLOG_SUCCESS
-_winapi.EVENTLOG_WARNING_TYPE
-_winapi.GetOEMCP
-_winapi.RegisterEventSource
-_winapi.ReportEvent
-winreg.DeleteTree
-
-
 # =============================================================
 # Allowlist entries that cannot or should not be fixed; >= 3.15
 # =============================================================

stdlib/_heapq.pyi

@@ -4,7 +4,7 @@ from typing import Final
 
 __about__: Final[str]
 
-def heapify(heap: list[_T], /) -> None: ...
+def heapify(heap: list[_T], /) -> None: ...  # To work around the fact that list is invariant
 def heappop(heap: list[_T], /) -> _T: ...
 def heappush(heap: list[_T], item: _T, /) -> None: ...
 def heappushpop(heap: list[_T], item: _T, /) -> _T: ...

stdlib/_typeshed/__init__.pyi

@@ -351,10 +351,12 @@ AnyOrLiteralStr = TypeVar("AnyOrLiteralStr", str, bytes, LiteralString)  # noqa:
 StrOrLiteralStr = TypeVar("StrOrLiteralStr", LiteralString, str)  # noqa: Y001
 
 # Objects suitable to be passed to sys.setprofile, threading.setprofile, and similar
-ProfileFunction: TypeAlias = Callable[[FrameType, str, Any], object]
+ProfileFunction: TypeAlias = Callable[[FrameType, Literal["call", "return", "c_call", "c_return", "c_exception"], Any], object]
 
 # Objects suitable to be passed to sys.settrace, threading.settrace, and similar
-TraceFunction: TypeAlias = Callable[[FrameType, str, Any], TraceFunction | None]
+TraceFunction: TypeAlias = Callable[
+    [FrameType, Literal["call", "line", "return", "exception", "opcode"], Any], TraceFunction | None
+]
 
 # experimental
 # Might not work as expected for pyright, see

stdlib/_winapi.pyi

@@ -29,6 +29,14 @@ if sys.platform == "win32":
     ERROR_PIPE_CONNECTED: Final = 535
     ERROR_SEM_TIMEOUT: Final = 121
 
+    if sys.version_info >= (3, 15):
+        EVENTLOG_AUDIT_FAILURE: Final = 16
+        EVENTLOG_AUDIT_SUCCESS: Final = 8
+        EVENTLOG_ERROR_TYPE: Final = 1
+        EVENTLOG_INFORMATION_TYPE: Final = 4
+        EVENTLOG_SUCCESS: Final = 0
+        EVENTLOG_WARNING_TYPE: Final = 2
+
     FILE_FLAG_FIRST_PIPE_INSTANCE: Final = 0x80000
     FILE_FLAG_OVERLAPPED: Final = 0x40000000
 
@@ -232,6 +240,10 @@ if sys.platform == "win32":
     ) -> int: ...
     def ExitProcess(ExitCode: int, /) -> NoReturn: ...
     def GetACP() -> int: ...
+    if sys.version_info >= (3, 15):
+        def DeregisterEventSource(handle: int, /) -> None: ...
+        def GetOEMCP() -> int: ...
+
     def GetFileType(handle: int) -> int: ...
     def GetCurrentProcess() -> int: ...
     def GetExitCodeProcess(process: int, /) -> int: ...
@@ -245,6 +257,10 @@ if sys.platform == "win32":
     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]: ...
     def LCMapStringEx(locale: str, flags: int, src: str) -> str: ...
+    if sys.version_info >= (3, 15):
+        def RegisterEventSource(unc_server_name: str | None, source_name: str, /) -> int: ...
+        def ReportEvent(handle: int, type: int, category: int, event_id: int, string: str, /) -> None: ...
+
     def UnmapViewOfFile(address: int, /) -> None: ...
 
     @overload

stdlib/asyncio/base_events.pyi

@@ -115,7 +115,7 @@ class BaseEventLoop(AbstractEventLoop):
         type: int = 0,
         proto: int = 0,
         flags: int = 0,
-    ) -> list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int] | tuple[str, int, int, int]]]: ...
+    ) -> list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int] | tuple[str, int, int, int] | tuple[int, bytes]]]: ...
     async def getnameinfo(self, sockaddr: tuple[str, int] | tuple[str, int, int, int], flags: int = 0) -> tuple[str, str]: ...
 
     if sys.version_info >= (3, 12):

stdlib/asyncio/events.pyi

@@ -205,7 +205,7 @@ class AbstractEventLoop:
         type: int = 0,
         proto: int = 0,
         flags: int = 0,
-    ) -> list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int] | tuple[str, int, int, int]]]: ...
+    ) -> list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int] | tuple[str, int, int, int] | tuple[int, bytes]]]: ...
     @abstractmethod
     async def getnameinfo(self, sockaddr: tuple[str, int] | tuple[str, int, int, int], flags: int = 0) -> tuple[str, str]: ...
 

stdlib/asyncio/runners.pyi

@@ -27,7 +27,12 @@ if sys.version_info >= (3, 11):
         else:
             def run(self, coro: Coroutine[Any, Any, _T], *, context: Context | None = None) -> _T: ...
 
-if sys.version_info >= (3, 12):
+if sys.version_info >= (3, 14):
+    def run(
+        main: Awaitable[_T], *, debug: bool | None = None, loop_factory: Callable[[], AbstractEventLoop] | None = None
+    ) -> _T: ...
+
+elif sys.version_info >= (3, 12):
     def run(
         main: Coroutine[Any, Any, _T], *, debug: bool | None = None, loop_factory: Callable[[], AbstractEventLoop] | None = None
     ) -> _T: ...

stdlib/enum.pyi

@@ -37,6 +37,8 @@ if sys.version_info >= (3, 11):
 
 if sys.version_info >= (3, 13):
     __all__ += ["EnumDict"]
+if sys.version_info >= (3, 15):
+    __all__ += ["show_flag_values", "bin"]
 
 _EnumMemberT = TypeVar("_EnumMemberT")
 _EnumerationT = TypeVar("_EnumerationT", bound=type[Enum])