gxhash 0.3.1

Python bindings for GxHash

gxhash-py

128-bit hash throughput (MiB/s)

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

Highlights

• Fastest non-cryptographic hash algorithm of its class.
• Guaranteed stable hashes across all supported platforms.
• Pure Rust backend with zero additional Python runtime overhead.
• First-class support for parallel asynchronous hashing.
• Predictable, clean API with complete type safety.

Installation

gxhash is available on PyPI and can be installed via pip.

pip install gxhash

[!IMPORTANT]
This is only possible on systems that support VAES and AVX2 instruction sets.

For the best throughput, you can allow gxhash to use wider registers by passing the MATURIN_PEP517_ARGS environment variable.

MATURIN_PEP517_ARGS="--features hybrid" pip install gxhash

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() -> None:
    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() -> None:
    gxhash = GxHash128(seed=0)
    result = await gxhash.hash_async(b"Hello, world!")

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

Testing

You can run a comprehensive suite of tests with the following.

cargo test