Merge branch 'main' into patch-1

Author: babenek

.pre-commit-config.yaml

@@ -27,7 +27,7 @@ repos:
           - "--unsafe-fixes"
         files: '.*test_cases/.+\.py$'
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 26.3.1
+    rev: 26.5.0
     hooks:
       - id: black
   - repo: https://github.com/pycqa/flake8

pyproject.toml

@@ -9,6 +9,7 @@ requires-python = ">=3.10" # Minimum version to run tests, used by uv run
 line-length = 130
 target-version = ["py310"]
 skip-magic-trailing-comma = true
+preview = true
 
 [tool.ruff]
 line-length = 130

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/_asyncio.pyi

@@ -16,10 +16,12 @@ class Future(Awaitable[_T]):
     @property
     def _exception(self) -> BaseException | None: ...
     _blocking: bool
+
     @property
     def _log_traceback(self) -> bool: ...
     @_log_traceback.setter
     def _log_traceback(self, val: Literal[False]) -> None: ...
+
     _asyncio_future_blocking: bool  # is a part of duck-typing contract for `Future`
     def __init__(self, *, loop: AbstractEventLoop | None = None) -> None: ...
     def __del__(self) -> None: ...

stdlib/_bisect.pyi

@@ -38,6 +38,7 @@ def bisect_left(
 def bisect_left(
     a: SupportsGetItem[int, _T], x: SupportsRichComparisonT, lo: int = 0, *, hi: int, key: Callable[[_T], SupportsRichComparisonT]
 ) -> int: ...
+
 @overload
 def bisect_right(
     a: SupportsLenAndGetItem[SupportsRichComparisonT],
@@ -72,6 +73,7 @@ def bisect_right(
 def bisect_right(
     a: SupportsGetItem[int, _T], x: SupportsRichComparisonT, lo: int = 0, *, hi: int, key: Callable[[_T], SupportsRichComparisonT]
 ) -> int: ...
+
 @overload
 def insort_left(
     a: MutableSequence[SupportsRichComparisonT],
@@ -85,6 +87,7 @@ def insort_left(
 def insort_left(
     a: MutableSequence[_T], x: _T, lo: int = 0, hi: int | None = None, *, key: Callable[[_T], SupportsRichComparisonT]
 ) -> None: ...
+
 @overload
 def insort_right(
     a: MutableSequence[SupportsRichComparisonT],

stdlib/_codecs.pyi

@@ -49,6 +49,7 @@ def encode(obj: ReadableBuffer, encoding: _BytesToBytesEncoding, errors: str = "
 def encode(obj: str, encoding: _StrToStrEncoding, errors: str = "strict") -> str: ...  # type: ignore[overload-overlap]
 @overload
 def encode(obj: str, encoding: str = "utf-8", errors: str = "strict") -> bytes: ...
+
 @overload
 def decode(obj: ReadableBuffer, encoding: _BytesToBytesEncoding, errors: str = "strict") -> bytes: ...  # type: ignore[overload-overlap]
 @overload
@@ -67,6 +68,7 @@ def decode(
 def decode(obj: str, encoding: Literal["hex", "hex_codec"], errors: str = "strict") -> bytes: ...
 @overload
 def decode(obj: ReadableBuffer, encoding: str = "utf-8", errors: str = "strict") -> str: ...
+
 def lookup(encoding: str, /) -> codecs.CodecInfo: ...
 def charmap_build(map: str, /) -> _CharMap: ...
 def ascii_decode(data: ReadableBuffer, errors: str | None = None, /) -> tuple[str, int]: ...

stdlib/_contextvars.pyi

@@ -14,15 +14,18 @@ class ContextVar(Generic[_T]):
     def __new__(cls, name: str) -> Self: ...
     @overload
     def __new__(cls, name: str, *, default: _T) -> Self: ...
+
     def __hash__(self) -> int: ...
     @property
     def name(self) -> str: ...
+
     @overload
     def get(self) -> _T: ...
     @overload
     def get(self, default: _T, /) -> _T: ...
     @overload
     def get(self, default: _D, /) -> _D | _T: ...
+
     def set(self, value: _T, /) -> Token[_T]: ...
     def reset(self, token: Token[_T], /) -> None: ...
     def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
@@ -49,12 +52,14 @@ def copy_context() -> Context: ...
 @final
 class Context(Mapping[ContextVar[Any], Any]):
     def __init__(self) -> None: ...
+
     @overload
     def get(self, key: ContextVar[_T], default: None = None, /) -> _T | None: ...
     @overload
     def get(self, key: ContextVar[_T], default: _T, /) -> _T: ...
     @overload
     def get(self, key: ContextVar[_T], default: _D, /) -> _T | _D: ...
+
     def run(self, callable: Callable[_P, _T], *args: _P.args, **kwargs: _P.kwargs) -> _T: ...
     def copy(self) -> Context: ...
     __hash__: ClassVar[None]  # type: ignore[assignment]

stdlib/_ctypes.pyi

@@ -127,21 +127,25 @@ class _PyCPointerType(_CTypeBaseType):
 class _Pointer(_PointerLike, _CData, Generic[_CT], metaclass=_PyCPointerType):
     _type_: type[_CT]
     contents: _CT
+
     @overload
     def __init__(self) -> None: ...
     @overload
     def __init__(self, arg: _CT) -> None: ...
+
     @overload
     def __getitem__(self, key: int, /) -> Any: ...
     @overload
     def __getitem__(self, key: slice[SupportsIndex | None], /) -> list[Any]: ...
+
     def __setitem__(self, key: int, value: Any, /) -> None: ...
 
 if sys.version_info < (3, 14):
     @overload
     def POINTER(type: None, /) -> type[c_void_p]: ...
     @overload
     def POINTER(type: type[_CT], /) -> type[_Pointer[_CT]]: ...
+
     def pointer(obj: _CT, /) -> _Pointer[_CT]: ...
 
 # This class is not exposed. It calls itself _ctypes.CArgObject.
@@ -177,6 +181,7 @@ class CFuncPtr(_PointerLike, _CData, metaclass=_PyCFuncPtrType):
     errcheck: _ECT
     # Abstract attribute that must be defined on subclasses
     _flags_: ClassVar[int]
+
     @overload
     def __new__(cls) -> Self: ...
     @overload
@@ -209,10 +214,12 @@ if sys.version_info >= (3, 14):
         bit_offset: int
         bit_size: int
         is_anonymous: bool
+
         @overload
         def __get__(self, instance: None, owner: builtins.type[Any] | None = None, /) -> Self: ...
         @overload
         def __get__(self, instance: Any, owner: builtins.type[Any] | None = None, /) -> _GetT: ...
+
         def __set__(self, instance: Any, value: _SetT, /) -> None: ...
 
     _CField = CField
@@ -223,10 +230,12 @@ else:
     class _CField(Generic[_CT, _GetT, _SetT]):
         offset: int
         size: int
+
         @overload
         def __get__(self, instance: None, owner: type[Any] | None = None, /) -> Self: ...
         @overload
         def __get__(self, instance: Any, owner: type[Any] | None = None, /) -> _GetT: ...
+
         def __set__(self, instance: Any, value: _SetT, /) -> None: ...
 
 # This class is not exposed. It calls itself _ctypes.UnionType.
@@ -308,16 +317,19 @@ class Array(_CData, Generic[_CT], metaclass=_PyCArrayType):
     def _length_(self) -> int: ...
     @_length_.setter
     def _length_(self, value: int) -> None: ...
+
     @property
     @abstractmethod
     def _type_(self) -> type[_CT]: ...
     @_type_.setter
     def _type_(self, value: type[_CT]) -> None: ...
+
     # Note: only available if _CT == c_char
     @property
     def raw(self) -> bytes: ...
     @raw.setter
     def raw(self, value: ReadableBuffer) -> None: ...
+
     value: Any  # Note: bytes if _CT == c_char, str if _CT == c_wchar, unavailable otherwise
     # TODO: These methods cannot be annotated correctly at the moment.
     # All of these "Any"s stand for the array's element type, but it's not possible to use _CT
@@ -332,14 +344,17 @@ class Array(_CData, Generic[_CT], metaclass=_PyCArrayType):
     # This special behavior is not easy to model in a stub, so for now all places where
     # the array element type would belong are annotated with Any instead.
     def __init__(self, *args: Any) -> None: ...
+
     @overload
     def __getitem__(self, key: int, /) -> Any: ...
     @overload
     def __getitem__(self, key: slice[SupportsIndex | None], /) -> list[Any]: ...
+
     @overload
     def __setitem__(self, key: int, value: Any, /) -> None: ...
     @overload
     def __setitem__(self, key: slice[SupportsIndex | None], value: Iterable[Any], /) -> None: ...
+
     def __iter__(self) -> Iterator[Any]: ...
     # Can't inherit from Sized because the metaclass conflict between
     # Sized and _CData prevents using _CDataMeta.