basedpyright 1.1.389 → 1.1.392

package/dist/typeshed-fallback/stdlib/zipfile/_path.pyi

@@ -1,101 +1,103 @@
-import sys
-from _typeshed import StrPath
-from collections.abc import Iterator, Sequence
-from io import TextIOWrapper
-from os import PathLike
-from typing import IO, Literal, TypeVar, overload
-from typing_extensions import Self, TypeAlias
-from zipfile import ZipFile
-
-_ReadWriteBinaryMode: TypeAlias = Literal["r", "w", "rb", "wb"]
-
-_ZF = TypeVar("_ZF", bound=ZipFile)
-
-if sys.version_info >= (3, 12):
-    class InitializedState:
-        def __init__(self, *args: object, **kwargs: object) -> None: ...
-        def __getstate__(self) -> tuple[list[object], dict[object, object]]: ...
-        def __setstate__(self, state: Sequence[tuple[list[object], dict[object, object]]]) -> None: ...
-
-    class CompleteDirs(InitializedState, ZipFile):
-        def resolve_dir(self, name: str) -> str: ...
-        @overload
-        @classmethod
-        def make(cls, source: ZipFile) -> CompleteDirs: ...
-        @overload
-        @classmethod
-        def make(cls, source: StrPath | IO[bytes]) -> Self: ...
-        if sys.version_info >= (3, 13):
-            @classmethod
-            def inject(cls, zf: _ZF) -> _ZF: ...
-
-    class Path:
-        root: CompleteDirs
-        at: str
-        def __init__(self, root: ZipFile | StrPath | IO[bytes], at: str = "") -> None: ...
-        @property
-        def name(self) -> str: ...
-        @property
-        def parent(self) -> PathLike[str]: ...  # undocumented
-        if sys.version_info >= (3, 10):
-            @property
-            def filename(self) -> PathLike[str]: ...  # undocumented
-        if sys.version_info >= (3, 11):
-            @property
-            def suffix(self) -> str: ...
-            @property
-            def suffixes(self) -> list[str]: ...
-            @property
-            def stem(self) -> str: ...
-
-        if sys.version_info >= (3, 9):
-            @overload
-            def open(
-                self,
-                mode: Literal["r", "w"] = "r",
-                encoding: str | None = None,
-                errors: str | None = None,
-                newline: str | None = None,
-                line_buffering: bool = ...,
-                write_through: bool = ...,
-                *,
-                pwd: bytes | None = None,
-            ) -> TextIOWrapper: ...
-            @overload
-            def open(self, mode: Literal["rb", "wb"], *, pwd: bytes | None = None) -> IO[bytes]: ...
-        else:
-            def open(
-                self, mode: _ReadWriteBinaryMode = "r", pwd: bytes | None = None, *, force_zip64: bool = False
-            ) -> IO[bytes]: ...
-
-        if sys.version_info >= (3, 10):
-            def iterdir(self) -> Iterator[Self]: ...
-        else:
-            def iterdir(self) -> Iterator[Path]: ...
-
-        def is_dir(self) -> bool: ...
-        def is_file(self) -> bool: ...
-        def exists(self) -> bool: ...
-        def read_text(
-            self,
-            encoding: str | None = ...,
-            errors: str | None = ...,
-            newline: str | None = ...,
-            line_buffering: bool = ...,
-            write_through: bool = ...,
-        ) -> str: ...
-        def read_bytes(self) -> bytes: ...
-        if sys.version_info >= (3, 10):
-            def joinpath(self, *other: StrPath) -> Path: ...
-        else:
-            def joinpath(self, add: StrPath) -> Path: ...  # undocumented
-        if sys.version_info >= (3, 12):
-            def glob(self, pattern: str) -> Iterator[Self]: ...
-            def rglob(self, pattern: str) -> Iterator[Self]: ...
-            def is_symlink(self) -> Literal[False]: ...
-            def relative_to(self, other: Path, *extra: StrPath) -> str: ...
-            def match(self, path_pattern: str) -> bool: ...
-            def __eq__(self, other: object) -> bool: ...
-            def __hash__(self) -> int: ...
-
-        def __truediv__(self, add: StrPath) -> Path: ...
+import sys
+from _typeshed import StrPath
+from collections.abc import Iterator, Sequence
+from io import TextIOWrapper
+from os import PathLike
+from typing import IO, Literal, TypeVar, overload
+from typing_extensions import Self, TypeAlias
+from zipfile import ZipFile
+
+_ReadWriteBinaryMode: TypeAlias = Literal["r", "w", "rb", "wb"]
+
+_ZF = TypeVar("_ZF", bound=ZipFile)
+
+if sys.version_info >= (3, 12):
+    __all__ = ["Path"]
+
+    class InitializedState:
+        def __init__(self, *args: object, **kwargs: object) -> None: ...
+        def __getstate__(self) -> tuple[list[object], dict[object, object]]: ...
+        def __setstate__(self, state: Sequence[tuple[list[object], dict[object, object]]]) -> None: ...
+
+    class CompleteDirs(InitializedState, ZipFile):
+        def resolve_dir(self, name: str) -> str: ...
+        @overload
+        @classmethod
+        def make(cls, source: ZipFile) -> CompleteDirs: ...
+        @overload
+        @classmethod
+        def make(cls, source: StrPath | IO[bytes]) -> Self: ...
+        if sys.version_info >= (3, 13):
+            @classmethod
+            def inject(cls, zf: _ZF) -> _ZF: ...
+
+    class Path:
+        root: CompleteDirs
+        at: str
+        def __init__(self, root: ZipFile | StrPath | IO[bytes], at: str = "") -> None: ...
+        @property
+        def name(self) -> str: ...
+        @property
+        def parent(self) -> PathLike[str]: ...  # undocumented
+        if sys.version_info >= (3, 10):
+            @property
+            def filename(self) -> PathLike[str]: ...  # undocumented
+        if sys.version_info >= (3, 11):
+            @property
+            def suffix(self) -> str: ...
+            @property
+            def suffixes(self) -> list[str]: ...
+            @property
+            def stem(self) -> str: ...
+
+        if sys.version_info >= (3, 9):
+            @overload
+            def open(
+                self,
+                mode: Literal["r", "w"] = "r",
+                encoding: str | None = None,
+                errors: str | None = None,
+                newline: str | None = None,
+                line_buffering: bool = ...,
+                write_through: bool = ...,
+                *,
+                pwd: bytes | None = None,
+            ) -> TextIOWrapper: ...
+            @overload
+            def open(self, mode: Literal["rb", "wb"], *, pwd: bytes | None = None) -> IO[bytes]: ...
+        else:
+            def open(
+                self, mode: _ReadWriteBinaryMode = "r", pwd: bytes | None = None, *, force_zip64: bool = False
+            ) -> IO[bytes]: ...
+
+        if sys.version_info >= (3, 10):
+            def iterdir(self) -> Iterator[Self]: ...
+        else:
+            def iterdir(self) -> Iterator[Path]: ...
+
+        def is_dir(self) -> bool: ...
+        def is_file(self) -> bool: ...
+        def exists(self) -> bool: ...
+        def read_text(
+            self,
+            encoding: str | None = ...,
+            errors: str | None = ...,
+            newline: str | None = ...,
+            line_buffering: bool = ...,
+            write_through: bool = ...,
+        ) -> str: ...
+        def read_bytes(self) -> bytes: ...
+        if sys.version_info >= (3, 10):
+            def joinpath(self, *other: StrPath) -> Path: ...
+        else:
+            def joinpath(self, add: StrPath) -> Path: ...  # undocumented
+        if sys.version_info >= (3, 12):
+            def glob(self, pattern: str) -> Iterator[Self]: ...
+            def rglob(self, pattern: str) -> Iterator[Self]: ...
+            def is_symlink(self) -> Literal[False]: ...
+            def relative_to(self, other: Path, *extra: StrPath) -> str: ...
+            def match(self, path_pattern: str) -> bool: ...
+            def __eq__(self, other: object) -> bool: ...
+            def __hash__(self) -> int: ...
+
+        def __truediv__(self, add: StrPath) -> Path: ...

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

@@ -1,70 +1,41 @@
-"""
-zipimport provides support for importing Python modules from Zip archives.
-
-This module exports three objects:
-- zipimporter: a class; its constructor takes a path to a Zip archive.
-- ZipImportError: exception raised by zipimporter objects. It's a
-  subclass of ImportError, so it can be caught as ImportError, too.
-- _zip_directory_cache: a dict, mapping archive paths to zip directory
-  info dicts, as used in zipimporter._files.
-
-It is usually not needed to use the zipimport module explicitly; it is
-used by the builtin import mechanism for sys.path items that are paths
-to Zip archives.
-"""
-
-import sys
-from _typeshed import StrOrBytesPath
-from importlib.abc import ResourceReader
-from importlib.machinery import ModuleSpec
-from types import CodeType, ModuleType
-from typing_extensions import deprecated
-
-if sys.version_info >= (3, 10):
-    from _frozen_importlib_external import _LoaderBasics
-else:
-    _LoaderBasics = object
-
-__all__ = ["ZipImportError", "zipimporter"]
-
-class ZipImportError(ImportError): ...
-
-class zipimporter(_LoaderBasics):
-    """
-    zipimporter(archivepath) -> zipimporter object
-
-    Create a new zipimporter instance. 'archivepath' must be a path to
-    a zipfile, or to a specific path inside a zipfile. For example, it can be
-    '/tmp/myimport.zip', or '/tmp/myimport.zip/mydirectory', if mydirectory is a
-    valid directory inside the archive.
-
-    'ZipImportError is raised if 'archivepath' doesn't point to a valid Zip
-    archive.
-
-    The 'archive' attribute of zipimporter objects contains the name of the
-    zipfile targeted.
-    """
-    archive: str
-    prefix: str
-    if sys.version_info >= (3, 11):
-        def __init__(self, path: str) -> None: ...
-    else:
-        def __init__(self, path: StrOrBytesPath) -> None: ...
-
-    if sys.version_info < (3, 12):
-        def find_loader(self, fullname: str, path: str | None = None) -> tuple[zipimporter | None, list[str]]: ...  # undocumented
-        def find_module(self, fullname: str, path: str | None = None) -> zipimporter | None: ...
-
-    def get_code(self, fullname: str) -> CodeType: ...
-    def get_data(self, pathname: str) -> bytes: ...
-    def get_filename(self, fullname: str) -> str: ...
-    def get_resource_reader(self, fullname: str) -> ResourceReader | None: ...  # undocumented
-    def get_source(self, fullname: str) -> str | None: ...
-    def is_package(self, fullname: str) -> bool: ...
-    @deprecated("Deprecated since 3.10; use exec_module() instead")
-    def load_module(self, fullname: str) -> ModuleType: ...
-    if sys.version_info >= (3, 10):
-        def exec_module(self, module: ModuleType) -> None: ...
-        def create_module(self, spec: ModuleSpec) -> None: ...
-        def find_spec(self, fullname: str, target: ModuleType | None = None) -> ModuleSpec | None: ...
-        def invalidate_caches(self) -> None: ...
+import sys
+from _typeshed import StrOrBytesPath
+from importlib.abc import ResourceReader
+from importlib.machinery import ModuleSpec
+from types import CodeType, ModuleType
+from typing_extensions import deprecated
+
+if sys.version_info >= (3, 10):
+    from _frozen_importlib_external import _LoaderBasics
+else:
+    _LoaderBasics = object
+
+__all__ = ["ZipImportError", "zipimporter"]
+
+class ZipImportError(ImportError): ...
+
+class zipimporter(_LoaderBasics):
+    archive: str
+    prefix: str
+    if sys.version_info >= (3, 11):
+        def __init__(self, path: str) -> None: ...
+    else:
+        def __init__(self, path: StrOrBytesPath) -> None: ...
+
+    if sys.version_info < (3, 12):
+        def find_loader(self, fullname: str, path: str | None = None) -> tuple[zipimporter | None, list[str]]: ...  # undocumented
+        def find_module(self, fullname: str, path: str | None = None) -> zipimporter | None: ...
+
+    def get_code(self, fullname: str) -> CodeType: ...
+    def get_data(self, pathname: str) -> bytes: ...
+    def get_filename(self, fullname: str) -> str: ...
+    def get_resource_reader(self, fullname: str) -> ResourceReader | None: ...  # undocumented
+    def get_source(self, fullname: str) -> str | None: ...
+    def is_package(self, fullname: str) -> bool: ...
+    @deprecated("Deprecated since 3.10; use exec_module() instead")
+    def load_module(self, fullname: str) -> ModuleType: ...
+    if sys.version_info >= (3, 10):
+        def exec_module(self, module: ModuleType) -> None: ...
+        def create_module(self, spec: ModuleSpec) -> None: ...
+        def find_spec(self, fullname: str, target: ModuleType | None = None) -> ModuleSpec | None: ...
+        def invalidate_caches(self) -> None: ...

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

@@ -1,157 +1,162 @@
-"""
-The functions in this module allow compression and decompression using the
-zlib library, which is based on GNU zip.
-
-adler32(string[, start]) -- Compute an Adler-32 checksum.
-compress(data[, level]) -- Compress data, with compression level 0-9 or -1.
-compressobj([level[, ...]]) -- Return a compressor object.
-crc32(string[, start]) -- Compute a CRC-32 checksum.
-decompress(string,[wbits],[bufsize]) -- Decompresses a compressed string.
-decompressobj([wbits[, zdict]]) -- Return a decompressor object.
-
-'wbits' is window buffer size and container format.
-Compressor objects support compress() and flush() methods; decompressor
-objects support decompress() and flush().
-"""
-
-import sys
-from _typeshed import ReadableBuffer
-from typing import Final
-
-DEFLATED: Final = 8
-DEF_MEM_LEVEL: int  # can change
-DEF_BUF_SIZE: Final = 16384
-MAX_WBITS: int
-ZLIB_VERSION: str  # can change
-ZLIB_RUNTIME_VERSION: str  # can change
-Z_NO_COMPRESSION: Final = 0
-Z_PARTIAL_FLUSH: Final = 1
-Z_BEST_COMPRESSION: Final = 9
-Z_BEST_SPEED: Final = 1
-Z_BLOCK: Final = 5
-Z_DEFAULT_COMPRESSION: Final = -1
-Z_DEFAULT_STRATEGY: Final = 0
-Z_FILTERED: Final = 1
-Z_FINISH: Final = 4
-Z_FIXED: Final = 4
-Z_FULL_FLUSH: Final = 3
-Z_HUFFMAN_ONLY: Final = 2
-Z_NO_FLUSH: Final = 0
-Z_RLE: Final = 3
-Z_SYNC_FLUSH: Final = 2
-Z_TREES: Final = 6
-
-class error(Exception): ...
-
-class _Compress:
-    def compress(self, data: ReadableBuffer) -> bytes: ...
-    def flush(self, mode: int = ...) -> bytes: ...
-    def copy(self) -> _Compress: ...
-
-class _Decompress:
-    unused_data: bytes
-    unconsumed_tail: bytes
-    eof: bool
-    def decompress(self, data: ReadableBuffer, max_length: int = ...) -> bytes: ...
-    def flush(self, length: int = ...) -> bytes: ...
-    def copy(self) -> _Decompress: ...
-
-def adler32(data: ReadableBuffer, value: int = 1, /) -> int:
-    """
-    Compute an Adler-32 checksum of data.
-
-      value
-        Starting value of the checksum.
-
-    The returned checksum is an integer.
-    """
-    ...
-
-if sys.version_info >= (3, 11):
-    def compress(data: ReadableBuffer, /, level: int = -1, wbits: int = 15) -> bytes:
-        """
-        Returns a bytes object containing compressed data.
-
-        data
-          Binary data to be compressed.
-        level
-          Compression level, in 0-9 or -1.
-        wbits
-          The window buffer size and container format.
-        """
-        ...
-
-else:
-    def compress(data: ReadableBuffer, /, level: int = -1) -> bytes:
-        """
-        Returns a bytes object containing compressed data.
-
-        data
-          Binary data to be compressed.
-        level
-          Compression level, in 0-9 or -1.
-        """
-        ...
-
-def compressobj(
-    level: int = -1, method: int = 8, wbits: int = 15, memLevel: int = 8, strategy: int = 0, zdict: ReadableBuffer | None = None
-) -> _Compress:
-    """
-    Return a compressor object.
-
-    level
-      The compression level (an integer in the range 0-9 or -1; default is
-      currently equivalent to 6).  Higher compression levels are slower,
-      but produce smaller results.
-    method
-      The compression algorithm.  If given, this must be DEFLATED.
-    wbits
-      +9 to +15: The base-two logarithm of the window size.  Include a zlib
-          container.
-      -9 to -15: Generate a raw stream.
-      +25 to +31: Include a gzip container.
-    memLevel
-      Controls the amount of memory used for internal compression state.
-      Valid values range from 1 to 9.  Higher values result in higher memory
-      usage, faster compression, and smaller output.
-    strategy
-      Used to tune the compression algorithm.  Possible values are
-      Z_DEFAULT_STRATEGY, Z_FILTERED, and Z_HUFFMAN_ONLY.
-    zdict
-      The predefined compression dictionary - a sequence of bytes
-      containing subsequences that are likely to occur in the input data.
-    """
-    ...
-def crc32(data: ReadableBuffer, value: int = 0, /) -> int:
-    """
-    Compute a CRC-32 checksum of data.
-
-      value
-        Starting value of the checksum.
-
-    The returned checksum is an integer.
-    """
-    ...
-def decompress(data: ReadableBuffer, /, wbits: int = 15, bufsize: int = 16384) -> bytes:
-    """
-    Returns a bytes object containing the uncompressed data.
-
-    data
-      Compressed data.
-    wbits
-      The window buffer size and container format.
-    bufsize
-      The initial output buffer size.
-    """
-    ...
-def decompressobj(wbits: int = 15, zdict: ReadableBuffer = b"") -> _Decompress:
-    """
-    Return a decompressor object.
-
-    wbits
-      The window buffer size and container format.
-    zdict
-      The predefined compression dictionary.  This must be the same
-      dictionary as used by the compressor that produced the input data.
-    """
-    ...
+"""
+The functions in this module allow compression and decompression using the
+zlib library, which is based on GNU zip.
+
+adler32(string[, start]) -- Compute an Adler-32 checksum.
+compress(data[, level]) -- Compress data, with compression level 0-9 or -1.
+compressobj([level[, ...]]) -- Return a compressor object.
+crc32(string[, start]) -- Compute a CRC-32 checksum.
+decompress(string,[wbits],[bufsize]) -- Decompresses a compressed string.
+decompressobj([wbits[, zdict]]) -- Return a decompressor object.
+
+'wbits' is window buffer size and container format.
+Compressor objects support compress() and flush() methods; decompressor
+objects support decompress() and flush().
+"""
+
+import sys
+from _typeshed import ReadableBuffer
+from typing import Any, Final, final, type_check_only
+from typing_extensions import Self
+
+DEFLATED: Final = 8
+DEF_MEM_LEVEL: int  # can change
+DEF_BUF_SIZE: Final = 16384
+MAX_WBITS: int
+ZLIB_VERSION: str  # can change
+ZLIB_RUNTIME_VERSION: str  # can change
+Z_NO_COMPRESSION: Final = 0
+Z_PARTIAL_FLUSH: Final = 1
+Z_BEST_COMPRESSION: Final = 9
+Z_BEST_SPEED: Final = 1
+Z_BLOCK: Final = 5
+Z_DEFAULT_COMPRESSION: Final = -1
+Z_DEFAULT_STRATEGY: Final = 0
+Z_FILTERED: Final = 1
+Z_FINISH: Final = 4
+Z_FIXED: Final = 4
+Z_FULL_FLUSH: Final = 3
+Z_HUFFMAN_ONLY: Final = 2
+Z_NO_FLUSH: Final = 0
+Z_RLE: Final = 3
+Z_SYNC_FLUSH: Final = 2
+Z_TREES: Final = 6
+
+class error(Exception): ...
+
+# This class is not exposed at runtime. It calls itself zlib.Compress.
+@final
+@type_check_only
+class _Compress:
+    def __copy__(self) -> Self: ...
+    def __deepcopy__(self, memo: Any, /) -> Self: ...
+    def compress(self, data: ReadableBuffer, /) -> bytes: ...
+    def flush(self, mode: int = 4, /) -> bytes: ...
+    def copy(self) -> _Compress: ...
+
+# This class is not exposed at runtime. It calls itself zlib.Decompress.
+@final
+@type_check_only
+class _Decompress:
+    @property
+    def unused_data(self) -> bytes: ...
+    @property
+    def unconsumed_tail(self) -> bytes: ...
+    @property
+    def eof(self) -> bool: ...
+    def __copy__(self) -> Self: ...
+    def __deepcopy__(self, memo: Any, /) -> Self: ...
+    def decompress(self, data: ReadableBuffer, /, max_length: int = 0) -> bytes: ...
+    def flush(self, length: int = 16384, /) -> bytes: ...
+    def copy(self) -> _Decompress: ...
+
+def adler32(data: ReadableBuffer, value: int = 1, /) -> int:
+    """
+    Compute an Adler-32 checksum of data.
+
+      value
+        Starting value of the checksum.
+
+    The returned checksum is an integer.
+    """
+    ...
+
+if sys.version_info >= (3, 11):
+    def compress(data: ReadableBuffer, /, level: int = -1, wbits: int = 15) -> bytes:
+        """
+        Returns a bytes object containing compressed data.
+
+        data
+          Binary data to be compressed.
+        level
+          Compression level, in 0-9 or -1.
+        wbits
+          The window buffer size and container format.
+        """
+        ...
+
+else:
+    def compress(data: ReadableBuffer, /, level: int = -1) -> bytes: ...
+
+def compressobj(
+    level: int = -1, method: int = 8, wbits: int = 15, memLevel: int = 8, strategy: int = 0, zdict: ReadableBuffer | None = None
+) -> _Compress:
+    """
+    Return a compressor object.
+
+    level
+      The compression level (an integer in the range 0-9 or -1; default is
+      currently equivalent to 6).  Higher compression levels are slower,
+      but produce smaller results.
+    method
+      The compression algorithm.  If given, this must be DEFLATED.
+    wbits
+      +9 to +15: The base-two logarithm of the window size.  Include a zlib
+          container.
+      -9 to -15: Generate a raw stream.
+      +25 to +31: Include a gzip container.
+    memLevel
+      Controls the amount of memory used for internal compression state.
+      Valid values range from 1 to 9.  Higher values result in higher memory
+      usage, faster compression, and smaller output.
+    strategy
+      Used to tune the compression algorithm.  Possible values are
+      Z_DEFAULT_STRATEGY, Z_FILTERED, and Z_HUFFMAN_ONLY.
+    zdict
+      The predefined compression dictionary - a sequence of bytes
+      containing subsequences that are likely to occur in the input data.
+    """
+    ...
+def crc32(data: ReadableBuffer, value: int = 0, /) -> int:
+    """
+    Compute a CRC-32 checksum of data.
+
+      value
+        Starting value of the checksum.
+
+    The returned checksum is an integer.
+    """
+    ...
+def decompress(data: ReadableBuffer, /, wbits: int = 15, bufsize: int = 16384) -> bytes:
+    """
+    Returns a bytes object containing the uncompressed data.
+
+    data
+      Compressed data.
+    wbits
+      The window buffer size and container format.
+    bufsize
+      The initial output buffer size.
+    """
+    ...
+def decompressobj(wbits: int = 15, zdict: ReadableBuffer = b"") -> _Decompress:
+    """
+    Return a decompressor object.
+
+    wbits
+      The window buffer size and container format.
+    zdict
+      The predefined compression dictionary.  This must be the same
+      dictionary as used by the compressor that produced the input data.
+    """
+    ...