[package]name = "blake3"version = "1.8.5"authors = ["Jack O'Connor <oconnor663@gmail.com>", "Samuel Neves"]description = "the BLAKE3 hash function"repository = "https://github.com/BLAKE3-team/BLAKE3"license = "CC0-1.0 OR Apache-2.0 OR Apache-2.0 WITH LLVM-exception"documentation = "https://docs.rs/blake3"readme = "README.md"edition = "2024"[features]default = ["std"]# The NEON implementation does not participate in dynamic feature detection,# which is currently x86-only. If "neon" is on, NEON support is assumed. Note# that AArch64 always supports NEON, but support on ARMv7 varies. The NEON# implementation uses C intrinsics and requires a C compiler.neon = []# The Wasm SIMD implementation does not participate in dynamic feature detection,# which is currently x86-only. If "wasm_simd" is on, Wasm SIMD support is assumed.# Note that not all Wasm implementations support the Wasm SIMD specification.# This may become the default in the future.wasm32_simd = []# Enables std::io traits, including impl Write for Hasher, impl Read and Seek# for OutputReader, and the Hasher::update_reader method. This feature is# enabled by default. (Previously this also controlled runtime CPU feature# detection on x86, but now we use the no-std-compatible `cpufeatures` crate# for that.)# Also enables the `std` feature of the `constant_time_eq` dependency, which# toggles a runtime feature check on 64-bit ARM targets.std = ["constant_time_eq/std"]# The `rayon` feature (disabled by default, but enabled for docs.rs) adds the# `update_rayon` and (in combination with `mmap` below) `update_mmap_rayon`# methods, for multithreaded hashing. However, even if this feature is enabled,# all other APIs remain single-threaded.## Implementation detail: We take a dependency on rayon-core instead of rayon,# because it builds faster and still includes all the APIs we need.rayon = ["dep:rayon-core"]# The `mmap` feature (disabled by default, but enabled for docs.rs) adds the# `update_mmap` and (in combination with `rayon` above) `update_mmap_rayon`# helper methods for memory-mapped IO.mmap = ["std", "dep:memmap2"]# Implement the zeroize::Zeroize trait for types in this crate.zeroize = ["dep:zeroize", "arrayvec/zeroize"]# This crate implements traits from the RustCrypto project, exposed here as the# "traits-preview" feature. However, these traits aren't stable, and they're# expected to change in incompatible ways before they reach 1.0. For that# reason, this crate makes no SemVer guarantees for this feature, and callers# who use it should expect breaking changes between patch versions of this# crate. (The "*-preview" feature name follows the conventions of the RustCrypto# "signature" crate.)traits-preview = ["dep:digest"]# ---------- Features below this line are undocumented and unstable. ----------# The following features are mainly intended for testing and benchmarking, and# they might change or disappear at any time without a major version bump.# It wasn't originally intended to expose "digest" as its own feature, but the# traits-preview feature above predated the "dep:" syntax in Cargo. Version# 1.5.2 of this crate started using "dep:" syntax, but that broke some callers# in the wild (https://solana.stackexchange.com/q/17787/29050). This feature# unbreaks those callers. When Cargo gains the ability to deprecate features,# this feature will be deprecated. Note that the relevant trait implementations# are still gated by "traits-preview".digest = ["dep:digest"]# By default on x86_64, this crate uses Samuel Neves' hand-written assembly# implementations for SSE4.1, AVX2, and AVX512. (These provide both the best# runtime performance, and the fastest build times.) And by default on 32-bit# x86, this crate uses Rust intrinsics implementations for SSE4.1 and AVX2, and# a C intrinsics implementation for AVX-512. In both cases, if a C compiler is# not detected, or if AVX-512 support is missing from the detected compiler,# build.rs automatically falls back to a pure Rust build. This feature forces# that fallback, for testing purposes. (Note that in CI testing, we set the# BLAKE3_CI environment variable, which instructs build.rs to error out rather# than doing an automatic fallback.)pure = []# As described above, on x86_64 this crate use assembly implementations by# default. Enabling the "prefer_intrinsics" feature makes this crate use# intrinsics implementations on both 32-bit and 64-bit x86, again for testing# purposes.prefer_intrinsics = []# Disable individual instruction sets. CI testing uses these flags to simulate# different levels of hardware SIMD support. Note that code for the# corresponding instruction set is still compiled; only detection is disabled.## As noted above, these flags are *for testing only* and are not stable. It's# possible that some users might find that their particular use case performs# better if e.g. AVX-512 is disabled, because of issues like CPU downclocking.# If that comes up, and if disabling the instruction set here at the feature# level turns out to be the right approach, then we can design a stable# feature. Until then, we reserve the right to break these features in a patch# release.no_sse2 = []no_sse41 = []no_avx2 = []no_avx512 = []no_neon = [][package.metadata.docs.rs]# Document the rayon/mmap methods and the Serialize/Deserialize/Zeroize impls on docs.rs.features = ["mmap", "rayon", "serde", "zeroize"][dependencies]arrayref = "0.3.5"arrayvec = { version = "0.7.4", default-features = false }constant_time_eq = { version = "0.4.2", default-features = false }cfg-if = "1.0.0"digest = { version = "0.11.2", features = ["mac"], optional = true }memmap2 = { version = "0.9", optional = true }rayon-core = { version = "1.12.1", optional = true }serde = { version = "1.0", default-features = false, features = ["derive"], optional = true }zeroize = { version = "1", default-features = false, optional = true }[target.'cfg(any(target_arch = "x86", target_arch = "x86_64"))'.dependencies]cpufeatures = "0.3.0"[dev-dependencies]hmac = "0.13.0"hex = "0.4.2"page_size = "0.6.0"rand = "0.10.0"chacha20 = "0.10.0"reference_impl = { path = "./reference_impl" }tempfile = "3.8.0"serde_json = "1.0.107"ciborium = "0.2.2"[build-dependencies]cc = "1.1.12"