basedpyright 1.1.389 → 1.1.392

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

@@ -1,167 +1,167 @@
-from collections.abc import Callable, Iterator, MutableMapping
-from typing import IO, Any
-from typing_extensions import TypeAlias
-
-__all__ = ["dis", "genops", "optimize"]
-
-_Reader: TypeAlias = Callable[[IO[bytes]], Any]
-bytes_types: tuple[type[Any], ...]
-
-UP_TO_NEWLINE: int
-TAKEN_FROM_ARGUMENT1: int
-TAKEN_FROM_ARGUMENT4: int
-TAKEN_FROM_ARGUMENT4U: int
-TAKEN_FROM_ARGUMENT8U: int
-
-class ArgumentDescriptor:
-    name: str
-    n: int
-    reader: _Reader
-    doc: str
-    def __init__(self, name: str, n: int, reader: _Reader, doc: str) -> None: ...
-
-def read_uint1(f: IO[bytes]) -> int: ...
-
-uint1: ArgumentDescriptor
-
-def read_uint2(f: IO[bytes]) -> int: ...
-
-uint2: ArgumentDescriptor
-
-def read_int4(f: IO[bytes]) -> int: ...
-
-int4: ArgumentDescriptor
-
-def read_uint4(f: IO[bytes]) -> int: ...
-
-uint4: ArgumentDescriptor
-
-def read_uint8(f: IO[bytes]) -> int: ...
-
-uint8: ArgumentDescriptor
-
-def read_stringnl(f: IO[bytes], decode: bool = True, stripquotes: bool = True) -> bytes | str: ...
-
-stringnl: ArgumentDescriptor
-
-def read_stringnl_noescape(f: IO[bytes]) -> str: ...
-
-stringnl_noescape: ArgumentDescriptor
-
-def read_stringnl_noescape_pair(f: IO[bytes]) -> str: ...
-
-stringnl_noescape_pair: ArgumentDescriptor
-
-def read_string1(f: IO[bytes]) -> str: ...
-
-string1: ArgumentDescriptor
-
-def read_string4(f: IO[bytes]) -> str: ...
-
-string4: ArgumentDescriptor
-
-def read_bytes1(f: IO[bytes]) -> bytes: ...
-
-bytes1: ArgumentDescriptor
-
-def read_bytes4(f: IO[bytes]) -> bytes: ...
-
-bytes4: ArgumentDescriptor
-
-def read_bytes8(f: IO[bytes]) -> bytes: ...
-
-bytes8: ArgumentDescriptor
-
-def read_unicodestringnl(f: IO[bytes]) -> str: ...
-
-unicodestringnl: ArgumentDescriptor
-
-def read_unicodestring1(f: IO[bytes]) -> str: ...
-
-unicodestring1: ArgumentDescriptor
-
-def read_unicodestring4(f: IO[bytes]) -> str: ...
-
-unicodestring4: ArgumentDescriptor
-
-def read_unicodestring8(f: IO[bytes]) -> str: ...
-
-unicodestring8: ArgumentDescriptor
-
-def read_decimalnl_short(f: IO[bytes]) -> int: ...
-def read_decimalnl_long(f: IO[bytes]) -> int: ...
-
-decimalnl_short: ArgumentDescriptor
-decimalnl_long: ArgumentDescriptor
-
-def read_floatnl(f: IO[bytes]) -> float: ...
-
-floatnl: ArgumentDescriptor
-
-def read_float8(f: IO[bytes]) -> float: ...
-
-float8: ArgumentDescriptor
-
-def read_long1(f: IO[bytes]) -> int: ...
-
-long1: ArgumentDescriptor
-
-def read_long4(f: IO[bytes]) -> int: ...
-
-long4: ArgumentDescriptor
-
-class StackObject:
-    name: str
-    obtype: type[Any] | tuple[type[Any], ...]
-    doc: str
-    def __init__(self, name: str, obtype: type[Any] | tuple[type[Any], ...], doc: str) -> None: ...
-
-pyint: StackObject
-pylong: StackObject
-pyinteger_or_bool: StackObject
-pybool: StackObject
-pyfloat: StackObject
-pybytes_or_str: StackObject
-pystring: StackObject
-pybytes: StackObject
-pyunicode: StackObject
-pynone: StackObject
-pytuple: StackObject
-pylist: StackObject
-pydict: StackObject
-pyset: StackObject
-pyfrozenset: StackObject
-anyobject: StackObject
-markobject: StackObject
-stackslice: StackObject
-
-class OpcodeInfo:
-    name: str
-    code: str
-    arg: ArgumentDescriptor | None
-    stack_before: list[StackObject]
-    stack_after: list[StackObject]
-    proto: int
-    doc: str
-    def __init__(
-        self,
-        name: str,
-        code: str,
-        arg: ArgumentDescriptor | None,
-        stack_before: list[StackObject],
-        stack_after: list[StackObject],
-        proto: int,
-        doc: str,
-    ) -> None: ...
-
-opcodes: list[OpcodeInfo]
-
-def genops(pickle: bytes | bytearray | IO[bytes]) -> Iterator[tuple[OpcodeInfo, Any | None, int | None]]: ...
-def optimize(p: bytes | bytearray | IO[bytes]) -> bytes: ...
-def dis(
-    pickle: bytes | bytearray | IO[bytes],
-    out: IO[str] | None = None,
-    memo: MutableMapping[int, Any] | None = None,
-    indentlevel: int = 4,
-    annotate: int = 0,
-) -> None: ...
+from collections.abc import Callable, Iterator, MutableMapping
+from typing import IO, Any
+from typing_extensions import TypeAlias
+
+__all__ = ["dis", "genops", "optimize"]
+
+_Reader: TypeAlias = Callable[[IO[bytes]], Any]
+bytes_types: tuple[type[Any], ...]
+
+UP_TO_NEWLINE: int
+TAKEN_FROM_ARGUMENT1: int
+TAKEN_FROM_ARGUMENT4: int
+TAKEN_FROM_ARGUMENT4U: int
+TAKEN_FROM_ARGUMENT8U: int
+
+class ArgumentDescriptor:
+    name: str
+    n: int
+    reader: _Reader
+    doc: str
+    def __init__(self, name: str, n: int, reader: _Reader, doc: str) -> None: ...
+
+def read_uint1(f: IO[bytes]) -> int: ...
+
+uint1: ArgumentDescriptor
+
+def read_uint2(f: IO[bytes]) -> int: ...
+
+uint2: ArgumentDescriptor
+
+def read_int4(f: IO[bytes]) -> int: ...
+
+int4: ArgumentDescriptor
+
+def read_uint4(f: IO[bytes]) -> int: ...
+
+uint4: ArgumentDescriptor
+
+def read_uint8(f: IO[bytes]) -> int: ...
+
+uint8: ArgumentDescriptor
+
+def read_stringnl(f: IO[bytes], decode: bool = True, stripquotes: bool = True) -> bytes | str: ...
+
+stringnl: ArgumentDescriptor
+
+def read_stringnl_noescape(f: IO[bytes]) -> str: ...
+
+stringnl_noescape: ArgumentDescriptor
+
+def read_stringnl_noescape_pair(f: IO[bytes]) -> str: ...
+
+stringnl_noescape_pair: ArgumentDescriptor
+
+def read_string1(f: IO[bytes]) -> str: ...
+
+string1: ArgumentDescriptor
+
+def read_string4(f: IO[bytes]) -> str: ...
+
+string4: ArgumentDescriptor
+
+def read_bytes1(f: IO[bytes]) -> bytes: ...
+
+bytes1: ArgumentDescriptor
+
+def read_bytes4(f: IO[bytes]) -> bytes: ...
+
+bytes4: ArgumentDescriptor
+
+def read_bytes8(f: IO[bytes]) -> bytes: ...
+
+bytes8: ArgumentDescriptor
+
+def read_unicodestringnl(f: IO[bytes]) -> str: ...
+
+unicodestringnl: ArgumentDescriptor
+
+def read_unicodestring1(f: IO[bytes]) -> str: ...
+
+unicodestring1: ArgumentDescriptor
+
+def read_unicodestring4(f: IO[bytes]) -> str: ...
+
+unicodestring4: ArgumentDescriptor
+
+def read_unicodestring8(f: IO[bytes]) -> str: ...
+
+unicodestring8: ArgumentDescriptor
+
+def read_decimalnl_short(f: IO[bytes]) -> int: ...
+def read_decimalnl_long(f: IO[bytes]) -> int: ...
+
+decimalnl_short: ArgumentDescriptor
+decimalnl_long: ArgumentDescriptor
+
+def read_floatnl(f: IO[bytes]) -> float: ...
+
+floatnl: ArgumentDescriptor
+
+def read_float8(f: IO[bytes]) -> float: ...
+
+float8: ArgumentDescriptor
+
+def read_long1(f: IO[bytes]) -> int: ...
+
+long1: ArgumentDescriptor
+
+def read_long4(f: IO[bytes]) -> int: ...
+
+long4: ArgumentDescriptor
+
+class StackObject:
+    name: str
+    obtype: type[Any] | tuple[type[Any], ...]
+    doc: str
+    def __init__(self, name: str, obtype: type[Any] | tuple[type[Any], ...], doc: str) -> None: ...
+
+pyint: StackObject
+pylong: StackObject
+pyinteger_or_bool: StackObject
+pybool: StackObject
+pyfloat: StackObject
+pybytes_or_str: StackObject
+pystring: StackObject
+pybytes: StackObject
+pyunicode: StackObject
+pynone: StackObject
+pytuple: StackObject
+pylist: StackObject
+pydict: StackObject
+pyset: StackObject
+pyfrozenset: StackObject
+anyobject: StackObject
+markobject: StackObject
+stackslice: StackObject
+
+class OpcodeInfo:
+    name: str
+    code: str
+    arg: ArgumentDescriptor | None
+    stack_before: list[StackObject]
+    stack_after: list[StackObject]
+    proto: int
+    doc: str
+    def __init__(
+        self,
+        name: str,
+        code: str,
+        arg: ArgumentDescriptor | None,
+        stack_before: list[StackObject],
+        stack_after: list[StackObject],
+        proto: int,
+        doc: str,
+    ) -> None: ...
+
+opcodes: list[OpcodeInfo]
+
+def genops(pickle: bytes | bytearray | IO[bytes]) -> Iterator[tuple[OpcodeInfo, Any | None, int | None]]: ...
+def optimize(p: bytes | bytearray | IO[bytes]) -> bytes: ...
+def dis(
+    pickle: bytes | bytearray | IO[bytes],
+    out: IO[str] | None = None,
+    memo: MutableMapping[int, Any] | None = None,
+    indentlevel: int = 4,
+    annotate: int = 0,
+) -> None: ...

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

@@ -1,53 +1,53 @@
-import sys
-from _typeshed import SupportsRead
-from _typeshed.importlib import LoaderProtocol, MetaPathFinderProtocol, PathEntryFinderProtocol
-from collections.abc import Callable, Iterable, Iterator
-from typing import IO, Any, NamedTuple, TypeVar
-from typing_extensions import deprecated
-
-__all__ = [
-    "get_importer",
-    "iter_importers",
-    "get_loader",
-    "find_loader",
-    "walk_packages",
-    "iter_modules",
-    "get_data",
-    "read_code",
-    "extend_path",
-    "ModuleInfo",
-]
-if sys.version_info < (3, 12):
-    __all__ += ["ImpImporter", "ImpLoader"]
-
-_PathT = TypeVar("_PathT", bound=Iterable[str])
-
-class ModuleInfo(NamedTuple):
-    module_finder: MetaPathFinderProtocol | PathEntryFinderProtocol
-    name: str
-    ispkg: bool
-
-def extend_path(path: _PathT, name: str) -> _PathT: ...
-
-if sys.version_info < (3, 12):
-    class ImpImporter:
-        def __init__(self, path: str | None = None) -> None: ...
-
-    class ImpLoader:
-        def __init__(self, fullname: str, file: IO[str], filename: str, etc: tuple[str, str, int]) -> None: ...
-
-@deprecated("Use importlib.util.find_spec() instead. Will be removed in Python 3.14.")
-def find_loader(fullname: str) -> LoaderProtocol | None: ...
-def get_importer(path_item: str) -> PathEntryFinderProtocol | None: ...
-@deprecated("Use importlib.util.find_spec() instead. Will be removed in Python 3.14.")
-def get_loader(module_or_name: str) -> LoaderProtocol | None: ...
-def iter_importers(fullname: str = "") -> Iterator[MetaPathFinderProtocol | PathEntryFinderProtocol]: ...
-def iter_modules(path: Iterable[str] | None = None, prefix: str = "") -> Iterator[ModuleInfo]: ...
-def read_code(stream: SupportsRead[bytes]) -> Any: ...  # undocumented
-def walk_packages(
-    path: Iterable[str] | None = None, prefix: str = "", onerror: Callable[[str], object] | None = None
-) -> Iterator[ModuleInfo]: ...
-def get_data(package: str, resource: str) -> bytes | None: ...
-
-if sys.version_info >= (3, 9):
-    def resolve_name(name: str) -> Any: ...
+import sys
+from _typeshed import SupportsRead
+from _typeshed.importlib import LoaderProtocol, MetaPathFinderProtocol, PathEntryFinderProtocol
+from collections.abc import Callable, Iterable, Iterator
+from typing import IO, Any, NamedTuple, TypeVar
+from typing_extensions import deprecated
+
+__all__ = [
+    "get_importer",
+    "iter_importers",
+    "get_loader",
+    "find_loader",
+    "walk_packages",
+    "iter_modules",
+    "get_data",
+    "read_code",
+    "extend_path",
+    "ModuleInfo",
+]
+if sys.version_info < (3, 12):
+    __all__ += ["ImpImporter", "ImpLoader"]
+
+_PathT = TypeVar("_PathT", bound=Iterable[str])
+
+class ModuleInfo(NamedTuple):
+    module_finder: MetaPathFinderProtocol | PathEntryFinderProtocol
+    name: str
+    ispkg: bool
+
+def extend_path(path: _PathT, name: str) -> _PathT: ...
+
+if sys.version_info < (3, 12):
+    class ImpImporter:
+        def __init__(self, path: str | None = None) -> None: ...
+
+    class ImpLoader:
+        def __init__(self, fullname: str, file: IO[str], filename: str, etc: tuple[str, str, int]) -> None: ...
+
+@deprecated("Use importlib.util.find_spec() instead. Will be removed in Python 3.14.")
+def find_loader(fullname: str) -> LoaderProtocol | None: ...
+def get_importer(path_item: str) -> PathEntryFinderProtocol | None: ...
+@deprecated("Use importlib.util.find_spec() instead. Will be removed in Python 3.14.")
+def get_loader(module_or_name: str) -> LoaderProtocol | None: ...
+def iter_importers(fullname: str = "") -> Iterator[MetaPathFinderProtocol | PathEntryFinderProtocol]: ...
+def iter_modules(path: Iterable[str] | None = None, prefix: str = "") -> Iterator[ModuleInfo]: ...
+def read_code(stream: SupportsRead[bytes]) -> Any: ...  # undocumented
+def walk_packages(
+    path: Iterable[str] | None = None, prefix: str = "", onerror: Callable[[str], object] | None = None
+) -> Iterator[ModuleInfo]: ...
+def get_data(package: str, resource: str) -> bytes | None: ...
+
+if sys.version_info >= (3, 9):
+    def resolve_name(name: str) -> Any: ...

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

@@ -1,67 +1,97 @@
-import sys
-from typing import NamedTuple
-
-def libc_ver(executable: str | None = None, lib: str = "", version: str = "", chunksize: int = 16384) -> tuple[str, str]: ...
-def win32_ver(release: str = "", version: str = "", csd: str = "", ptype: str = "") -> tuple[str, str, str, str]: ...
-def win32_edition() -> str: ...
-def win32_is_iot() -> bool: ...
-def mac_ver(
-    release: str = "", versioninfo: tuple[str, str, str] = ("", "", ""), machine: str = ""
-) -> tuple[str, tuple[str, str, str], str]: ...
-def java_ver(
-    release: str = "", vendor: str = "", vminfo: tuple[str, str, str] = ("", "", ""), osinfo: tuple[str, str, str] = ("", "", "")
-) -> tuple[str, str, tuple[str, str, str], tuple[str, str, str]]: ...
-def system_alias(system: str, release: str, version: str) -> tuple[str, str, str]: ...
-def architecture(executable: str = sys.executable, bits: str = "", linkage: str = "") -> tuple[str, str]: ...
-
-class uname_result(NamedTuple):
-    system: str
-    node: str
-    release: str
-    version: str
-    machine: str
-    processor: str
-
-def uname() -> uname_result: ...
-def system() -> str: ...
-def node() -> str: ...
-def release() -> str: ...
-def version() -> str: ...
-def machine() -> str: ...
-def processor() -> str: ...
-def python_implementation() -> str: ...
-def python_version() -> str: ...
-def python_version_tuple() -> tuple[str, str, str]: ...
-def python_branch() -> str: ...
-def python_revision() -> str: ...
-def python_build() -> tuple[str, str]: ...
-def python_compiler() -> str: ...
-def platform(aliased: bool = ..., terse: bool = ...) -> str: ...
-
-if sys.version_info >= (3, 10):
-    def freedesktop_os_release() -> dict[str, str]: ...
-
-if sys.version_info >= (3, 13):
-    class AndroidVer(NamedTuple):
-        release: str
-        api_level: int
-        manufacturer: str
-        model: str
-        device: str
-        is_emulator: bool
-
-    class IOSVersionInfo(NamedTuple):
-        system: str
-        release: str
-        model: str
-        is_simulator: bool
-
-    def android_ver(
-        release: str = "",
-        api_level: int = 0,
-        manufacturer: str = "",
-        model: str = "",
-        device: str = "",
-        is_emulator: bool = False,
-    ) -> AndroidVer: ...
-    def ios_ver(system: str = "", release: str = "", model: str = "", is_simulator: bool = False) -> IOSVersionInfo: ...
+import sys
+from typing import NamedTuple, type_check_only
+from typing_extensions import Self
+
+def libc_ver(executable: str | None = None, lib: str = "", version: str = "", chunksize: int = 16384) -> tuple[str, str]: ...
+def win32_ver(release: str = "", version: str = "", csd: str = "", ptype: str = "") -> tuple[str, str, str, str]: ...
+def win32_edition() -> str: ...
+def win32_is_iot() -> bool: ...
+def mac_ver(
+    release: str = "", versioninfo: tuple[str, str, str] = ("", "", ""), machine: str = ""
+) -> tuple[str, tuple[str, str, str], str]: ...
+def java_ver(
+    release: str = "", vendor: str = "", vminfo: tuple[str, str, str] = ("", "", ""), osinfo: tuple[str, str, str] = ("", "", "")
+) -> tuple[str, str, tuple[str, str, str], tuple[str, str, str]]: ...
+def system_alias(system: str, release: str, version: str) -> tuple[str, str, str]: ...
+def architecture(executable: str = sys.executable, bits: str = "", linkage: str = "") -> tuple[str, str]: ...
+
+if sys.version_info >= (3, 9):
+    # This class is not exposed. It calls itself platform.uname_result_base.
+    # At runtime it only has 5 fields.
+    @type_check_only
+    class _uname_result_base(NamedTuple):
+        system: str
+        node: str
+        release: str
+        version: str
+        machine: str
+        # This base class doesn't have this field at runtime, but claiming it
+        # does is the least bad way to handle the situation. Nobody really
+        # sees this class anyway. See #13068
+        processor: str
+
+    # uname_result emulates a 6-field named tuple, but the processor field
+    # is lazily evaluated rather than being passed in to the constructor.
+    class uname_result(_uname_result_base):
+        if sys.version_info >= (3, 10):
+            __match_args__ = ("system", "node", "release", "version", "machine")  # pyright: ignore[reportAssignmentType]
+
+        def __new__(_cls, system: str, node: str, release: str, version: str, machine: str) -> Self:
+            """Create new instance of uname_result_base(system, node, release, version, machine)"""
+            ...
+        @property
+        def processor(self) -> str: ...
+
+else:
+    # On 3.8, uname_result is actually just a regular NamedTuple.
+    class uname_result(NamedTuple):
+        system: str
+        node: str
+        release: str
+        version: str
+        machine: str
+        processor: str
+
+def uname() -> uname_result: ...
+def system() -> str: ...
+def node() -> str: ...
+def release() -> str: ...
+def version() -> str: ...
+def machine() -> str: ...
+def processor() -> str: ...
+def python_implementation() -> str: ...
+def python_version() -> str: ...
+def python_version_tuple() -> tuple[str, str, str]: ...
+def python_branch() -> str: ...
+def python_revision() -> str: ...
+def python_build() -> tuple[str, str]: ...
+def python_compiler() -> str: ...
+def platform(aliased: bool = ..., terse: bool = ...) -> str: ...
+
+if sys.version_info >= (3, 10):
+    def freedesktop_os_release() -> dict[str, str]: ...
+
+if sys.version_info >= (3, 13):
+    class AndroidVer(NamedTuple):
+        release: str
+        api_level: int
+        manufacturer: str
+        model: str
+        device: str
+        is_emulator: bool
+
+    class IOSVersionInfo(NamedTuple):
+        system: str
+        release: str
+        model: str
+        is_simulator: bool
+
+    def android_ver(
+        release: str = "",
+        api_level: int = 0,
+        manufacturer: str = "",
+        model: str = "",
+        device: str = "",
+        is_emulator: bool = False,
+    ) -> AndroidVer: ...
+    def ios_ver(system: str = "", release: str = "", model: str = "", is_simulator: bool = False) -> IOSVersionInfo: ...