basedpyright 1.22.0 → 1.22.1

package/dist/typeshed-fallback/stdlib/sqlite3/__init__.pyi

@@ -63,7 +63,7 @@ from sqlite3.dbapi2 import (
     version_info as version_info,
 )
 from types import TracebackType
-from typing import Any, Literal, Protocol, SupportsIndex, TypeVar, final, overload
+from typing import Any, Literal, Protocol, SupportsIndex, TypeVar, final, overload, type_check_only
 from typing_extensions import Self, TypeAlias
 
 if sys.version_info >= (3, 12):
@@ -728,7 +728,9 @@ class Row(Sequence[Any]):
         """Return self!=value."""
         ...
 
+# This class is not exposed. It calls itself sqlite3.Statement.
 @final
+@type_check_only
 class _Statement: ...
 
 if sys.version_info >= (3, 11):

package/dist/typeshed-fallback/stdlib/sqlite3/dump.pyi

@@ -0,0 +1,2 @@
+# This file is intentionally empty. The runtime module contains only
+# private functions.

package/dist/typeshed-fallback/stdlib/ssl.pyi

@@ -27,7 +27,7 @@ from _ssl import (
 )
 from _typeshed import ReadableBuffer, StrOrBytesPath, WriteableBuffer
 from collections.abc import Callable, Iterable
-from typing import Any, Literal, NamedTuple, TypedDict, overload
+from typing import Any, Literal, NamedTuple, TypedDict, overload, type_check_only
 from typing_extensions import Never, Self, TypeAlias
 
 if sys.version_info >= (3, 13):
@@ -309,6 +309,8 @@ ALERT_DESCRIPTION_UNSUPPORTED_CERTIFICATE: AlertDescription
 ALERT_DESCRIPTION_UNSUPPORTED_EXTENSION: AlertDescription
 ALERT_DESCRIPTION_USER_CANCELLED: AlertDescription
 
+# This class is not exposed. It calls itself ssl._ASN1Object.
+@type_check_only
 class _ASN1ObjectBase(NamedTuple):
     nid: int
     shortname: str

package/dist/typeshed-fallback/stdlib/sys/__init__.pyi

@@ -78,14 +78,13 @@ from builtins import object as _object
 from collections.abc import AsyncGenerator, Callable, Sequence
 from io import TextIOWrapper
 from types import FrameType, ModuleType, TracebackType
-from typing import Any, Final, Literal, NoReturn, Protocol, TextIO, TypeVar, final
+from typing import Any, Final, Literal, NoReturn, Protocol, TextIO, TypeVar, final, type_check_only
 from typing_extensions import TypeAlias
 
 _T = TypeVar("_T")
 
 # see https://github.com/python/typeshed/issues/8513#issue-1333671093 for the rationale behind this alias
 _ExitCode: TypeAlias = str | int | None
-_OptExcInfo: TypeAlias = OptExcInfo  # noqa: Y047  # TODO: obsolete, remove fall 2022 or later
 
 # ----- sys variables -----
 if sys.platform != "win32":
@@ -163,13 +162,63 @@ _UninstantiableStructseq: TypeAlias = structseq[Any]
 
 flags: _flags
 
-if sys.version_info >= (3, 10):
-    _FlagTuple: TypeAlias = tuple[int, int, int, int, int, int, int, int, int, int, int, int, int, bool, int, int]
-else:
-    _FlagTuple: TypeAlias = tuple[int, int, int, int, int, int, int, int, int, int, int, int, int, bool, int]
-
+# This class is not exposed at runtime. It calls itself sys.flags.
+# As a tuple, it can have a length between 15 and 18. We don't model
+# the exact length here because that varies by patch version due to
+# the backported security fix int_max_str_digits. The exact length shouldn't
+# be relied upon. See #13031
+# This can be re-visited when typeshed drops support for 3.10,
+# at which point all supported versions will include int_max_str_digits
+# in all patch versions.
+# 3.8 and 3.9 are 15 or 16-tuple
+# 3.10 is 16 or 17-tuple
+# 3.11+ is an 18-tuple.
 @final
-class _flags(_UninstantiableStructseq, _FlagTuple):
+@type_check_only
+class _flags(_UninstantiableStructseq, tuple[int, ...]):
+    # `safe_path` was added in py311
+    if sys.version_info >= (3, 11):
+        __match_args__: Final = (
+            "debug",
+            "inspect",
+            "interactive",
+            "optimize",
+            "dont_write_bytecode",
+            "no_user_site",
+            "no_site",
+            "ignore_environment",
+            "verbose",
+            "bytes_warning",
+            "quiet",
+            "hash_randomization",
+            "isolated",
+            "dev_mode",
+            "utf8_mode",
+            "warn_default_encoding",
+            "safe_path",
+            "int_max_str_digits",
+        )
+    elif sys.version_info >= (3, 10):
+        __match_args__: Final = (
+            "debug",
+            "inspect",
+            "interactive",
+            "optimize",
+            "dont_write_bytecode",
+            "no_user_site",
+            "no_site",
+            "ignore_environment",
+            "verbose",
+            "bytes_warning",
+            "quiet",
+            "hash_randomization",
+            "isolated",
+            "dev_mode",
+            "utf8_mode",
+            "warn_default_encoding",
+            "int_max_str_digits",
+        )
+
     @property
     def debug(self) -> int: ...
     @property
@@ -202,15 +251,39 @@ class _flags(_UninstantiableStructseq, _FlagTuple):
     def utf8_mode(self) -> int: ...
     if sys.version_info >= (3, 10):
         @property
-        def warn_default_encoding(self) -> int: ...  # undocumented
+        def warn_default_encoding(self) -> int: ...
     if sys.version_info >= (3, 11):
         @property
         def safe_path(self) -> bool: ...
+    # Whether or not this exists on lower versions of Python
+    # may depend on which patch release you're using
+    # (it was backported to all Python versions on 3.8+ as a security fix)
+    # Added in: 3.8.14, 3.9.14, 3.10.7
+    # and present in all versions of 3.11 and later.
+    @property
+    def int_max_str_digits(self) -> int: ...
 
 float_info: _float_info
 
+# This class is not exposed at runtime. It calls itself sys.float_info.
 @final
+@type_check_only
 class _float_info(structseq[float], tuple[float, int, int, float, int, int, int, int, float, int, int]):
+    if sys.version_info >= (3, 10):
+        __match_args__: Final = (
+            "max",
+            "max_exp",
+            "max_10_exp",
+            "min",
+            "min_exp",
+            "min_10_exp",
+            "dig",
+            "mant_dig",
+            "epsilon",
+            "radix",
+            "rounds",
+        )
+
     @property
     def max(self) -> float: ...  # DBL_MAX
     @property
@@ -236,8 +309,13 @@ class _float_info(structseq[float], tuple[float, int, int, float, int, int, int,
 
 hash_info: _hash_info
 
+# This class is not exposed at runtime. It calls itself sys.hash_info.
 @final
+@type_check_only
 class _hash_info(structseq[Any | int], tuple[int, int, int, int, int, str, int, int, int]):
+    if sys.version_info >= (3, 10):
+        __match_args__: Final = ("width", "modulus", "inf", "nan", "imag", "algorithm", "hash_bits", "seed_bits", "cutoff")
+
     @property
     def width(self) -> int: ...
     @property
@@ -259,6 +337,9 @@ class _hash_info(structseq[Any | int], tuple[int, int, int, int, int, str, int,
 
 implementation: _implementation
 
+# This class isn't really a thing. At runtime, implementation is an instance
+# of types.SimpleNamespace. This allows for better typing.
+@type_check_only
 class _implementation:
     name: str
     version: _version_info
@@ -271,8 +352,13 @@ class _implementation:
 
 int_info: _int_info
 
+# This class is not exposed at runtime. It calls itself sys.int_info.
 @final
+@type_check_only
 class _int_info(structseq[int], tuple[int, int, int, int]):
+    if sys.version_info >= (3, 10):
+        __match_args__: Final = ("bits_per_digit", "sizeof_digit", "default_max_str_digits", "str_digits_check_threshold")
+
     @property
     def bits_per_digit(self) -> int: ...
     @property
@@ -285,8 +371,13 @@ class _int_info(structseq[int], tuple[int, int, int, int]):
 _ThreadInfoName: TypeAlias = Literal["nt", "pthread", "pthread-stubs", "solaris"]
 _ThreadInfoLock: TypeAlias = Literal["semaphore", "mutex+cond"] | None
 
+# This class is not exposed at runtime. It calls itself sys.thread_info.
 @final
+@type_check_only
 class _thread_info(_UninstantiableStructseq, tuple[_ThreadInfoName, _ThreadInfoLock, str | None]):
+    if sys.version_info >= (3, 10):
+        __match_args__: Final = ("name", "lock", "version")
+
     @property
     def name(self) -> _ThreadInfoName: ...
     @property
@@ -297,8 +388,13 @@ class _thread_info(_UninstantiableStructseq, tuple[_ThreadInfoName, _ThreadInfoL
 thread_info: _thread_info
 _ReleaseLevel: TypeAlias = Literal["alpha", "beta", "candidate", "final"]
 
+# This class is not exposed at runtime. It calls itself sys.version_info.
 @final
+@type_check_only
 class _version_info(_UninstantiableStructseq, tuple[int, int, int, _ReleaseLevel, int]):
+    if sys.version_info >= (3, 10):
+        __match_args__: Final = ("major", "minor", "micro", "releaselevel", "serial")
+
     @property
     def major(self) -> int: ...
     @property
@@ -595,6 +691,7 @@ if sys.version_info < (3, 9):
         ...
 
 # Doesn't exist at runtime, but exported in the stubs so pytest etc. can annotate their code more easily.
+@type_check_only
 class UnraisableHookArgs(Protocol):
     exc_type: type[BaseException]
     exc_value: BaseException | None
@@ -626,8 +723,13 @@ def audit(event: str, /, *args: Any) -> None:
 
 _AsyncgenHook: TypeAlias = Callable[[AsyncGenerator[Any, Any]], None] | None
 
+# This class is not exposed at runtime. It calls itself builtins.asyncgen_hooks.
 @final
+@type_check_only
 class _asyncgen_hooks(structseq[_AsyncgenHook], tuple[_AsyncgenHook, _AsyncgenHook]):
+    if sys.version_info >= (3, 10):
+        __match_args__: Final = ("firstiter", "finalizer")
+
     @property
     def firstiter(self) -> _AsyncgenHook: ...
     @property

package/dist/typeshed-fallback/stdlib/termios.pyi

@@ -21,58 +21,38 @@ _AttrReturn: TypeAlias = list[Any]
 
 if sys.platform != "win32":
     B0: int
-    B1000000: int
     B110: int
     B115200: int
-    B1152000: int
     B1200: int
     B134: int
     B150: int
-    B1500000: int
     B1800: int
     B19200: int
     B200: int
-    B2000000: int
     B230400: int
     B2400: int
-    B2500000: int
     B300: int
-    B3000000: int
-    B3500000: int
     B38400: int
-    B4000000: int
-    B460800: int
     B4800: int
     B50: int
-    B500000: int
     B57600: int
-    B576000: int
     B600: int
     B75: int
-    B921600: int
     B9600: int
     BRKINT: int
     BS0: int
     BS1: int
     BSDLY: int
-    CBAUD: int
-    CBAUDEX: int
-    CDEL: int
     CDSUSP: int
     CEOF: int
     CEOL: int
-    CEOL2: int
     CEOT: int
     CERASE: int
-    CESC: int
     CFLUSH: int
-    CIBAUD: int
     CINTR: int
     CKILL: int
     CLNEXT: int
     CLOCAL: int
-    CNUL: int
-    COMMON: int
     CQUIT: int
     CR0: int
     CR1: int
@@ -91,7 +71,6 @@ if sys.platform != "win32":
     CSTOP: int
     CSTOPB: int
     CSUSP: int
-    CSWTCH: int
     CWERASE: int
     ECHO: int
     ECHOCTL: int
@@ -112,7 +91,6 @@ if sys.platform != "win32":
     FIONREAD: int
     FLUSHO: int
     HUPCL: int
-    IBSHIFT: int
     ICANON: int
     ICRNL: int
     IEXTEN: int
@@ -120,33 +98,21 @@ if sys.platform != "win32":
     IGNCR: int
     IGNPAR: int
     IMAXBEL: int
-    INIT_C_CC: int
     INLCR: int
     INPCK: int
-    IOCSIZE_MASK: int
-    IOCSIZE_SHIFT: int
     ISIG: int
     ISTRIP: int
-    IUCLC: int
     IXANY: int
     IXOFF: int
     IXON: int
-    N_MOUSE: int
-    N_PPP: int
-    N_SLIP: int
-    N_STRIP: int
-    N_TTY: int
-    NCC: int
     NCCS: int
     NL0: int
     NL1: int
     NLDLY: int
     NOFLSH: int
-    NSWTCH: int
     OCRNL: int
     OFDEL: int
     OFILL: int
-    OLCUC: int
     ONLCR: int
     ONLRET: int
     ONOCR: int
@@ -160,9 +126,6 @@ if sys.platform != "win32":
     TAB2: int
     TAB3: int
     TABDLY: int
-    TCFLSH: int
-    TCGETA: int
-    TCGETS: int
     TCIFLUSH: int
     TCIOFF: int
     TCIOFLUSH: int
@@ -173,28 +136,11 @@ if sys.platform != "win32":
     TCSADRAIN: int
     TCSAFLUSH: int
     TCSANOW: int
-    TCSASOFT: int
-    TCSBRK: int
-    TCSBRKP: int
-    TCSETA: int
-    TCSETAF: int
-    TCSETAW: int
-    TCSETS: int
-    TCSETSF: int
-    TCSETSW: int
-    TCXONC: int
     TIOCCONS: int
     TIOCEXCL: int
     TIOCGETD: int
-    TIOCGICOUNT: int
-    TIOCGLCKTRMIOS: int
     TIOCGPGRP: int
-    TIOCGSERIAL: int
-    TIOCGSIZE: int
-    TIOCGSOFTCAR: int
     TIOCGWINSZ: int
-    TIOCINQ: int
-    TIOCLINUX: int
     TIOCM_CAR: int
     TIOCM_CD: int
     TIOCM_CTS: int
@@ -209,7 +155,6 @@ if sys.platform != "win32":
     TIOCMBIC: int
     TIOCMBIS: int
     TIOCMGET: int
-    TIOCMIWAIT: int
     TIOCMSET: int
     TIOCNOTTY: int
     TIOCNXCL: int
@@ -223,23 +168,10 @@ if sys.platform != "win32":
     TIOCPKT_STOP: int
     TIOCPKT: int
     TIOCSCTTY: int
-    TIOCSER_TEMT: int
-    TIOCSERCONFIG: int
-    TIOCSERGETLSR: int
-    TIOCSERGETMULTI: int
-    TIOCSERGSTRUCT: int
-    TIOCSERGWILD: int
-    TIOCSERSETMULTI: int
-    TIOCSERSWILD: int
     TIOCSETD: int
-    TIOCSLCKTRMIOS: int
     TIOCSPGRP: int
-    TIOCSSERIAL: int
-    TIOCSSIZE: int
-    TIOCSSOFTCAR: int
     TIOCSTI: int
     TIOCSWINSZ: int
-    TIOCTTYGSTRUCT: int
     TOSTOP: int
     VDISCARD: int
     VEOF: int
@@ -255,15 +187,119 @@ if sys.platform != "win32":
     VSTART: int
     VSTOP: int
     VSUSP: int
-    VSWTC: int
-    VSWTCH: int
     VT0: int
     VT1: int
     VTDLY: int
     VTIME: int
     VWERASE: int
-    XCASE: int
-    XTABS: int
+
+    if sys.version_info >= (3, 13):
+        EXTPROC: int
+        IUTF8: int
+
+    if sys.platform == "darwin" and sys.version_info >= (3, 13):
+        ALTWERASE: int
+        B14400: int
+        B28800: int
+        B7200: int
+        B76800: int
+        CCAR_OFLOW: int
+        CCTS_OFLOW: int
+        CDSR_OFLOW: int
+        CDTR_IFLOW: int
+        CIGNORE: int
+        CRTS_IFLOW: int
+        MDMBUF: int
+        NL2: int
+        NL3: int
+        NOKERNINFO: int
+        ONOEOT: int
+        OXTABS: int
+        VDSUSP: int
+        VSTATUS: int
+
+    if sys.platform == "darwin" and sys.version_info >= (3, 11):
+        TIOCGSIZE: int
+        TIOCSSIZE: int
+
+    if sys.platform == "linux":
+        B1152000: int
+        B576000: int
+        CBAUD: int
+        CBAUDEX: int
+        CIBAUD: int
+        IOCSIZE_MASK: int
+        IOCSIZE_SHIFT: int
+        IUCLC: int
+        N_MOUSE: int
+        N_PPP: int
+        N_SLIP: int
+        N_STRIP: int
+        N_TTY: int
+        NCC: int
+        OLCUC: int
+        TCFLSH: int
+        TCGETA: int
+        TCGETS: int
+        TCSBRK: int
+        TCSBRKP: int
+        TCSETA: int
+        TCSETAF: int
+        TCSETAW: int
+        TCSETS: int
+        TCSETSF: int
+        TCSETSW: int
+        TCXONC: int
+        TIOCGICOUNT: int
+        TIOCGLCKTRMIOS: int
+        TIOCGSERIAL: int
+        TIOCGSOFTCAR: int
+        TIOCINQ: int
+        TIOCLINUX: int
+        TIOCMIWAIT: int
+        TIOCTTYGSTRUCT: int
+        TIOCSER_TEMT: int
+        TIOCSERCONFIG: int
+        TIOCSERGETLSR: int
+        TIOCSERGETMULTI: int
+        TIOCSERGSTRUCT: int
+        TIOCSERGWILD: int
+        TIOCSERSETMULTI: int
+        TIOCSERSWILD: int
+        TIOCSLCKTRMIOS: int
+        TIOCSSERIAL: int
+        TIOCSSOFTCAR: int
+        VSWTC: int
+        VSWTCH: int
+        XCASE: int
+        XTABS: int
+
+    if sys.platform != "darwin":
+        B1000000: int
+        B1500000: int
+        B2000000: int
+        B2500000: int
+        B3000000: int
+        B3500000: int
+        B4000000: int
+        B460800: int
+        B500000: int
+        B921600: int
+
+    if sys.platform != "linux":
+        TCSASOFT: int
+
+    if sys.platform != "darwin" and sys.platform != "linux":
+        # not available on FreeBSD either.
+        CDEL: int
+        CEOL2: int
+        CESC: int
+        CNUL: int
+        COMMON: int
+        CSWTCH: int
+        IBSHIFT: int
+        INIT_C_CC: int
+        NSWTCH: int
 
     def tcgetattr(fd: FileDescriptorLike, /) -> _AttrReturn:
         """