Merge remote-tracking branch 'upstream/main' into python315

# Conflicts:
#	stdlib/_interpqueues.pyi
#	stdlib/ast.pyi
#	stdlib/base64.pyi
#	stdlib/collections/__init__.pyi
#	stdlib/glob.pyi
#	stdlib/importlib/metadata/__init__.pyi
#	stdlib/pyexpat/__init__.pyi
#	stdlib/sys/__init__.pyi
#	stdlib/threading.pyi
#	stdlib/types.pyi
#	stdlib/typing.pyi
#	stdlib/unicodedata.pyi
#	stdlib/unittest/_log.pyi
#	stdlib/unittest/case.pyi
#	stdlib/wave.pyi
#	stdlib/zipimport.pyi

Author: JelleZijlstra

lib/ts_utils/metadata.py

@@ -13,8 +13,7 @@
 from collections.abc import Mapping
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Annotated, Any, Final, NamedTuple, cast, final
-from typing_extensions import TypeGuard
+from typing import Annotated, Any, Final, NamedTuple, TypeGuard, cast, final
 
 if sys.version_info >= (3, 11):
     import tomllib

lib/ts_utils/utils.py

@@ -9,8 +9,7 @@
 from collections.abc import Iterable, Mapping
 from pathlib import Path
 from types import MethodType
-from typing import TYPE_CHECKING, Any, Final, NamedTuple
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Any, Final, NamedTuple, TypeAlias
 
 import pathspec
 from packaging.requirements import Requirement

pyproject.toml

@@ -106,7 +106,7 @@ select = [
     "PYI044", # `from __future__ import annotations` has no effect in stub files, since type checkers automatically treat stubs as having those semantics
     "PYI055", # Multiple `type[T]` usages in a union. Combine them into one, e.g., `type[{union_str}]`.
     "PYI058", # Use `{return_type}` as the return value for simple `{method}` methods
-    # "PYI059", # TODO: Add when dropping Python 3.9 support
+    "PYI059", # Checks for classes inheriting from typing.Generic[] where Generic[] is not the last base class in the bases tuple
     "PYI061", # Use `None` rather than `Literal[None]`
     "PYI062", # Duplicate literal member `{}`
     "PYI064", # `Final[Literal[{literal}]]` can be replaced with a bare Final

scripts/stubsabot.py

@@ -22,8 +22,8 @@
 from dataclasses import dataclass, field
 from http import HTTPStatus
 from pathlib import Path
-from typing import Annotated, Any, ClassVar, Literal, NamedTuple, TypedDict, TypeVar
-from typing_extensions import Self, TypeAlias
+from typing import Annotated, Any, ClassVar, Literal, NamedTuple, TypeAlias, TypedDict, TypeVar
+from typing_extensions import Self
 
 if sys.version_info >= (3, 11):
     import tomllib

stdlib/@tests/test_cases/check_functools.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
 from functools import cache, cached_property, lru_cache, wraps
-from typing import Callable, TypeVar
-from typing_extensions import ParamSpec, assert_type
+from typing import Callable, ParamSpec, TypeVar
+from typing_extensions import assert_type
 
 P = ParamSpec("P")
 T_co = TypeVar("T_co", covariant=True)

stdlib/@tests/test_cases/check_importlib_metadata.py

@@ -1,28 +1,28 @@
 from __future__ import annotations
 
-import sys
 from _typeshed import StrPath
+from importlib.metadata._meta import SimplePath
 from os import PathLike
 from pathlib import Path
 from zipfile import Path as ZipPath
 
-if sys.version_info >= (3, 10):
-    from importlib.metadata._meta import SimplePath
 
-    # Simplified version of zipfile.Path
-    class MyPath:
-        @property
-        def parent(self) -> PathLike[str]: ...  # undocumented
+# Simplified version of zipfile.Path
+class MyPath:
+    @property
+    def parent(self) -> PathLike[str]: ...  # undocumented
 
-        def read_text(self, encoding: str | None = ..., errors: str | None = ...) -> str: ...
-        def read_bytes(self) -> bytes: ...
-        def joinpath(self, *other: StrPath) -> MyPath: ...
-        def __truediv__(self, add: StrPath) -> MyPath: ...
-        def exists(self) -> bool: ...
+    def read_text(self, encoding: str | None = ..., errors: str | None = ...) -> str: ...
+    def read_bytes(self) -> bytes: ...
+    def joinpath(self, *other: StrPath) -> MyPath: ...
+    def __truediv__(self, add: StrPath) -> MyPath: ...
+    def exists(self) -> bool: ...
 
-    def takes_simple_path(p: SimplePath) -> None: ...
 
-    takes_simple_path(Path())
-    takes_simple_path(ZipPath(""))
-    takes_simple_path(MyPath())
-    takes_simple_path("some string")  # type: ignore
+def takes_simple_path(p: SimplePath) -> None: ...
+
+
+takes_simple_path(Path())
+takes_simple_path(ZipPath(""))
+takes_simple_path(MyPath())
+takes_simple_path("some string")  # type: ignore

stdlib/@tests/test_cases/check_types.py

@@ -65,16 +65,15 @@ def foo(self) -> None:
 # check that NotImplemented is treated as an "Any"
 x: int = NotImplemented
 
-if sys.version_info >= (3, 10):
-    # test NotImplementedType usage
-    assert_type(NotImplemented, types.NotImplementedType)
-    assert_type(types.NotImplementedType(), types.NotImplementedType)
-    # test EllipsisType usage
-    assert_type(Ellipsis, types.EllipsisType)
-    assert_type(types.EllipsisType(), types.EllipsisType)
-    # test NoneType usage (disabled, passes with pyright, but mypy errors
-    # assert_type(None, types.NoneType)
-    # assert_type(types.NoneType(), types.NoneType)
+# test NotImplementedType usage
+assert_type(NotImplemented, types.NotImplementedType)
+assert_type(types.NotImplementedType(), types.NotImplementedType)
+# test EllipsisType usage
+assert_type(Ellipsis, types.EllipsisType)
+assert_type(types.EllipsisType(), types.EllipsisType)
+# test NoneType usage (disabled, passes with pyright, but mypy errors
+# assert_type(None, types.NoneType)
+# assert_type(types.NoneType(), types.NoneType)
 
 if sys.version_info >= (3, 11):
     union_type = int | list[_T]

stdlib/@tests/test_cases/itertools/check_itertools_recipes.py

@@ -22,11 +22,12 @@
     Sequence,
     Tuple,
     Type,
+    TypeAlias,
     TypeVar,
     Union,
     overload,
 )
-from typing_extensions import TypeAlias, TypeVarTuple, Unpack
+from typing_extensions import TypeVarTuple, Unpack
 
 _T = TypeVar("_T")
 _T1 = TypeVar("_T1")
@@ -326,44 +327,46 @@ def nth_combination(iterable: Iterable[_T], r: int, index: int) -> tuple[_T, ...
     return tuple(result)
 
 
-if sys.version_info >= (3, 10):
-
-    @overload
-    def grouper(
-        iterable: Iterable[_T], n: int, *, incomplete: Literal["fill"] = "fill", fillvalue: None = None
-    ) -> Iterator[tuple[_T | None, ...]]: ...
-
-    @overload
-    def grouper(
-        iterable: Iterable[_T], n: int, *, incomplete: Literal["fill"] = "fill", fillvalue: _T1
-    ) -> Iterator[tuple[_T | _T1, ...]]: ...
-
-    @overload
-    def grouper(
-        iterable: Iterable[_T], n: int, *, incomplete: Literal["strict", "ignore"], fillvalue: None = None
-    ) -> Iterator[tuple[_T, ...]]: ...
-
-    def grouper(
-        iterable: Iterable[object], n: int, *, incomplete: Literal["fill", "strict", "ignore"] = "fill", fillvalue: object = None
-    ) -> Iterator[tuple[object, ...]]:
-        "Collect data into non-overlapping fixed-length chunks or blocks"
-        # grouper('ABCDEFG', 3, fillvalue='x') --> ABC DEF Gxx
-        # grouper('ABCDEFG', 3, incomplete='strict') --> ABC DEF ValueError
-        # grouper('ABCDEFG', 3, incomplete='ignore') --> ABC DEF
-        args = [iter(iterable)] * n
-        if incomplete == "fill":
-            return zip_longest(*args, fillvalue=fillvalue)
-        if incomplete == "strict":
-            return zip(*args, strict=True)
-        if incomplete == "ignore":
-            return zip(*args)
-        else:
-            raise ValueError("Expected fill, strict, or ignore")
-
-    def transpose(it: Iterable[Iterable[_T]]) -> Iterator[tuple[_T, ...]]:
-        "Swap the rows and columns of the input."
-        # transpose([(1, 2, 3), (11, 22, 33)]) --> (1, 11) (2, 22) (3, 33)
-        return zip(*it, strict=True)
+@overload
+def grouper(
+    iterable: Iterable[_T], n: int, *, incomplete: Literal["fill"] = "fill", fillvalue: None = None
+) -> Iterator[tuple[_T | None, ...]]: ...
+
+
+@overload
+def grouper(
+    iterable: Iterable[_T], n: int, *, incomplete: Literal["fill"] = "fill", fillvalue: _T1
+) -> Iterator[tuple[_T | _T1, ...]]: ...
+
+
+@overload
+def grouper(
+    iterable: Iterable[_T], n: int, *, incomplete: Literal["strict", "ignore"], fillvalue: None = None
+) -> Iterator[tuple[_T, ...]]: ...
+
+
+def grouper(
+    iterable: Iterable[object], n: int, *, incomplete: Literal["fill", "strict", "ignore"] = "fill", fillvalue: object = None
+) -> Iterator[tuple[object, ...]]:
+    "Collect data into non-overlapping fixed-length chunks or blocks"
+    # grouper('ABCDEFG', 3, fillvalue='x') --> ABC DEF Gxx
+    # grouper('ABCDEFG', 3, incomplete='strict') --> ABC DEF ValueError
+    # grouper('ABCDEFG', 3, incomplete='ignore') --> ABC DEF
+    args = [iter(iterable)] * n
+    if incomplete == "fill":
+        return zip_longest(*args, fillvalue=fillvalue)
+    if incomplete == "strict":
+        return zip(*args, strict=True)
+    if incomplete == "ignore":
+        return zip(*args)
+    else:
+        raise ValueError("Expected fill, strict, or ignore")
+
+
+def transpose(it: Iterable[Iterable[_T]]) -> Iterator[tuple[_T, ...]]:
+    "Swap the rows and columns of the input."
+    # transpose([(1, 2, 3), (11, 22, 33)]) --> (1, 11) (2, 22) (3, 33)
+    return zip(*it, strict=True)
 
 
 if sys.version_info >= (3, 12):

stdlib/VERSIONS

@@ -23,7 +23,6 @@ _ast: 3.0-
 _asyncio: 3.0-
 _bisect: 3.0-
 _blake2: 3.6-
-_bootlocale: 3.4-3.9
 _bz2: 3.3-
 _codecs: 3.0-
 _collections_abc: 3.3-
@@ -143,7 +142,6 @@ difflib: 3.0-
 dis: 3.0-
 distutils: 3.0-3.11
 distutils.command.bdist_msi: 3.0-3.10
-distutils.command.bdist_wininst: 3.0-3.9
 doctest: 3.0-
 email: 3.0-
 encodings: 3.0-
@@ -160,7 +158,6 @@ fcntl: 3.0-
 filecmp: 3.0-
 fileinput: 3.0-
 fnmatch: 3.0-
-formatter: 3.0-3.9
 fractions: 3.0-
 ftplib: 3.0-
 functools: 3.0-
@@ -232,7 +229,6 @@ operator: 3.0-
 optparse: 3.0-
 os: 3.0-
 ossaudiodev: 3.0-3.12
-parser: 3.0-3.9
 pathlib: 3.4-
 pathlib.types: 3.14-
 pdb: 3.0-
@@ -296,7 +292,6 @@ stringprep: 3.0-
 struct: 3.0-
 subprocess: 3.0-
 sunau: 3.0-3.12
-symbol: 3.0-3.9
 symtable: 3.0-
 sys: 3.0-
 sys.__jit: 3.14-        # Similar to sys._monitoring

stdlib/__future__.pyi

@@ -1,4 +1,4 @@
-from typing_extensions import TypeAlias
+from typing import TypeAlias
 
 _VersionInfo: TypeAlias = tuple[int, int, int, str, int]