blake3

Changes since v1.0.8:

• Update pyo3 to v0.29. This version drops support for Python 3.13t, so we no longer build those wheels.
• Add riscv64 wheels.

version 1.0.8

Changes since 1.0.7:
- Set `gil_used = false`, to avoid activating the GIL when this module
is imported in freethreaded builds. We already managed the
blake3::Hasher with a Mutex internally, so not much else needed to
change.
- Fix a soundness bug where we released PyBuffer objects before we
finished reading the underlying bytes. This made it possible for other
threads to race to resize the buffer, which could've cause a
use-after-free. Now with the PyBuffer retained, other threads that try
to do that will fail and raise an exception.

What's Changed

• Update pyo3 to v0.26.
• MSRV is now Rust 1.80, driven by rayon.

What's Changed

• Update pyo3 requirement from 0.24.1 to 0.25.0 by @dependabot[bot] in #70
• Bump PyO3/maturin-action from 1.49.1 to 1.49.3 by @dependabot[bot] in #71
• Bump softprops/action-gh-release from 2.2.2 to 2.3.2 by @dependabot[bot] in #72
• Fix MyPy typing complaints on Python 3.8, with regression test by @moreati in #74

New Contributors

• @moreati made their first contribution in #74

Full Changelog: 1.0.5...1.0.6

What's Changed

• Bump PyO3/maturin-action from 1.45.0 to 1.46.0 by @dependabot in #59
• Bump softprops/action-gh-release from 2.1.0 to 2.2.1 by @dependabot in #61
• Bump pypa/gh-action-pypi-publish from 1.12.3 to 1.12.4 by @dependabot in #60
• Bump PyO3/maturin-action from 1.46.0 to 1.47.0 by @dependabot in #62
• Replace quansight-labs/setup-python with actions/setup-python by @ngoldbaum in #64
• Update pyo3 requirement from 0.23.4 to 0.24.1 by @dependabot in #65
• Bump PyO3/maturin-action from 1.47.0 to 1.47.3 by @dependabot in #66
• Bump softprops/action-gh-release from 2.2.1 to 2.2.2 by @dependabot in #67
• Bump PyO3/maturin-action from 1.47.3 to 1.49.1 by @dependabot in #68
• Add LICENSE file to wheels by @justeph in #69

New Contributors

• @ngoldbaum made their first contribution in #64
• @justeph made their first contribution in #69

Full Changelog: 1.0.4...1.0.5

What's Changed

• Bump version to 1.0.4 by @tiran in #58

Full Changelog: 1.0.3...1.0.4

Full Changelog: 1.0.2...1.0.2_rerelease

What's Changed

• Bump maturin, pyo3, add free-threaded 3.13t wheel by @ddelange in https://github.com/oconnor663/blake3-py/pull/47
• Bump gh-action-pypi-publish by @ddelange in https://github.com/oconnor663/blake3-py/pull/48
• Bump softprops/action-gh-release from 2.0.8 to 2.2.0 in the github-actions group by @dependabot in https://github.com/oconnor663/blake3-py/pull/49
• Fix windows 3.13t wheels by @ddelange in https://github.com/oconnor663/blake3-py/pull/50

New Contributors

• @dependabot made their first contribution in https://github.com/oconnor663/blake3-py/pull/49

Full Changelog: https://github.com/oconnor663/blake3-py/compare/1.0.0...1.0.1

Changes since 0.4.1:

• The public API hasn't changed for a long time, so the main purpose of this release is to "officially" stabilize it as-is.
• Prebuilt binaries are now published for more platforms, particularly AArch64. Thanks to @ddelange for implementing this.
• blake3.pyi (static typing stubs) now uses collections.abc.Buffer for bytes-like arguments. This is more correct and more permissive, but it means that static typechecking requires Python 3.12+.

version 0.4.1

Changes since 0.4.0:

• update and update_mmap now return self, so they can be called fluently.

version 0.4.0

Changes since 0.3.4:

• Add blake3.update_mmap.

version 0.3.4

Changes since 0.3.3:

• Add type stubs. See blake3.pyi.
• Update PyO3 to v0.20.

version 0.3.3

Changes since 0.3.2:

• Change blake3.__module__ from "blake3" to "blake3.blake3". This is the correct canonical path, related to some Maturin implementation details. This is intended to help tooling that relies on canonical paths, but most regular callers don't need to worry about this. See https://github.com/mkdocstrings/mkdocstrings/issues/451 for an example of a tool that needs to know this.
• Update PyO3 to v0.17.

version 0.3.2

Changes since 0.3.1:

• from blake3 import blake3; blake3.__module__ now correctly returns "blake3". Fixes #38.
• Updated Maturin to version 0.14.

version 0.3.1

Changes since 0.3.0:

• The experimental C implementation has been bumped to v0.0.1. Testers and reviewers can install this implementation from TestPyPI with: pip install -i https://test.pypi.org/simple/ blake3-experimental-c
• We now avoid releasing the GIL for short inputs and release the GIL for long outputs in addition to long inputs.
• The experimental C implementation now has GIL handling matching the Rust implementation.
• Both implementations now contain an internal mutex, to protect the state object from data races. However, it's still possible for data races to occur in the input buffer. (This is also the case for standard hashlib implementations.)

version 0.3.0

Changes since 0.2.1:

• There is now an experimental, API-compatible C implementation of the Python blake3 module in the c_impl/ directory. This a proof-of-concept for code that might be submitted to Python's standard hashlib module in the future. It probably won't be published on PyPI.
• The multithreading keyword arg previously on blake3() and update() has been replaced with the max_threads keyword arg on blake3() only. This accepts any positive integer, or the special value blake3.AUTO, which is equivalent to the previous behavior. This change helps compatiblity with the current C implementation, which ignores max_threads, and with a hypothetical future C implementation, which might want to store a thread pool on the hasher.
• Added the reset() method. This is potentially helpful for reusing threading resources, which are currently local to the hasher when max_threads is greater than 1 and not equal to blake3.AUTO.
• Added a usedforsecurity keyword arg, for compatibility with hashlib. The value is currently ignored.
• Most keyword arguments are now strictly keyword-only, and data arguments are now strictly positional-only.

version 0.2.1

Changes since 0.2.0:

• The "blake3" crate version has been updated to 1.0.0.
• Binary wheels for Apple Silicon are now built with GitHub releases and published to PyPI.

version 0.2.0

Changes since 0.1.8:

• Rename the "context" keyword argument to "derive_key_context" for clarity.
• Upgrade PyO3 to 0.14, which raises the minimum supported Python version to 3.6.
• The blake3.OUT_LEN and blake3.KEY_LEN module constants have been replaced with "digest_size" and "key_size" attributes on the hasher object itself. This is more consistent with how the standard hashlib module behaves. A "block_size" attribute has also been added.
• Add the blake3.__version__ module constant.
• Add the "neon" Cargo feature, which maps to the "neon" feature of the underlying blake3 crate.

version 0.1.8

Changes since 0.1.7:

• The hasher now supports the copy method and the name attribute, matching the conventions of hashlib. Added by @xkortex.
• The optional key argument can now be any buffer type, just like the data argument can. Previously key could only be bytes.

version 0.1.7

Changes since 0.1.6:

• Add support for hashing buffers of signed chars. This is uncommon, but it can come up with e.g. PyArrow. See https://github.com/oconnor663/blake3-py/issues/9 and https://github.com/oconnor663/blake3-py/pull/11.

version 0.1.6

Changes since 0.1.5:

• Upgrade to pyo3 0.11, which supports stable Rust.

version 0.1.5

Changes since 0.1.4:

• The Linux build is now properly manylinux-compatible. Previously the Linux binary wheels were linked against a too-recent version of glibc, leading to runtime errors on e.g. CentOS 7.

version 0.1.4

Changes since 0.1.3:

• Update to version 0.3.0 of the blake3 crate.

version 0.1.3

Changes since 0.1.2:

• The key keyword argument for blake3(), which enables the keyed mode.
• The context keyword argument for blake3(), which enables the key derivation mode.
• The length and seek keyword arguments for digest() and hexdigest(), which expose the XOF.
• The multithreading keyword argument for blake3() and update(), which enables Rayon-based multithreading.
• The "c" feature of the underlying Rust crate is now enabled by default, which brings in assembly implementations and AVX-512 support.

version 0.1.2

Changes since 0.1.1:

• Fix an issue that caused version 0.1.1 to be built and released in debug mode, leading to very bad performance.

version 0.1.1

Changes since 0.1.0:

• Binary wheels are now built automatically by GitHub Actions for common platforms. Currently Python 3.5-3.8 for Linux, macOS, and x86+x64 Windows.
• The PyPI release flow is now fully automated, triggered by pushing a new tag to GitHub.