basedpyright 1.1.389 → 1.1.392

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

@@ -1,162 +1,162 @@
-import _compression
-import sys
-import zlib
-from _typeshed import ReadableBuffer, SizedBuffer, StrOrBytesPath
-from io import FileIO
-from typing import Final, Literal, Protocol, TextIO, overload
-from typing_extensions import TypeAlias
-
-__all__ = ["BadGzipFile", "GzipFile", "open", "compress", "decompress"]
-
-_ReadBinaryMode: TypeAlias = Literal["r", "rb"]
-_WriteBinaryMode: TypeAlias = Literal["a", "ab", "w", "wb", "x", "xb"]
-_OpenTextMode: TypeAlias = Literal["rt", "at", "wt", "xt"]
-
-READ: Final[object]  # undocumented
-WRITE: Final[object]  # undocumented
-
-FTEXT: Final[int]  # actually Literal[1] # undocumented
-FHCRC: Final[int]  # actually Literal[2] # undocumented
-FEXTRA: Final[int]  # actually Literal[4] # undocumented
-FNAME: Final[int]  # actually Literal[8] # undocumented
-FCOMMENT: Final[int]  # actually Literal[16] # undocumented
-
-class _ReadableFileobj(Protocol):
-    def read(self, n: int, /) -> bytes: ...
-    def seek(self, n: int, /) -> object: ...
-    # The following attributes and methods are optional:
-    # name: str
-    # mode: str
-    # def fileno() -> int: ...
-
-class _WritableFileobj(Protocol):
-    def write(self, b: bytes, /) -> object: ...
-    def flush(self) -> object: ...
-    # The following attributes and methods are optional:
-    # name: str
-    # mode: str
-    # def fileno() -> int: ...
-
-@overload
-def open(
-    filename: StrOrBytesPath | _ReadableFileobj,
-    mode: _ReadBinaryMode = "rb",
-    compresslevel: int = 9,
-    encoding: None = None,
-    errors: None = None,
-    newline: None = None,
-) -> GzipFile: ...
-@overload
-def open(
-    filename: StrOrBytesPath | _WritableFileobj,
-    mode: _WriteBinaryMode,
-    compresslevel: int = 9,
-    encoding: None = None,
-    errors: None = None,
-    newline: None = None,
-) -> GzipFile: ...
-@overload
-def open(
-    filename: StrOrBytesPath,
-    mode: _OpenTextMode,
-    compresslevel: int = 9,
-    encoding: str | None = None,
-    errors: str | None = None,
-    newline: str | None = None,
-) -> TextIO: ...
-@overload
-def open(
-    filename: StrOrBytesPath | _ReadableFileobj | _WritableFileobj,
-    mode: str,
-    compresslevel: int = 9,
-    encoding: str | None = None,
-    errors: str | None = None,
-    newline: str | None = None,
-) -> GzipFile | TextIO: ...
-
-class _PaddedFile:
-    file: _ReadableFileobj
-    def __init__(self, f: _ReadableFileobj, prepend: bytes = b"") -> None: ...
-    def read(self, size: int) -> bytes: ...
-    def prepend(self, prepend: bytes = b"") -> None: ...
-    def seek(self, off: int) -> int: ...
-    def seekable(self) -> bool: ...
-
-class BadGzipFile(OSError): ...
-
-class GzipFile(_compression.BaseStream):
-    myfileobj: FileIO | None
-    mode: object
-    name: str
-    compress: zlib._Compress
-    fileobj: _ReadableFileobj | _WritableFileobj
-    @overload
-    def __init__(
-        self,
-        filename: StrOrBytesPath | None,
-        mode: _ReadBinaryMode,
-        compresslevel: int = 9,
-        fileobj: _ReadableFileobj | None = None,
-        mtime: float | None = None,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        *,
-        mode: _ReadBinaryMode,
-        compresslevel: int = 9,
-        fileobj: _ReadableFileobj | None = None,
-        mtime: float | None = None,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        filename: StrOrBytesPath | None,
-        mode: _WriteBinaryMode,
-        compresslevel: int = 9,
-        fileobj: _WritableFileobj | None = None,
-        mtime: float | None = None,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        *,
-        mode: _WriteBinaryMode,
-        compresslevel: int = 9,
-        fileobj: _WritableFileobj | None = None,
-        mtime: float | None = None,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        filename: StrOrBytesPath | None = None,
-        mode: str | None = None,
-        compresslevel: int = 9,
-        fileobj: _ReadableFileobj | _WritableFileobj | None = None,
-        mtime: float | None = None,
-    ) -> None: ...
-    if sys.version_info < (3, 12):
-        @property
-        def filename(self) -> str: ...
-
-    @property
-    def mtime(self) -> int | None:
-        """Last modification time read from stream, or None"""
-        ...
-    crc: int
-    def write(self, data: ReadableBuffer) -> int: ...
-    def read(self, size: int | None = -1) -> bytes: ...
-    def read1(self, size: int = -1) -> bytes: ...
-    def peek(self, n: int) -> bytes: ...
-    def close(self) -> None: ...
-    def flush(self, zlib_mode: int = 2) -> None: ...
-    def fileno(self) -> int: ...
-    def rewind(self) -> None: ...
-    def seek(self, offset: int, whence: int = 0) -> int: ...
-    def readline(self, size: int | None = -1) -> bytes: ...
-
-class _GzipReader(_compression.DecompressReader):
-    def __init__(self, fp: _ReadableFileobj) -> None: ...
-
-def compress(data: SizedBuffer, compresslevel: int = 9, *, mtime: float | None = None) -> bytes: ...
-def decompress(data: ReadableBuffer) -> bytes: ...
+import _compression
+import sys
+import zlib
+from _typeshed import ReadableBuffer, SizedBuffer, StrOrBytesPath
+from io import FileIO
+from typing import Final, Literal, Protocol, TextIO, overload
+from typing_extensions import TypeAlias
+
+__all__ = ["BadGzipFile", "GzipFile", "open", "compress", "decompress"]
+
+_ReadBinaryMode: TypeAlias = Literal["r", "rb"]
+_WriteBinaryMode: TypeAlias = Literal["a", "ab", "w", "wb", "x", "xb"]
+_OpenTextMode: TypeAlias = Literal["rt", "at", "wt", "xt"]
+
+READ: Final[object]  # undocumented
+WRITE: Final[object]  # undocumented
+
+FTEXT: Final[int]  # actually Literal[1] # undocumented
+FHCRC: Final[int]  # actually Literal[2] # undocumented
+FEXTRA: Final[int]  # actually Literal[4] # undocumented
+FNAME: Final[int]  # actually Literal[8] # undocumented
+FCOMMENT: Final[int]  # actually Literal[16] # undocumented
+
+class _ReadableFileobj(Protocol):
+    def read(self, n: int, /) -> bytes: ...
+    def seek(self, n: int, /) -> object: ...
+    # The following attributes and methods are optional:
+    # name: str
+    # mode: str
+    # def fileno() -> int: ...
+
+class _WritableFileobj(Protocol):
+    def write(self, b: bytes, /) -> object: ...
+    def flush(self) -> object: ...
+    # The following attributes and methods are optional:
+    # name: str
+    # mode: str
+    # def fileno() -> int: ...
+
+@overload
+def open(
+    filename: StrOrBytesPath | _ReadableFileobj,
+    mode: _ReadBinaryMode = "rb",
+    compresslevel: int = 9,
+    encoding: None = None,
+    errors: None = None,
+    newline: None = None,
+) -> GzipFile: ...
+@overload
+def open(
+    filename: StrOrBytesPath | _WritableFileobj,
+    mode: _WriteBinaryMode,
+    compresslevel: int = 9,
+    encoding: None = None,
+    errors: None = None,
+    newline: None = None,
+) -> GzipFile: ...
+@overload
+def open(
+    filename: StrOrBytesPath,
+    mode: _OpenTextMode,
+    compresslevel: int = 9,
+    encoding: str | None = None,
+    errors: str | None = None,
+    newline: str | None = None,
+) -> TextIO: ...
+@overload
+def open(
+    filename: StrOrBytesPath | _ReadableFileobj | _WritableFileobj,
+    mode: str,
+    compresslevel: int = 9,
+    encoding: str | None = None,
+    errors: str | None = None,
+    newline: str | None = None,
+) -> GzipFile | TextIO: ...
+
+class _PaddedFile:
+    file: _ReadableFileobj
+    def __init__(self, f: _ReadableFileobj, prepend: bytes = b"") -> None: ...
+    def read(self, size: int) -> bytes: ...
+    def prepend(self, prepend: bytes = b"") -> None: ...
+    def seek(self, off: int) -> int: ...
+    def seekable(self) -> bool: ...
+
+class BadGzipFile(OSError): ...
+
+class GzipFile(_compression.BaseStream):
+    myfileobj: FileIO | None
+    mode: object
+    name: str
+    compress: zlib._Compress
+    fileobj: _ReadableFileobj | _WritableFileobj
+    @overload
+    def __init__(
+        self,
+        filename: StrOrBytesPath | None,
+        mode: _ReadBinaryMode,
+        compresslevel: int = 9,
+        fileobj: _ReadableFileobj | None = None,
+        mtime: float | None = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        *,
+        mode: _ReadBinaryMode,
+        compresslevel: int = 9,
+        fileobj: _ReadableFileobj | None = None,
+        mtime: float | None = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        filename: StrOrBytesPath | None,
+        mode: _WriteBinaryMode,
+        compresslevel: int = 9,
+        fileobj: _WritableFileobj | None = None,
+        mtime: float | None = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        *,
+        mode: _WriteBinaryMode,
+        compresslevel: int = 9,
+        fileobj: _WritableFileobj | None = None,
+        mtime: float | None = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        filename: StrOrBytesPath | None = None,
+        mode: str | None = None,
+        compresslevel: int = 9,
+        fileobj: _ReadableFileobj | _WritableFileobj | None = None,
+        mtime: float | None = None,
+    ) -> None: ...
+    if sys.version_info < (3, 12):
+        @property
+        def filename(self) -> str: ...
+
+    @property
+    def mtime(self) -> int | None:
+        """Last modification time read from stream, or None"""
+        ...
+    crc: int
+    def write(self, data: ReadableBuffer) -> int: ...
+    def read(self, size: int | None = -1) -> bytes: ...
+    def read1(self, size: int = -1) -> bytes: ...
+    def peek(self, n: int) -> bytes: ...
+    def close(self) -> None: ...
+    def flush(self, zlib_mode: int = 2) -> None: ...
+    def fileno(self) -> int: ...
+    def rewind(self) -> None: ...
+    def seek(self, offset: int, whence: int = 0) -> int: ...
+    def readline(self, size: int | None = -1) -> bytes: ...
+
+class _GzipReader(_compression.DecompressReader):
+    def __init__(self, fp: _ReadableFileobj) -> None: ...
+
+def compress(data: SizedBuffer, compresslevel: int = 9, *, mtime: float | None = None) -> bytes: ...
+def decompress(data: ReadableBuffer) -> bytes: ...

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

@@ -1,163 +1,104 @@
-import sys
-from _blake2 import blake2b as blake2b, blake2s as blake2s
-from _typeshed import ReadableBuffer
-from collections.abc import Callable, Set as AbstractSet
-from typing import Protocol
-from typing_extensions import Self
-
-if sys.version_info >= (3, 11):
-    __all__ = (
-        "md5",
-        "sha1",
-        "sha224",
-        "sha256",
-        "sha384",
-        "sha512",
-        "blake2b",
-        "blake2s",
-        "sha3_224",
-        "sha3_256",
-        "sha3_384",
-        "sha3_512",
-        "shake_128",
-        "shake_256",
-        "new",
-        "algorithms_guaranteed",
-        "algorithms_available",
-        "pbkdf2_hmac",
-        "file_digest",
-    )
-else:
-    __all__ = (
-        "md5",
-        "sha1",
-        "sha224",
-        "sha256",
-        "sha384",
-        "sha512",
-        "blake2b",
-        "blake2s",
-        "sha3_224",
-        "sha3_256",
-        "sha3_384",
-        "sha3_512",
-        "shake_128",
-        "shake_256",
-        "new",
-        "algorithms_guaranteed",
-        "algorithms_available",
-        "pbkdf2_hmac",
-    )
-
-class _Hash:
-    @property
-    def digest_size(self) -> int: ...
-    @property
-    def block_size(self) -> int: ...
-    @property
-    def name(self) -> str: ...
-    def copy(self) -> Self: ...
-    def digest(self) -> bytes: ...
-    def hexdigest(self) -> str: ...
-    def update(self, data: ReadableBuffer, /) -> None: ...
-
-class _VarLenHash:
-    digest_size: int
-    block_size: int
-    name: str
-    def copy(self) -> _VarLenHash: ...
-    def digest(self, length: int, /) -> bytes: ...
-    def hexdigest(self, length: int, /) -> str: ...
-    def update(self, data: ReadableBuffer, /) -> None: ...
-
-if sys.version_info >= (3, 9):
-    def new(name: str, data: ReadableBuffer = b"", *, usedforsecurity: bool = ...) -> _Hash: ...
-    def md5(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a md5 hash object; optionally initialized with a string"""
-        ...
-    def sha1(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha1 hash object; optionally initialized with a string"""
-        ...
-    def sha224(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha224 hash object; optionally initialized with a string"""
-        ...
-    def sha256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha256 hash object; optionally initialized with a string"""
-        ...
-    def sha384(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha384 hash object; optionally initialized with a string"""
-        ...
-    def sha512(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha512 hash object; optionally initialized with a string"""
-        ...
-    def sha3_224(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha3-224 hash object; optionally initialized with a string"""
-        ...
-    def sha3_256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha3-256 hash object; optionally initialized with a string"""
-        ...
-    def sha3_384(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha3-384 hash object; optionally initialized with a string"""
-        ...
-    def sha3_512(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
-        """Returns a sha3-512 hash object; optionally initialized with a string"""
-        ...
-    def shake_128(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _VarLenHash:
-        """Returns a shake-128 variable hash object; optionally initialized with a string"""
-        ...
-    def shake_256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _VarLenHash:
-        """Returns a shake-256 variable hash object; optionally initialized with a string"""
-        ...
-
-else:
-    def new(name: str, data: ReadableBuffer = b"") -> _Hash: ...
-    def md5(string: ReadableBuffer = b"") -> _Hash:
-        """Returns a md5 hash object; optionally initialized with a string"""
-        ...
-    def sha1(string: ReadableBuffer = b"") -> _Hash:
-        """Returns a sha1 hash object; optionally initialized with a string"""
-        ...
-    def sha224(string: ReadableBuffer = b"") -> _Hash:
-        """Returns a sha224 hash object; optionally initialized with a string"""
-        ...
-    def sha256(string: ReadableBuffer = b"") -> _Hash:
-        """Returns a sha256 hash object; optionally initialized with a string"""
-        ...
-    def sha384(string: ReadableBuffer = b"") -> _Hash:
-        """Returns a sha384 hash object; optionally initialized with a string"""
-        ...
-    def sha512(string: ReadableBuffer = b"") -> _Hash:
-        """Returns a sha512 hash object; optionally initialized with a string"""
-        ...
-    def sha3_224(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha3_256(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha3_384(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha3_512(string: ReadableBuffer = b"") -> _Hash: ...
-    def shake_128(string: ReadableBuffer = b"") -> _VarLenHash: ...
-    def shake_256(string: ReadableBuffer = b"") -> _VarLenHash: ...
-
-algorithms_guaranteed: AbstractSet[str]
-algorithms_available: AbstractSet[str]
-
-def pbkdf2_hmac(
-    hash_name: str, password: ReadableBuffer, salt: ReadableBuffer, iterations: int, dklen: int | None = None
-) -> bytes:
-    """Password based key derivation function 2 (PKCS #5 v2.0) with HMAC as pseudorandom function."""
-    ...
-def scrypt(
-    password: ReadableBuffer, *, salt: ReadableBuffer, n: int, r: int, p: int, maxmem: int = 0, dklen: int = 64
-) -> bytes:
-    """scrypt password-based key derivation function."""
-    ...
-
-if sys.version_info >= (3, 11):
-    class _BytesIOLike(Protocol):
-        def getbuffer(self) -> ReadableBuffer: ...
-
-    class _FileDigestFileObj(Protocol):
-        def readinto(self, buf: bytearray, /) -> int: ...
-        def readable(self) -> bool: ...
-
-    def file_digest(
-        fileobj: _BytesIOLike | _FileDigestFileObj, digest: str | Callable[[], _Hash], /, *, _bufsize: int = 262144
-    ) -> _Hash: ...
+import sys
+from _blake2 import blake2b as blake2b, blake2s as blake2s
+from _hashlib import (
+    HASH,
+    openssl_md5 as md5,
+    openssl_sha1 as sha1,
+    openssl_sha224 as sha224,
+    openssl_sha256 as sha256,
+    openssl_sha384 as sha384,
+    openssl_sha512 as sha512,
+    pbkdf2_hmac as pbkdf2_hmac,
+    scrypt as scrypt,
+)
+from _typeshed import ReadableBuffer
+from collections.abc import Callable, Set as AbstractSet
+from typing import Protocol, type_check_only
+
+if sys.version_info >= (3, 11):
+    __all__ = (
+        "md5",
+        "sha1",
+        "sha224",
+        "sha256",
+        "sha384",
+        "sha512",
+        "blake2b",
+        "blake2s",
+        "sha3_224",
+        "sha3_256",
+        "sha3_384",
+        "sha3_512",
+        "shake_128",
+        "shake_256",
+        "new",
+        "algorithms_guaranteed",
+        "algorithms_available",
+        "pbkdf2_hmac",
+        "file_digest",
+    )
+else:
+    __all__ = (
+        "md5",
+        "sha1",
+        "sha224",
+        "sha256",
+        "sha384",
+        "sha512",
+        "blake2b",
+        "blake2s",
+        "sha3_224",
+        "sha3_256",
+        "sha3_384",
+        "sha3_512",
+        "shake_128",
+        "shake_256",
+        "new",
+        "algorithms_guaranteed",
+        "algorithms_available",
+        "pbkdf2_hmac",
+    )
+
+if sys.version_info >= (3, 9):
+    def new(name: str, data: ReadableBuffer = b"", *, usedforsecurity: bool = ...) -> HASH: ...
+    from _hashlib import (
+        openssl_sha3_224 as sha3_224,
+        openssl_sha3_256 as sha3_256,
+        openssl_sha3_384 as sha3_384,
+        openssl_sha3_512 as sha3_512,
+        openssl_shake_128 as shake_128,
+        openssl_shake_256 as shake_256,
+    )
+
+else:
+    @type_check_only
+    class _VarLenHash(HASH):
+        def digest(self, length: int) -> bytes: ...  # type: ignore[override]
+        def hexdigest(self, length: int) -> str: ...  # type: ignore[override]
+
+    def new(name: str, data: ReadableBuffer = b"") -> HASH: ...
+    # At runtime these aren't functions but classes imported from _sha3
+    def sha3_224(string: ReadableBuffer = b"") -> HASH: ...
+    def sha3_256(string: ReadableBuffer = b"") -> HASH: ...
+    def sha3_384(string: ReadableBuffer = b"") -> HASH: ...
+    def sha3_512(string: ReadableBuffer = b"") -> HASH: ...
+    def shake_128(string: ReadableBuffer = b"") -> _VarLenHash: ...
+    def shake_256(string: ReadableBuffer = b"") -> _VarLenHash: ...
+
+algorithms_guaranteed: AbstractSet[str]
+algorithms_available: AbstractSet[str]
+
+if sys.version_info >= (3, 11):
+    class _BytesIOLike(Protocol):
+        def getbuffer(self) -> ReadableBuffer: ...
+
+    class _FileDigestFileObj(Protocol):
+        def readinto(self, buf: bytearray, /) -> int: ...
+        def readable(self) -> bool: ...
+
+    def file_digest(
+        fileobj: _BytesIOLike | _FileDigestFileObj, digest: str | Callable[[], HASH], /, *, _bufsize: int = 262144
+    ) -> HASH: ...
+
+# Legacy typing-only alias
+_Hash = HASH

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

@@ -1,19 +1,19 @@
-from _heapq import *
-from _typeshed import SupportsRichComparison
-from collections.abc import Callable, Iterable
-from typing import Any, Final, TypeVar
-
-__all__ = ["heappush", "heappop", "heapify", "heapreplace", "merge", "nlargest", "nsmallest", "heappushpop"]
-
-_S = TypeVar("_S")
-
-__about__: Final[str]
-
-def merge(
-    *iterables: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None, reverse: bool = False
-) -> Iterable[_S]: ...
-def nlargest(n: int, iterable: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None) -> list[_S]: ...
-def nsmallest(n: int, iterable: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None) -> list[_S]: ...
-def _heapify_max(heap: list[Any], /) -> None:
-    """Maxheap variant of heapify."""
-    ...
+from _heapq import *
+from _typeshed import SupportsRichComparison
+from collections.abc import Callable, Iterable
+from typing import Any, Final, TypeVar
+
+__all__ = ["heappush", "heappop", "heapify", "heapreplace", "merge", "nlargest", "nsmallest", "heappushpop"]
+
+_S = TypeVar("_S")
+
+__about__: Final[str]
+
+def merge(
+    *iterables: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None, reverse: bool = False
+) -> Iterable[_S]: ...
+def nlargest(n: int, iterable: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None) -> list[_S]: ...
+def nsmallest(n: int, iterable: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None) -> list[_S]: ...
+def _heapify_max(heap: list[Any], /) -> None:
+    """Maxheap variant of heapify."""
+    ...