blake2b-py

Blake2b hashing in Rust with Python bindings.

Developing

Install dependencies and build the Python extension in a virtual environment:

UV_CACHE_DIR=/tmp/uv-cache uv run --group test maturin develop

Run the test suites:

UV_CACHE_DIR=/tmp/uv-cache uv run --group test pytest
PYO3_PYTHON=.venv/bin/python cargo test test_

The slow EIP-152 vector can be run explicitly:

PYO3_PYTHON=.venv/bin/python cargo test --release test_f_eip_152_vec_8 -- --ignored --nocapture

Rust benchmarks use unstable Rust benchmark support and require nightly:

PYO3_PYTHON=.venv/bin/python cargo +nightly bench --features nightly-benches

You may need to specify the MACOSX_DEPLOYMENT_TARGET environment variable to your version of macOS.

Building and Releasing

Build local artifacts with maturin:

UV_CACHE_DIR=/tmp/uv-cache uv run --group build maturin build --release

The package version is currently sourced from Cargo.toml. To release, update that version, create a GitHub release for the corresponding tag, and let GitHub Actions build and publish packages to PyPI through trusted publishing.

PyPI must be configured to trust the ApeWorX/blake2b-py GitHub repository and the .github/workflows/publish.yaml workflow before the release job can publish.