python-libphash 2.0.1.0__cp315-cp315t-win_amd64.whl

libphash/_native.pyi

@@ -0,0 +1,944 @@
+# Generated by tools/stub.py from the built module; do not edit.
+# Every function and constant of libphash.h, typed by cffi's argument rules.
+
+from collections.abc import Callable, Iterator, Mapping, Sequence
+from typing import Final, Literal, TypeVar, overload
+
+from typing_extensions import Buffer
+
+_P = TypeVar("_P", bound=Pointer)
+_F = TypeVar("_F", bound=Callable[..., object])
+
+class CData: ...
+
+class Pointer(CData):
+    def __bool__(self) -> bool: ...
+
+class void_ptr(Pointer): ...
+
+class CField:
+    type: CType
+    offset: int
+
+class CType:
+    kind: str
+    cname: str
+    item: CType
+    length: int | None
+    fields: list[tuple[str, CField]] | None
+    args: tuple[CType, ...]
+    result: CType
+    ellipsis: bool
+    elements: dict[int, str]
+
+class CBuffer:
+    def __buffer__(self, flags: int, /) -> memoryview: ...
+    def __len__(self) -> int: ...
+    @overload
+    def __getitem__(self, index: int, /) -> bytes: ...
+    @overload
+    def __getitem__(self, index: slice, /) -> bytes: ...
+
+class char_ptr(Pointer):
+    def __add__(self, offset: int, /) -> char_ptr: ...
+    def __getitem__(self, index: int, /) -> bytes: ...
+    def __setitem__(self, index: int, value: bytes, /) -> None: ...
+
+class char_array(char_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[bytes]: ...
+
+class double_ptr(Pointer):
+    def __add__(self, offset: int, /) -> double_ptr: ...
+    def __getitem__(self, index: int, /) -> float: ...
+    def __setitem__(self, index: int, value: float, /) -> None: ...
+
+class double_array(double_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[float]: ...
+
+class int_ptr(Pointer):
+    def __add__(self, offset: int, /) -> int_ptr: ...
+    def __getitem__(self, index: int, /) -> int: ...
+    def __setitem__(self, index: int, value: int, /) -> None: ...
+
+class int_array(int_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[int]: ...
+
+class ph_algorithm_t_ptr(Pointer):
+    def __add__(self, offset: int, /) -> ph_algorithm_t_ptr: ...
+    def __getitem__(self, index: int, /) -> int: ...
+    def __setitem__(self, index: int, value: int, /) -> None: ...
+
+class ph_algorithm_t_array(ph_algorithm_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[int]: ...
+
+class ph_batch_buffer_item_t(CData):
+    @property
+    def buffer(self) -> uint8_t_ptr: ...
+    @buffer.setter
+    def buffer(self, value: char_ptr | uint8_t_ptr | void_ptr) -> None: ...
+    length: int
+    @property
+    def hashes(self) -> uint64_t_array: ...
+    @hashes.setter
+    def hashes(self, value: uint64_t_array | Sequence[int]) -> None: ...
+    status: int
+
+class ph_batch_buffer_item_t_ptr(Pointer):
+    @property
+    def buffer(self) -> uint8_t_ptr: ...
+    @buffer.setter
+    def buffer(self, value: char_ptr | uint8_t_ptr | void_ptr) -> None: ...
+    length: int
+    @property
+    def hashes(self) -> uint64_t_array: ...
+    @hashes.setter
+    def hashes(self, value: uint64_t_array | Sequence[int]) -> None: ...
+    status: int
+    def __add__(self, offset: int, /) -> ph_batch_buffer_item_t_ptr: ...
+    def __getitem__(self, index: int, /) -> ph_batch_buffer_item_t: ...
+    def __setitem__(self, index: int, value: ph_batch_buffer_item_t, /) -> None: ...
+
+class ph_batch_buffer_item_t_array(ph_batch_buffer_item_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[ph_batch_buffer_item_t]: ...
+
+class ph_batch_continue_fn(Pointer):
+    def __call__(self, user_data: Pointer, /) -> int: ...
+
+class ph_batch_item_t(CData):
+    @property
+    def path(self) -> char_ptr: ...
+    @path.setter
+    def path(self, value: char_ptr | uint8_t_ptr | void_ptr) -> None: ...
+    @property
+    def hashes(self) -> uint64_t_array: ...
+    @hashes.setter
+    def hashes(self, value: uint64_t_array | Sequence[int]) -> None: ...
+    status: int
+
+class ph_batch_item_t_ptr(Pointer):
+    @property
+    def path(self) -> char_ptr: ...
+    @path.setter
+    def path(self, value: char_ptr | uint8_t_ptr | void_ptr) -> None: ...
+    @property
+    def hashes(self) -> uint64_t_array: ...
+    @hashes.setter
+    def hashes(self, value: uint64_t_array | Sequence[int]) -> None: ...
+    status: int
+    def __add__(self, offset: int, /) -> ph_batch_item_t_ptr: ...
+    def __getitem__(self, index: int, /) -> ph_batch_item_t: ...
+    def __setitem__(self, index: int, value: ph_batch_item_t, /) -> None: ...
+
+class ph_batch_item_t_array(ph_batch_item_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[ph_batch_item_t]: ...
+
+class ph_batch_options_t(CData):
+    struct_size: int
+    @property
+    def config(self) -> ph_context_t_ptr: ...
+    @config.setter
+    def config(self, value: ph_context_t_ptr | void_ptr) -> None: ...
+    threads: int
+    @property
+    def should_continue(self) -> ph_batch_continue_fn: ...
+    @should_continue.setter
+    def should_continue(self, value: ph_batch_continue_fn | void_ptr) -> None: ...
+    @property
+    def on_progress(self) -> ph_batch_progress_fn: ...
+    @on_progress.setter
+    def on_progress(self, value: ph_batch_progress_fn | void_ptr) -> None: ...
+    @property
+    def user_data(self) -> void_ptr: ...
+    @user_data.setter
+    def user_data(self, value: Pointer) -> None: ...
+
+class ph_batch_options_t_ptr(Pointer):
+    struct_size: int
+    @property
+    def config(self) -> ph_context_t_ptr: ...
+    @config.setter
+    def config(self, value: ph_context_t_ptr | void_ptr) -> None: ...
+    threads: int
+    @property
+    def should_continue(self) -> ph_batch_continue_fn: ...
+    @should_continue.setter
+    def should_continue(self, value: ph_batch_continue_fn | void_ptr) -> None: ...
+    @property
+    def on_progress(self) -> ph_batch_progress_fn: ...
+    @on_progress.setter
+    def on_progress(self, value: ph_batch_progress_fn | void_ptr) -> None: ...
+    @property
+    def user_data(self) -> void_ptr: ...
+    @user_data.setter
+    def user_data(self, value: Pointer) -> None: ...
+    def __add__(self, offset: int, /) -> ph_batch_options_t_ptr: ...
+    def __getitem__(self, index: int, /) -> ph_batch_options_t: ...
+    def __setitem__(self, index: int, value: ph_batch_options_t, /) -> None: ...
+
+class ph_batch_options_t_array(ph_batch_options_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[ph_batch_options_t]: ...
+
+class ph_batch_progress_fn(Pointer):
+    def __call__(self, done: int, total: int, user_data: Pointer, /) -> None: ...
+
+class ph_context_t_ptr(Pointer): ...
+
+class ph_context_t_ptr_ptr(Pointer):
+    def __add__(self, offset: int, /) -> ph_context_t_ptr_ptr: ...
+    def __getitem__(self, index: int, /) -> ph_context_t_ptr: ...
+    def __setitem__(
+        self, index: int, value: ph_context_t_ptr | void_ptr, /
+    ) -> None: ...
+
+class ph_context_t_ptr_array(ph_context_t_ptr_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[ph_context_t_ptr]: ...
+
+class ph_digest_kind_t_ptr(Pointer):
+    def __add__(self, offset: int, /) -> ph_digest_kind_t_ptr: ...
+    def __getitem__(self, index: int, /) -> int: ...
+    def __setitem__(self, index: int, value: int, /) -> None: ...
+
+class ph_digest_kind_t_array(ph_digest_kind_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[int]: ...
+
+class ph_digest_t(CData):
+    @property
+    def data(self) -> uint8_t_array: ...
+    @data.setter
+    def data(self, value: uint8_t_array | Sequence[int]) -> None: ...
+    size: int
+    kind: int
+    @property
+    def reserved(self) -> uint8_t_array: ...
+    @reserved.setter
+    def reserved(self, value: uint8_t_array | Sequence[int]) -> None: ...
+
+class ph_digest_t_ptr(Pointer):
+    @property
+    def data(self) -> uint8_t_array: ...
+    @data.setter
+    def data(self, value: uint8_t_array | Sequence[int]) -> None: ...
+    size: int
+    kind: int
+    @property
+    def reserved(self) -> uint8_t_array: ...
+    @reserved.setter
+    def reserved(self, value: uint8_t_array | Sequence[int]) -> None: ...
+    def __add__(self, offset: int, /) -> ph_digest_t_ptr: ...
+    def __getitem__(self, index: int, /) -> ph_digest_t: ...
+    def __setitem__(self, index: int, value: ph_digest_t, /) -> None: ...
+
+class ph_digest_t_array(ph_digest_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[ph_digest_t]: ...
+
+class size_t_ptr(Pointer):
+    def __add__(self, offset: int, /) -> size_t_ptr: ...
+    def __getitem__(self, index: int, /) -> int: ...
+    def __setitem__(self, index: int, value: int, /) -> None: ...
+
+class size_t_array(size_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[int]: ...
+
+class uint64_t_ptr(Pointer):
+    def __add__(self, offset: int, /) -> uint64_t_ptr: ...
+    def __getitem__(self, index: int, /) -> int: ...
+    def __setitem__(self, index: int, value: int, /) -> None: ...
+
+class uint64_t_array(uint64_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[int]: ...
+
+class uint8_t_ptr(Pointer):
+    def __add__(self, offset: int, /) -> uint8_t_ptr: ...
+    def __getitem__(self, index: int, /) -> int: ...
+    def __setitem__(self, index: int, value: int, /) -> None: ...
+
+class uint8_t_array(uint8_t_ptr):
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[int]: ...
+
+class _Lib:
+    PH_ALGORITHM_COUNT: Final[int]
+    PH_ALGO_AHASH: Final[int]
+    PH_ALGO_BMH: Final[int]
+    PH_ALGO_COLOR_HASH: Final[int]
+    PH_ALGO_COLOR_MOMENTS: Final[int]
+    PH_ALGO_DHASH: Final[int]
+    PH_ALGO_FORCE_INT32_: Final[int]
+    PH_ALGO_MHASH: Final[int]
+    PH_ALGO_PHASH: Final[int]
+    PH_ALGO_RADIAL: Final[int]
+    PH_ALGO_WHASH: Final[int]
+    PH_ALPHA_BLEND_BLACK: Final[int]
+    PH_ALPHA_BLEND_GREY: Final[int]
+    PH_ALPHA_BLEND_WHITE: Final[int]
+    PH_ALPHA_FORCE_INT32_: Final[int]
+    PH_ALPHA_IGNORE: Final[int]
+    PH_BATCH_HASHES_CAPACITY: Final[int]
+    PH_DECODE_SCALE_EIGHTH: Final[int]
+    PH_DECODE_SCALE_FORCE_INT32_: Final[int]
+    PH_DECODE_SCALE_FULL: Final[int]
+    PH_DECODE_SCALE_HALF: Final[int]
+    PH_DECODE_SCALE_QUARTER: Final[int]
+    PH_DIGEST_HEX_BUFFER_SIZE: Final[int]
+    PH_DIGEST_KIND_BITS: Final[int]
+    PH_DIGEST_KIND_COEFFICIENTS: Final[int]
+    PH_DIGEST_KIND_FORCE_INT32_: Final[int]
+    PH_DIGEST_KIND_HISTOGRAM: Final[int]
+    PH_DIGEST_KIND_UNSPECIFIED: Final[int]
+    PH_DIGEST_KIND_VECTOR: Final[int]
+    PH_DIGEST_KIND_VECTOR16: Final[int]
+    PH_DIGEST_MAX_BYTES: Final[int]
+    PH_ENUM_FORCE_INT32_VALUE: Final[int]
+    PH_ERR_ALLOCATION_FAILED: Final[int]
+    PH_ERR_CANCELLED: Final[int]
+    PH_ERR_CORRUPT_DATA: Final[int]
+    PH_ERR_DECODER_UNAVAILABLE: Final[int]
+    PH_ERR_EMPTY_IMAGE: Final[int]
+    PH_ERR_FORCE_INT32_: Final[int]
+    PH_ERR_IMAGE_TOO_LARGE: Final[int]
+    PH_ERR_INVALID_ARGUMENT: Final[int]
+    PH_ERR_IO: Final[int]
+    PH_ERR_NO_STRUCTURE: Final[int]
+    PH_ERR_REQUIRES_COLOR: Final[int]
+    PH_ERR_UNSUPPORTED_FORMAT: Final[int]
+    PH_HASH_AHASH: Final[int]
+    PH_HASH_DHASH: Final[int]
+    PH_HASH_FLAGS_COUNT: Final[int]
+    PH_HASH_FORCE_INT32_: Final[int]
+    PH_HASH_PHASH: Final[int]
+    PH_HASH_WHASH: Final[int]
+    PH_RADIAL_PCC_THRESHOLD: Final[float]
+    PH_SUCCESS: Final[int]
+    PH_VECTOR16_SCALE: Final[int]
+    PH_WHASH_FAST: Final[int]
+    PH_WHASH_FORCE_INT32_: Final[int]
+    PH_WHASH_FULL: Final[int]
+    _libphash_continue: ph_batch_continue_fn
+    _libphash_on_progress: ph_batch_progress_fn
+    _libphash_progress: ph_batch_progress_fn
+    _libphash_should_continue: ph_batch_continue_fn
+    def ph_algorithm_from_name(
+        self,
+        name: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        out_algo: ph_algorithm_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_algorithm_name(self, algo: int, /) -> char_ptr: ...
+    def ph_batch_options_init(
+        self, options: ph_batch_options_t_ptr | void_ptr, /
+    ) -> int: ...
+    def ph_can_use_jpeg(self) -> int: ...
+    def ph_can_use_png(self) -> int: ...
+    def ph_can_use_webp(self) -> int: ...
+    def ph_compute_ahash(
+        self, ctx: ph_context_t_ptr | void_ptr, out_hash: uint64_t_ptr | void_ptr, /
+    ) -> int: ...
+    def ph_compute_bmh(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        out_digest: ph_digest_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_compute_color_hash(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        out_digest: ph_digest_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_compute_color_moments_hash(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        out_digest: ph_digest_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_compute_dhash(
+        self, ctx: ph_context_t_ptr | void_ptr, out_hash: uint64_t_ptr | void_ptr, /
+    ) -> int: ...
+    def ph_compute_digest(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        algo: int,
+        out_digest: ph_digest_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_compute_mhash(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        out_digest: ph_digest_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_compute_multi(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        flags: int,
+        out: uint64_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_compute_phash(
+        self, ctx: ph_context_t_ptr | void_ptr, out_hash: uint64_t_ptr | void_ptr, /
+    ) -> int: ...
+    def ph_compute_radial_hash(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        out_digest: ph_digest_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_compute_whash(
+        self, ctx: ph_context_t_ptr | void_ptr, out_hash: uint64_t_ptr | void_ptr, /
+    ) -> int: ...
+    def ph_context_get_dimensions(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        width: int_ptr | void_ptr,
+        height: int_ptr | void_ptr,
+        channels: int_ptr | void_ptr,
+        /,
+    ) -> None: ...
+    def ph_context_get_gray_weights(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        r: int_ptr | void_ptr,
+        g: int_ptr | void_ptr,
+        b: int_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_context_set_alpha_mode(
+        self, ctx: ph_context_t_ptr | void_ptr, mode: int, /
+    ) -> int: ...
+    def ph_context_set_auto_orient(
+        self, ctx: ph_context_t_ptr | void_ptr, enable: int, /
+    ) -> int: ...
+    def ph_context_set_block_params(
+        self, ctx: ph_context_t_ptr | void_ptr, block_size: int, /
+    ) -> int: ...
+    def ph_context_set_decode_scale(
+        self, ctx: ph_context_t_ptr | void_ptr, scale: int, /
+    ) -> int: ...
+    def ph_context_set_gamma(
+        self, ctx: ph_context_t_ptr | void_ptr, gamma: float, /
+    ) -> int: ...
+    def ph_context_set_gray_weights(
+        self, ctx: ph_context_t_ptr | void_ptr, r: int, g: int, b: int, /
+    ) -> int: ...
+    def ph_context_set_load_grayscale(
+        self, ctx: ph_context_t_ptr | void_ptr, enable: int, /
+    ) -> int: ...
+    def ph_context_set_max_pixels(
+        self, ctx: ph_context_t_ptr | void_ptr, max_pixels: int, /
+    ) -> int: ...
+    def ph_context_set_mhash_params(
+        self, ctx: ph_context_t_ptr | void_ptr, alpha: float, level: float, size: int, /
+    ) -> int: ...
+    def ph_context_set_phash_params(
+        self, ctx: ph_context_t_ptr | void_ptr, dct_size: int, reduction_size: int, /
+    ) -> int: ...
+    def ph_context_set_radial_params(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        projections: int,
+        samples: int,
+        sigma: float,
+        /,
+    ) -> int: ...
+    def ph_context_set_whash_mode(
+        self, ctx: ph_context_t_ptr | void_ptr, mode: int, /
+    ) -> int: ...
+    def ph_context_set_whash_remove_max_haar_ll(
+        self, ctx: ph_context_t_ptr | void_ptr, enable: int, /
+    ) -> int: ...
+    def ph_create(self, out_ctx: ph_context_t_ptr_ptr | void_ptr, /) -> int: ...
+    def ph_digest_from_hex(
+        self,
+        text: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        out: ph_digest_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_digest_info(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        algo: int,
+        out_size: size_t_ptr | void_ptr,
+        out_kind: ph_digest_kind_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_digest_to_hex(
+        self,
+        d: ph_digest_t_ptr | void_ptr,
+        out: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        out_size: int,
+        /,
+    ) -> int: ...
+    def ph_free(self, ctx: ph_context_t_ptr | void_ptr, /) -> None: ...
+    def ph_get_build_info(self) -> char_ptr: ...
+    def ph_get_error_string(self, err: int, /) -> char_ptr: ...
+    def ph_get_last_error_message(
+        self, ctx: ph_context_t_ptr | void_ptr, /
+    ) -> char_ptr: ...
+    def ph_hamming_distance(self, hash1: int, hash2: int, /) -> int: ...
+    def ph_hamming_distance_digest(
+        self, a: ph_digest_t_ptr | void_ptr, b: ph_digest_t_ptr | void_ptr, /
+    ) -> int: ...
+    def ph_hash_buffers(
+        self,
+        items: ph_batch_buffer_item_t_ptr | void_ptr,
+        n: int,
+        flags: int,
+        threads: int,
+        /,
+    ) -> int: ...
+    def ph_hash_buffers_ex(
+        self,
+        items: ph_batch_buffer_item_t_ptr | void_ptr,
+        n: int,
+        flags: int,
+        options: ph_batch_options_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_hash_files(
+        self, items: ph_batch_item_t_ptr | void_ptr, n: int, flags: int, threads: int, /
+    ) -> int: ...
+    def ph_hash_files_ex(
+        self,
+        items: ph_batch_item_t_ptr | void_ptr,
+        n: int,
+        flags: int,
+        options: ph_batch_options_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_hash_from_hex(
+        self,
+        hex: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        out: uint64_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_hash_to_hex(
+        self,
+        hash: int,
+        out: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        out_size: int,
+        /,
+    ) -> int: ...
+    def ph_histogram_intersection(
+        self,
+        a: ph_digest_t_ptr | void_ptr,
+        b: ph_digest_t_ptr | void_ptr,
+        out_similarity: double_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_is_loaded(self, ctx: ph_context_t_ptr | void_ptr, /) -> int: ...
+    def ph_l2_distance(
+        self, a: ph_digest_t_ptr | void_ptr, b: ph_digest_t_ptr | void_ptr, /
+    ) -> float: ...
+    def ph_load_from_file(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        filepath: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_load_from_memory(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        buffer: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        length: int,
+        /,
+    ) -> int: ...
+    def ph_load_from_pixels(
+        self,
+        ctx: ph_context_t_ptr | void_ptr,
+        pixels: bytes | char_ptr | uint8_t_ptr | void_ptr,
+        width: int,
+        height: int,
+        channels: int,
+        stride: int,
+        /,
+    ) -> int: ...
+    def ph_radial_similarity(
+        self,
+        a: ph_digest_t_ptr | void_ptr,
+        b: ph_digest_t_ptr | void_ptr,
+        out_pcc: double_ptr | void_ptr,
+        /,
+    ) -> int: ...
+    def ph_similarity(self, a: int, b: int, /) -> float: ...
+    def ph_similarity_digest(
+        self, a: ph_digest_t_ptr | void_ptr, b: ph_digest_t_ptr | void_ptr, /
+    ) -> float: ...
+    def ph_version(self) -> char_ptr: ...
+    def ph_version_number(self) -> int: ...
+
+class _FFI:
+    NULL: void_ptr
+    error: type[Exception]
+    @overload
+    def new(
+        self, cdecl: Literal["char *", "const char *"], init: bytes = ..., /
+    ) -> char_ptr: ...
+    @overload
+    def new(
+        self, cdecl: Literal["char[]", "const char[]"], init: int | bytes = ..., /
+    ) -> char_array: ...
+    @overload
+    def new(
+        self, cdecl: Literal["double *", "const double *"], init: float = ..., /
+    ) -> double_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["double[]", "const double[]"],
+        init: int | Sequence[float] = ...,
+        /,
+    ) -> double_array: ...
+    @overload
+    def new(
+        self, cdecl: Literal["int *", "const int *"], init: int = ..., /
+    ) -> int_ptr: ...
+    @overload
+    def new(
+        self, cdecl: Literal["int[]", "const int[]"], init: int | Sequence[int] = ..., /
+    ) -> int_array: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_algorithm_t *", "const ph_algorithm_t *"],
+        init: int = ...,
+        /,
+    ) -> ph_algorithm_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_algorithm_t[]", "const ph_algorithm_t[]"],
+        init: int | Sequence[int] = ...,
+        /,
+    ) -> ph_algorithm_t_array: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_batch_buffer_item_t *", "const ph_batch_buffer_item_t *"],
+        init: Mapping[str, object] | Sequence[object] = ...,
+        /,
+    ) -> ph_batch_buffer_item_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_batch_buffer_item_t[]", "const ph_batch_buffer_item_t[]"],
+        init: int | Sequence[ph_batch_buffer_item_t] = ...,
+        /,
+    ) -> ph_batch_buffer_item_t_array: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_batch_item_t *", "const ph_batch_item_t *"],
+        init: Mapping[str, object] | Sequence[object] = ...,
+        /,
+    ) -> ph_batch_item_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_batch_item_t[]", "const ph_batch_item_t[]"],
+        init: int | Sequence[ph_batch_item_t] = ...,
+        /,
+    ) -> ph_batch_item_t_array: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_batch_options_t *", "const ph_batch_options_t *"],
+        init: Mapping[str, object] | Sequence[object] = ...,
+        /,
+    ) -> ph_batch_options_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_batch_options_t[]", "const ph_batch_options_t[]"],
+        init: int | Sequence[ph_batch_options_t] = ...,
+        /,
+    ) -> ph_batch_options_t_array: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_context_t **"],
+        init: ph_context_t_ptr | void_ptr = ...,
+        /,
+    ) -> ph_context_t_ptr_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_context_t *[]"],
+        init: int | Sequence[ph_context_t_ptr] = ...,
+        /,
+    ) -> ph_context_t_ptr_array: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_digest_kind_t *", "const ph_digest_kind_t *"],
+        init: int = ...,
+        /,
+    ) -> ph_digest_kind_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_digest_kind_t[]", "const ph_digest_kind_t[]"],
+        init: int | Sequence[int] = ...,
+        /,
+    ) -> ph_digest_kind_t_array: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_digest_t *", "const ph_digest_t *"],
+        init: Mapping[str, object] | Sequence[object] = ...,
+        /,
+    ) -> ph_digest_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["ph_digest_t[]", "const ph_digest_t[]"],
+        init: int | Sequence[ph_digest_t] = ...,
+        /,
+    ) -> ph_digest_t_array: ...
+    @overload
+    def new(
+        self, cdecl: Literal["size_t *", "const size_t *"], init: int = ..., /
+    ) -> size_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["size_t[]", "const size_t[]"],
+        init: int | Sequence[int] = ...,
+        /,
+    ) -> size_t_array: ...
+    @overload
+    def new(
+        self, cdecl: Literal["uint64_t *", "const uint64_t *"], init: int = ..., /
+    ) -> uint64_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["uint64_t[]", "const uint64_t[]"],
+        init: int | Sequence[int] = ...,
+        /,
+    ) -> uint64_t_array: ...
+    @overload
+    def new(
+        self, cdecl: Literal["uint8_t *", "const uint8_t *"], init: int = ..., /
+    ) -> uint8_t_ptr: ...
+    @overload
+    def new(
+        self,
+        cdecl: Literal["uint8_t[]", "const uint8_t[]"],
+        init: int | Sequence[int] = ...,
+        /,
+    ) -> uint8_t_array: ...
+    @overload
+    def cast(
+        self, cdecl: Literal["char *", "const char *"], value: int | Pointer, /
+    ) -> char_ptr: ...
+    @overload
+    def cast(
+        self, cdecl: Literal["double *", "const double *"], value: int | Pointer, /
+    ) -> double_ptr: ...
+    @overload
+    def cast(
+        self, cdecl: Literal["int *", "const int *"], value: int | Pointer, /
+    ) -> int_ptr: ...
+    @overload
+    def cast(
+        self,
+        cdecl: Literal["ph_algorithm_t *", "const ph_algorithm_t *"],
+        value: int | Pointer,
+        /,
+    ) -> ph_algorithm_t_ptr: ...
+    @overload
+    def cast(
+        self,
+        cdecl: Literal["ph_batch_buffer_item_t *", "const ph_batch_buffer_item_t *"],
+        value: int | Pointer,
+        /,
+    ) -> ph_batch_buffer_item_t_ptr: ...
+    @overload
+    def cast(
+        self,
+        cdecl: Literal["ph_batch_item_t *", "const ph_batch_item_t *"],
+        value: int | Pointer,
+        /,
+    ) -> ph_batch_item_t_ptr: ...
+    @overload
+    def cast(
+        self,
+        cdecl: Literal["ph_batch_options_t *", "const ph_batch_options_t *"],
+        value: int | Pointer,
+        /,
+    ) -> ph_batch_options_t_ptr: ...
+    @overload
+    def cast(
+        self, cdecl: Literal["ph_context_t **"], value: int | Pointer, /
+    ) -> ph_context_t_ptr_ptr: ...
+    @overload
+    def cast(
+        self,
+        cdecl: Literal["ph_digest_kind_t *", "const ph_digest_kind_t *"],
+        value: int | Pointer,
+        /,
+    ) -> ph_digest_kind_t_ptr: ...
+    @overload
+    def cast(
+        self,
+        cdecl: Literal["ph_digest_t *", "const ph_digest_t *"],
+        value: int | Pointer,
+        /,
+    ) -> ph_digest_t_ptr: ...
+    @overload
+    def cast(
+        self, cdecl: Literal["size_t *", "const size_t *"], value: int | Pointer, /
+    ) -> size_t_ptr: ...
+    @overload
+    def cast(
+        self, cdecl: Literal["uint64_t *", "const uint64_t *"], value: int | Pointer, /
+    ) -> uint64_t_ptr: ...
+    @overload
+    def cast(
+        self, cdecl: Literal["uint8_t *", "const uint8_t *"], value: int | Pointer, /
+    ) -> uint8_t_ptr: ...
+    @overload
+    def cast(self, cdecl: Literal["void *"], value: int | Pointer, /) -> void_ptr: ...
+    @overload
+    def from_buffer(
+        self, python_buffer: Buffer, /, require_writable: bool = ...
+    ) -> char_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["char[]", "const char[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> char_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["double[]", "const double[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> double_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["int[]", "const int[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> int_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["ph_algorithm_t[]", "const ph_algorithm_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> ph_algorithm_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["ph_batch_buffer_item_t[]", "const ph_batch_buffer_item_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> ph_batch_buffer_item_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["ph_batch_item_t[]", "const ph_batch_item_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> ph_batch_item_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["ph_batch_options_t[]", "const ph_batch_options_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> ph_batch_options_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["ph_context_t *[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> ph_context_t_ptr_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["ph_digest_kind_t[]", "const ph_digest_kind_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> ph_digest_kind_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["ph_digest_t[]", "const ph_digest_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> ph_digest_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["size_t[]", "const size_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> size_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["uint64_t[]", "const uint64_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> uint64_t_array: ...
+    @overload
+    def from_buffer(
+        self,
+        cdecl: Literal["uint8_t[]", "const uint8_t[]"],
+        python_buffer: Buffer,
+        /,
+        require_writable: bool = ...,
+    ) -> uint8_t_array: ...
+    def string(self, cdata: char_ptr | uint8_t_ptr, maxlen: int = ...) -> bytes: ...
+    def buffer(self, cdata: Pointer, size: int = ...) -> CBuffer: ...
+    def memmove(
+        self, dest: Pointer | Buffer, src: Pointer | Buffer, n: int
+    ) -> None: ...
+    def gc(
+        self, cdata: _P, destructor: Callable[[_P], object] | None, size: int = ...
+    ) -> _P: ...
+    def release(self, cdata: Pointer, /) -> None: ...
+    def new_handle(self, x: object, /) -> void_ptr: ...
+    def from_handle(self, x: void_ptr, /) -> object: ...
+    def def_extern(
+        self,
+        name: str = ...,
+        error: object = ...,
+        onerror: Callable[..., object] | None = ...,
+    ) -> Callable[[_F], _F]: ...
+    def typeof(self, cdecl: str | CData | Callable[..., object], /) -> CType: ...
+    def sizeof(self, cdecl: str | CData, /) -> int: ...
+    def list_types(self) -> tuple[list[str], list[str], list[str]]: ...
+
+ffi: _FFI
+lib: _Lib