basedpyright 1.1.389 → 1.1.392

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

@@ -1,178 +1,178 @@
-import _ast
-import _io
-import importlib.abc
-import importlib.machinery
-import sys
-import types
-from _typeshed import ReadableBuffer, StrOrBytesPath, StrPath
-from _typeshed.importlib import LoaderProtocol
-from collections.abc import Callable, Iterable, Iterator, Mapping, MutableSequence, Sequence
-from importlib.machinery import ModuleSpec
-from importlib.metadata import DistributionFinder, PathDistribution
-from typing import Any, Literal
-from typing_extensions import Self, deprecated
-
-if sys.version_info >= (3, 10):
-    import importlib.readers
-
-if sys.platform == "win32":
-    path_separators: Literal["\\/"]
-    path_sep: Literal["\\"]
-    path_sep_tuple: tuple[Literal["\\"], Literal["/"]]
-else:
-    path_separators: Literal["/"]
-    path_sep: Literal["/"]
-    path_sep_tuple: tuple[Literal["/"]]
-
-MAGIC_NUMBER: bytes
-
-def cache_from_source(path: str, debug_override: bool | None = None, *, optimization: Any | None = None) -> str: ...
-def source_from_cache(path: str) -> str: ...
-def decode_source(source_bytes: ReadableBuffer) -> str: ...
-def spec_from_file_location(
-    name: str,
-    location: StrOrBytesPath | None = None,
-    *,
-    loader: LoaderProtocol | None = None,
-    submodule_search_locations: list[str] | None = ...,
-) -> importlib.machinery.ModuleSpec | None: ...
-
-class WindowsRegistryFinder(importlib.abc.MetaPathFinder):
-    if sys.version_info < (3, 12):
-        @classmethod
-        def find_module(cls, fullname: str, path: Sequence[str] | None = None) -> importlib.abc.Loader | None: ...
-
-    @classmethod
-    def find_spec(
-        cls, fullname: str, path: Sequence[str] | None = None, target: types.ModuleType | None = None
-    ) -> ModuleSpec | None: ...
-
-class PathFinder(importlib.abc.MetaPathFinder):
-    if sys.version_info >= (3, 10):
-        @staticmethod
-        def invalidate_caches() -> None: ...
-    else:
-        @classmethod
-        def invalidate_caches(cls) -> None: ...
-    if sys.version_info >= (3, 10):
-        @staticmethod
-        def find_distributions(context: DistributionFinder.Context = ...) -> Iterable[PathDistribution]: ...
-    else:
-        @classmethod
-        def find_distributions(cls, context: DistributionFinder.Context = ...) -> Iterable[PathDistribution]: ...
-
-    @classmethod
-    def find_spec(
-        cls, fullname: str, path: Sequence[str] | None = None, target: types.ModuleType | None = None
-    ) -> ModuleSpec | None: ...
-    if sys.version_info < (3, 12):
-        @classmethod
-        def find_module(cls, fullname: str, path: Sequence[str] | None = None) -> importlib.abc.Loader | None: ...
-
-SOURCE_SUFFIXES: list[str]
-DEBUG_BYTECODE_SUFFIXES: list[str]
-OPTIMIZED_BYTECODE_SUFFIXES: list[str]
-BYTECODE_SUFFIXES: list[str]
-EXTENSION_SUFFIXES: list[str]
-
-class FileFinder(importlib.abc.PathEntryFinder):
-    path: str
-    def __init__(self, path: str, *loader_details: tuple[type[importlib.abc.Loader], list[str]]) -> None: ...
-    @classmethod
-    def path_hook(
-        cls, *loader_details: tuple[type[importlib.abc.Loader], list[str]]
-    ) -> Callable[[str], importlib.abc.PathEntryFinder]: ...
-
-class _LoaderBasics:
-    def is_package(self, fullname: str) -> bool: ...
-    def create_module(self, spec: ModuleSpec) -> types.ModuleType | None: ...
-    def exec_module(self, module: types.ModuleType) -> None: ...
-    def load_module(self, fullname: str) -> types.ModuleType: ...
-
-class SourceLoader(_LoaderBasics):
-    def path_mtime(self, path: str) -> float: ...
-    def set_data(self, path: str, data: bytes) -> None: ...
-    def get_source(self, fullname: str) -> str | None: ...
-    def path_stats(self, path: str) -> Mapping[str, Any]: ...
-    def source_to_code(
-        self, data: ReadableBuffer | str | _ast.Module | _ast.Expression | _ast.Interactive, path: ReadableBuffer | StrPath
-    ) -> types.CodeType: ...
-    def get_code(self, fullname: str) -> types.CodeType | None: ...
-
-class FileLoader:
-    name: str
-    path: str
-    def __init__(self, fullname: str, path: str) -> None: ...
-    def get_data(self, path: str) -> bytes: ...
-    def get_filename(self, name: str | None = None) -> str: ...
-    def load_module(self, name: str | None = None) -> types.ModuleType: ...
-    if sys.version_info >= (3, 10):
-        def get_resource_reader(self, name: str | None = None) -> importlib.readers.FileReader: ...
-    else:
-        def get_resource_reader(self, name: str | None = None) -> Self | None: ...
-        def open_resource(self, resource: str) -> _io.FileIO: ...
-        def resource_path(self, resource: str) -> str: ...
-        def is_resource(self, name: str) -> bool: ...
-        def contents(self) -> Iterator[str]: ...
-
-class SourceFileLoader(importlib.abc.FileLoader, FileLoader, importlib.abc.SourceLoader, SourceLoader):  # type: ignore[misc]  # incompatible method arguments in base classes
-    def set_data(self, path: str, data: ReadableBuffer, *, _mode: int = 0o666) -> None: ...
-    def path_stats(self, path: str) -> Mapping[str, Any]: ...
-
-class SourcelessFileLoader(importlib.abc.FileLoader, FileLoader, _LoaderBasics):
-    def get_code(self, fullname: str) -> types.CodeType | None: ...
-    def get_source(self, fullname: str) -> None: ...
-
-class ExtensionFileLoader(FileLoader, _LoaderBasics, importlib.abc.ExecutionLoader):
-    def __init__(self, name: str, path: str) -> None: ...
-    def get_filename(self, name: str | None = None) -> str: ...
-    def get_source(self, fullname: str) -> None: ...
-    def create_module(self, spec: ModuleSpec) -> types.ModuleType: ...
-    def exec_module(self, module: types.ModuleType) -> None: ...
-    def get_code(self, fullname: str) -> None: ...
-    def __eq__(self, other: object) -> bool: ...
-    def __hash__(self) -> int: ...
-
-if sys.version_info >= (3, 11):
-    class NamespaceLoader(importlib.abc.InspectLoader):
-        def __init__(
-            self, name: str, path: MutableSequence[str], path_finder: Callable[[str, tuple[str, ...]], ModuleSpec]
-        ) -> None: ...
-        def is_package(self, fullname: str) -> Literal[True]: ...
-        def get_source(self, fullname: str) -> Literal[""]: ...
-        def get_code(self, fullname: str) -> types.CodeType: ...
-        def create_module(self, spec: ModuleSpec) -> None: ...
-        def exec_module(self, module: types.ModuleType) -> None: ...
-        @deprecated("load_module() is deprecated; use exec_module() instead")
-        def load_module(self, fullname: str) -> types.ModuleType: ...
-        def get_resource_reader(self, module: types.ModuleType) -> importlib.readers.NamespaceReader: ...
-        if sys.version_info < (3, 12):
-            @staticmethod
-            @deprecated("module_repr() is deprecated, and has been removed in Python 3.12")
-            def module_repr(module: types.ModuleType) -> str: ...
-
-    _NamespaceLoader = NamespaceLoader
-else:
-    class _NamespaceLoader:
-        def __init__(
-            self, name: str, path: MutableSequence[str], path_finder: Callable[[str, tuple[str, ...]], ModuleSpec]
-        ) -> None: ...
-        def is_package(self, fullname: str) -> Literal[True]: ...
-        def get_source(self, fullname: str) -> Literal[""]: ...
-        def get_code(self, fullname: str) -> types.CodeType: ...
-        def create_module(self, spec: ModuleSpec) -> None: ...
-        def exec_module(self, module: types.ModuleType) -> None: ...
-        @deprecated("load_module() is deprecated; use exec_module() instead")
-        def load_module(self, fullname: str) -> types.ModuleType: ...
-        if sys.version_info >= (3, 10):
-            @staticmethod
-            @deprecated("module_repr() is deprecated, and has been removed in Python 3.12")
-            def module_repr(module: types.ModuleType) -> str: ...
-            def get_resource_reader(self, module: types.ModuleType) -> importlib.readers.NamespaceReader: ...
-        else:
-            @classmethod
-            @deprecated("module_repr() is deprecated, and has been removed in Python 3.12")
-            def module_repr(cls, module: types.ModuleType) -> str: ...
-
-if sys.version_info >= (3, 13):
-    class AppleFrameworkLoader(ExtensionFileLoader, importlib.abc.ExecutionLoader): ...
+import _ast
+import _io
+import importlib.abc
+import importlib.machinery
+import sys
+import types
+from _typeshed import ReadableBuffer, StrOrBytesPath, StrPath
+from _typeshed.importlib import LoaderProtocol
+from collections.abc import Callable, Iterable, Iterator, Mapping, MutableSequence, Sequence
+from importlib.machinery import ModuleSpec
+from importlib.metadata import DistributionFinder, PathDistribution
+from typing import Any, Literal
+from typing_extensions import Self, deprecated
+
+if sys.version_info >= (3, 10):
+    import importlib.readers
+
+if sys.platform == "win32":
+    path_separators: Literal["\\/"]
+    path_sep: Literal["\\"]
+    path_sep_tuple: tuple[Literal["\\"], Literal["/"]]
+else:
+    path_separators: Literal["/"]
+    path_sep: Literal["/"]
+    path_sep_tuple: tuple[Literal["/"]]
+
+MAGIC_NUMBER: bytes
+
+def cache_from_source(path: str, debug_override: bool | None = None, *, optimization: Any | None = None) -> str: ...
+def source_from_cache(path: str) -> str: ...
+def decode_source(source_bytes: ReadableBuffer) -> str: ...
+def spec_from_file_location(
+    name: str,
+    location: StrOrBytesPath | None = None,
+    *,
+    loader: LoaderProtocol | None = None,
+    submodule_search_locations: list[str] | None = ...,
+) -> importlib.machinery.ModuleSpec | None: ...
+
+class WindowsRegistryFinder(importlib.abc.MetaPathFinder):
+    if sys.version_info < (3, 12):
+        @classmethod
+        def find_module(cls, fullname: str, path: Sequence[str] | None = None) -> importlib.abc.Loader | None: ...
+
+    @classmethod
+    def find_spec(
+        cls, fullname: str, path: Sequence[str] | None = None, target: types.ModuleType | None = None
+    ) -> ModuleSpec | None: ...
+
+class PathFinder(importlib.abc.MetaPathFinder):
+    if sys.version_info >= (3, 10):
+        @staticmethod
+        def invalidate_caches() -> None: ...
+    else:
+        @classmethod
+        def invalidate_caches(cls) -> None: ...
+    if sys.version_info >= (3, 10):
+        @staticmethod
+        def find_distributions(context: DistributionFinder.Context = ...) -> Iterable[PathDistribution]: ...
+    else:
+        @classmethod
+        def find_distributions(cls, context: DistributionFinder.Context = ...) -> Iterable[PathDistribution]: ...
+
+    @classmethod
+    def find_spec(
+        cls, fullname: str, path: Sequence[str] | None = None, target: types.ModuleType | None = None
+    ) -> ModuleSpec | None: ...
+    if sys.version_info < (3, 12):
+        @classmethod
+        def find_module(cls, fullname: str, path: Sequence[str] | None = None) -> importlib.abc.Loader | None: ...
+
+SOURCE_SUFFIXES: list[str]
+DEBUG_BYTECODE_SUFFIXES: list[str]
+OPTIMIZED_BYTECODE_SUFFIXES: list[str]
+BYTECODE_SUFFIXES: list[str]
+EXTENSION_SUFFIXES: list[str]
+
+class FileFinder(importlib.abc.PathEntryFinder):
+    path: str
+    def __init__(self, path: str, *loader_details: tuple[type[importlib.abc.Loader], list[str]]) -> None: ...
+    @classmethod
+    def path_hook(
+        cls, *loader_details: tuple[type[importlib.abc.Loader], list[str]]
+    ) -> Callable[[str], importlib.abc.PathEntryFinder]: ...
+
+class _LoaderBasics:
+    def is_package(self, fullname: str) -> bool: ...
+    def create_module(self, spec: ModuleSpec) -> types.ModuleType | None: ...
+    def exec_module(self, module: types.ModuleType) -> None: ...
+    def load_module(self, fullname: str) -> types.ModuleType: ...
+
+class SourceLoader(_LoaderBasics):
+    def path_mtime(self, path: str) -> float: ...
+    def set_data(self, path: str, data: bytes) -> None: ...
+    def get_source(self, fullname: str) -> str | None: ...
+    def path_stats(self, path: str) -> Mapping[str, Any]: ...
+    def source_to_code(
+        self, data: ReadableBuffer | str | _ast.Module | _ast.Expression | _ast.Interactive, path: ReadableBuffer | StrPath
+    ) -> types.CodeType: ...
+    def get_code(self, fullname: str) -> types.CodeType | None: ...
+
+class FileLoader:
+    name: str
+    path: str
+    def __init__(self, fullname: str, path: str) -> None: ...
+    def get_data(self, path: str) -> bytes: ...
+    def get_filename(self, name: str | None = None) -> str: ...
+    def load_module(self, name: str | None = None) -> types.ModuleType: ...
+    if sys.version_info >= (3, 10):
+        def get_resource_reader(self, name: str | None = None) -> importlib.readers.FileReader: ...
+    else:
+        def get_resource_reader(self, name: str | None = None) -> Self | None: ...
+        def open_resource(self, resource: str) -> _io.FileIO: ...
+        def resource_path(self, resource: str) -> str: ...
+        def is_resource(self, name: str) -> bool: ...
+        def contents(self) -> Iterator[str]: ...
+
+class SourceFileLoader(importlib.abc.FileLoader, FileLoader, importlib.abc.SourceLoader, SourceLoader):  # type: ignore[misc]  # incompatible method arguments in base classes
+    def set_data(self, path: str, data: ReadableBuffer, *, _mode: int = 0o666) -> None: ...
+    def path_stats(self, path: str) -> Mapping[str, Any]: ...
+
+class SourcelessFileLoader(importlib.abc.FileLoader, FileLoader, _LoaderBasics):
+    def get_code(self, fullname: str) -> types.CodeType | None: ...
+    def get_source(self, fullname: str) -> None: ...
+
+class ExtensionFileLoader(FileLoader, _LoaderBasics, importlib.abc.ExecutionLoader):
+    def __init__(self, name: str, path: str) -> None: ...
+    def get_filename(self, name: str | None = None) -> str: ...
+    def get_source(self, fullname: str) -> None: ...
+    def create_module(self, spec: ModuleSpec) -> types.ModuleType: ...
+    def exec_module(self, module: types.ModuleType) -> None: ...
+    def get_code(self, fullname: str) -> None: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __hash__(self) -> int: ...
+
+if sys.version_info >= (3, 11):
+    class NamespaceLoader(importlib.abc.InspectLoader):
+        def __init__(
+            self, name: str, path: MutableSequence[str], path_finder: Callable[[str, tuple[str, ...]], ModuleSpec]
+        ) -> None: ...
+        def is_package(self, fullname: str) -> Literal[True]: ...
+        def get_source(self, fullname: str) -> Literal[""]: ...
+        def get_code(self, fullname: str) -> types.CodeType: ...
+        def create_module(self, spec: ModuleSpec) -> None: ...
+        def exec_module(self, module: types.ModuleType) -> None: ...
+        @deprecated("load_module() is deprecated; use exec_module() instead")
+        def load_module(self, fullname: str) -> types.ModuleType: ...
+        def get_resource_reader(self, module: types.ModuleType) -> importlib.readers.NamespaceReader: ...
+        if sys.version_info < (3, 12):
+            @staticmethod
+            @deprecated("module_repr() is deprecated, and has been removed in Python 3.12")
+            def module_repr(module: types.ModuleType) -> str: ...
+
+    _NamespaceLoader = NamespaceLoader
+else:
+    class _NamespaceLoader:
+        def __init__(
+            self, name: str, path: MutableSequence[str], path_finder: Callable[[str, tuple[str, ...]], ModuleSpec]
+        ) -> None: ...
+        def is_package(self, fullname: str) -> Literal[True]: ...
+        def get_source(self, fullname: str) -> Literal[""]: ...
+        def get_code(self, fullname: str) -> types.CodeType: ...
+        def create_module(self, spec: ModuleSpec) -> None: ...
+        def exec_module(self, module: types.ModuleType) -> None: ...
+        @deprecated("load_module() is deprecated; use exec_module() instead")
+        def load_module(self, fullname: str) -> types.ModuleType: ...
+        if sys.version_info >= (3, 10):
+            @staticmethod
+            @deprecated("module_repr() is deprecated, and has been removed in Python 3.12")
+            def module_repr(module: types.ModuleType) -> str: ...
+            def get_resource_reader(self, module: types.ModuleType) -> importlib.readers.NamespaceReader: ...
+        else:
+            @classmethod
+            @deprecated("module_repr() is deprecated, and has been removed in Python 3.12")
+            def module_repr(cls, module: types.ModuleType) -> str: ...
+
+if sys.version_info >= (3, 13):
+    class AppleFrameworkLoader(ExtensionFileLoader, importlib.abc.ExecutionLoader): ...

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

@@ -1,16 +1,3 @@
-"""
-This module provides an interface to the GNU DBM (GDBM) library.
-
-This module is quite similar to the dbm module, but uses GDBM instead to
-provide some additional functionality.  Please note that the file formats
-created by GDBM and dbm are incompatible.
-
-GDBM objects behave like mappings (dictionaries), except that keys and
-values are always immutable bytes-like objects or strings.  Printing
-a GDBM object doesn't print the keys and values, and the items() and
-values() methods are not supported.
-"""
-
 import sys
 from _typeshed import ReadOnlyBuffer, StrOrBytesPath
 from types import TracebackType
@@ -55,56 +42,6 @@ if sys.platform != "win32":
         __init__: None  # type: ignore[assignment]
 
     if sys.version_info >= (3, 11):
-        def open(filename: StrOrBytesPath, flags: str = "r", mode: int = 0o666, /) -> _gdbm:
-            """
-            Open a dbm database and return a dbm object.
-
-            The filename argument is the name of the database file.
-
-            The optional flags argument can be 'r' (to open an existing database
-            for reading only -- default), 'w' (to open an existing database for
-            reading and writing), 'c' (which creates the database if it doesn't
-            exist), or 'n' (which always creates a new empty database).
-
-            Some versions of gdbm support additional flags which must be
-            appended to one of the flags described above.  The module constant
-            'open_flags' is a string of valid additional flags.  The 'f' flag
-            opens the database in fast mode; altered data will not automatically
-            be written to the disk after every change.  This results in faster
-            writes to the database, but may result in an inconsistent database
-            if the program crashes while the database is still open.  Use the
-            sync() method to force any unwritten data to be written to the disk.
-            The 's' flag causes all database operations to be synchronized to
-            disk.  The 'u' flag disables locking of the database file.
-
-            The optional mode argument is the Unix mode of the file, used only
-            when the database has to be created.  It defaults to octal 0o666.
-            """
-            ...
+        def open(filename: StrOrBytesPath, flags: str = "r", mode: int = 0o666, /) -> _gdbm: ...
     else:
-        def open(filename: str, flags: str = "r", mode: int = 0o666, /) -> _gdbm:
-            """
-            Open a dbm database and return a dbm object.
-
-            The filename argument is the name of the database file.
-
-            The optional flags argument can be 'r' (to open an existing database
-            for reading only -- default), 'w' (to open an existing database for
-            reading and writing), 'c' (which creates the database if it doesn't
-            exist), or 'n' (which always creates a new empty database).
-
-            Some versions of gdbm support additional flags which must be
-            appended to one of the flags described above.  The module constant
-            'open_flags' is a string of valid additional flags.  The 'f' flag
-            opens the database in fast mode; altered data will not automatically
-            be written to the disk after every change.  This results in faster
-            writes to the database, but may result in an inconsistent database
-            if the program crashes while the database is still open.  Use the
-            sync() method to force any unwritten data to be written to the disk.
-            The 's' flag causes all database operations to be synchronized to
-            disk.  The 'u' flag disables locking of the database file.
-
-            The optional mode argument is the Unix mode of the file, used only
-            when the database has to be created.  It defaults to octal 0o666.
-            """
-            ...
+        def open(filename: str, flags: str = "r", mode: int = 0o666, /) -> _gdbm: ...

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

@@ -0,0 +1,232 @@
+"""OpenSSL interface for hashlib module"""
+
+import sys
+from _typeshed import ReadableBuffer
+from collections.abc import Callable
+from types import ModuleType
+from typing import AnyStr, final, overload
+from typing_extensions import Self, TypeAlias
+
+_DigestMod: TypeAlias = str | Callable[[], HASH] | ModuleType | None
+
+openssl_md_meth_names: frozenset[str]
+
+class HASH:
+    """
+    A hash is an object used to calculate a checksum of a string of information.
+
+    Methods:
+
+    update() -- updates the current digest with an additional string
+    digest() -- return the current digest value
+    hexdigest() -- return the current digest as a string of hexadecimal digits
+    copy() -- return a copy of the current hash object
+
+    Attributes:
+
+    name -- the hash algorithm being used by this object
+    digest_size -- number of bytes in this hashes output
+    """
+    @property
+    def digest_size(self) -> int: ...
+    @property
+    def block_size(self) -> int: ...
+    @property
+    def name(self) -> str: ...
+    def copy(self) -> Self:
+        """Return a copy of the hash object."""
+        ...
+    def digest(self) -> bytes:
+        """Return the digest value as a bytes object."""
+        ...
+    def hexdigest(self) -> str:
+        """Return the digest value as a string of hexadecimal digits."""
+        ...
+    def update(self, obj: ReadableBuffer, /) -> None:
+        """Update this hash object's state with the provided string."""
+        ...
+
+if sys.version_info >= (3, 10):
+    class UnsupportedDigestmodError(ValueError): ...
+
+if sys.version_info >= (3, 9):
+    class HASHXOF(HASH):
+        """
+        A hash is an object used to calculate a checksum of a string of information.
+
+        Methods:
+
+        update() -- updates the current digest with an additional string
+        digest(length) -- return the current digest value
+        hexdigest(length) -- return the current digest as a string of hexadecimal digits
+        copy() -- return a copy of the current hash object
+
+        Attributes:
+
+        name -- the hash algorithm being used by this object
+        digest_size -- number of bytes in this hashes output
+        """
+        def digest(self, length: int) -> bytes:
+            """Return the digest value as a bytes object."""
+            ...
+        def hexdigest(self, length: int) -> str:
+            """Return the digest value as a string of hexadecimal digits."""
+            ...
+
+    @final
+    class HMAC:
+        """
+        The object used to calculate HMAC of a message.
+
+        Methods:
+
+        update() -- updates the current digest with an additional string
+        digest() -- return the current digest value
+        hexdigest() -- return the current digest as a string of hexadecimal digits
+        copy() -- return a copy of the current hash object
+
+        Attributes:
+
+        name -- the name, including the hash algorithm used by this object
+        digest_size -- number of bytes in digest() output
+        """
+        @property
+        def digest_size(self) -> int: ...
+        @property
+        def block_size(self) -> int: ...
+        @property
+        def name(self) -> str: ...
+        def copy(self) -> Self:
+            """Return a copy ("clone") of the HMAC object."""
+            ...
+        def digest(self) -> bytes:
+            """Return the digest of the bytes passed to the update() method so far."""
+            ...
+        def hexdigest(self) -> str:
+            """
+            Return hexadecimal digest of the bytes passed to the update() method so far.
+
+            This may be used to exchange the value safely in email or other non-binary
+            environments.
+            """
+            ...
+        def update(self, msg: ReadableBuffer) -> None:
+            """Update the HMAC object with msg."""
+            ...
+
+    @overload
+    def compare_digest(a: ReadableBuffer, b: ReadableBuffer, /) -> bool:
+        """
+        Return 'a == b'.
+
+        This function uses an approach designed to prevent
+        timing analysis, making it appropriate for cryptography.
+
+        a and b must both be of the same type: either str (ASCII only),
+        or any bytes-like object.
+
+        Note: If a and b are of different lengths, or if an error occurs,
+        a timing attack could theoretically reveal information about the
+        types and lengths of a and b--but not their values.
+        """
+        ...
+    @overload
+    def compare_digest(a: AnyStr, b: AnyStr, /) -> bool:
+        """
+        Return 'a == b'.
+
+        This function uses an approach designed to prevent
+        timing analysis, making it appropriate for cryptography.
+
+        a and b must both be of the same type: either str (ASCII only),
+        or any bytes-like object.
+
+        Note: If a and b are of different lengths, or if an error occurs,
+        a timing attack could theoretically reveal information about the
+        types and lengths of a and b--but not their values.
+        """
+        ...
+    def get_fips_mode() -> int:
+        """
+        Determine the OpenSSL FIPS mode of operation.
+
+        For OpenSSL 3.0.0 and newer it returns the state of the default provider
+        in the default OSSL context. It's not quite the same as FIPS_mode() but good
+        enough for unittests.
+
+        Effectively any non-zero return value indicates FIPS mode;
+        values other than 1 may have additional significance.
+        """
+        ...
+    def hmac_new(key: bytes | bytearray, msg: ReadableBuffer = b"", digestmod: _DigestMod = None) -> HMAC:
+        """Return a new hmac object."""
+        ...
+    def new(name: str, string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """
+        Return a new hash object using the named algorithm.
+
+        An optional string argument may be provided and will be
+        automatically hashed.
+
+        The MD5 and SHA1 algorithms are always supported.
+        """
+        ...
+    def openssl_md5(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a md5 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha1(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha1 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha224(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha224 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha256 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha384(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha384 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha512(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha512 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha3_224(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha3-224 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha3_256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha3-256 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha3_384(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha3-384 hash object; optionally initialized with a string"""
+        ...
+    def openssl_sha3_512(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASH:
+        """Returns a sha3-512 hash object; optionally initialized with a string"""
+        ...
+    def openssl_shake_128(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASHXOF:
+        """Returns a shake-128 variable hash object; optionally initialized with a string"""
+        ...
+    def openssl_shake_256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> HASHXOF:
+        """Returns a shake-256 variable hash object; optionally initialized with a string"""
+        ...
+
+else:
+    def new(name: str, string: ReadableBuffer = b"") -> HASH: ...
+    def openssl_md5(string: ReadableBuffer = b"") -> HASH: ...
+    def openssl_sha1(string: ReadableBuffer = b"") -> HASH: ...
+    def openssl_sha224(string: ReadableBuffer = b"") -> HASH: ...
+    def openssl_sha256(string: ReadableBuffer = b"") -> HASH: ...
+    def openssl_sha384(string: ReadableBuffer = b"") -> HASH: ...
+    def openssl_sha512(string: ReadableBuffer = b"") -> HASH: ...
+
+def hmac_digest(key: bytes | bytearray, msg: ReadableBuffer, digest: str) -> bytes:
+    """Single-shot HMAC."""
+    ...
+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."""
+    ...