gxhash 0.1.7

No project description provided

gxhash-py

Python bindings for GxHash, a blazingly fast and robust non-cryptographic hashing algorithm.

Features

• Blazingly Fast: Minimal-overhead binding to leverage the full speed of GxHash.
• Zero Python: Pure Rust backend with zero additional Python runtime overhead.
• Fine-Grained Control: Build true multi-threaded or async hashing pipelines with GIL-free APIs.
• Faster File Hashing: Hash files using memory-mapped I/O via Rust — 3x faster than Python's sequential I/O.
• Async-Ready: Tokio-powered async hashing for fast and efficient concurrency.
• Fully Typesafe: Predictable, clean API with complete type safety.

Installation

You must have rustup installed and set to nightly.

pip install gxhash

You can install gxhash with the hybrid feature with the following.

pip install gxhash --config-settings build-args="--features hybrid"

By default, gxhash uses your system's vectorisation features. You can disable this by setting the relevant RUSTFLAGS.

RUSTFLAGS="-C target-cpu=x86-64 -C target-feature=+aes,+avx2" pip install gxhash

Usage

Hashing bytes.

from gxhash import GxHash32

def main():
    gxhash = GxHash32(seed=0)
    result = gxhash.hash(b"Hello, world!")

if __name__ == "__main__":
    main()

Hashing bytes asynchronously.

from asyncio import run
from gxhash import GxHash128

async def main():
    gxhash = GxHash128(seed=0)
    result = await gxhash.hash_async(b"Hello, world!")

if __name__ == "__main__":
    run(main())

Hashing a file.

from gxhash import GxHash64

def main():
    gxhash = GxHash64(seed=0)
    file = open("path/to/file.dmg", "rb")
    result = gxhash.hash_file(file)

if __name__ == "__main__":
    main()

Hashing a file asynchronously.

from asyncio import run
from gxhash import GxHash128

async def main():
    gxhash = GxHash128(seed=0)
    file = open("path/to/file.dmg", "rb")
    result = await gxhash.hash_file_async(file)

if __name__ == "__main__":
    run(main())