lean-ctx-fs 0.2.0

Filesystem and environment foundation for LeanCTX | OSS: atomic writes, file locks, hashing, JSONC, home resolution.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

// SPDX-License-Identifier: Apache-2.0
//! Central hashing utility using BLAKE3.
//!
//! Replaces scattered MD5 helpers with a single, fast, non-cryptographic
//! hash function. BLAKE3 runs at 8+ GB/s (vs MD5 ~3 GB/s) and produces
//! collision-resistant 256-bit digests.

/// Return a hex-encoded BLAKE3 hash of the input bytes.
#[inline]
pub fn hash_hex(data: &[u8]) -> String {
    blake3::hash(data).to_hex().to_string()
}

/// Convenience: hash a string slice and return hex digest.
#[inline]
pub fn hash_str(s: &str) -> String {
    hash_hex(s.as_bytes())
}

/// Short hash (first 16 hex chars = 64 bits) for cache keys and fingerprints.
#[inline]
pub fn hash_short(s: &str) -> String {
    let full = blake3::hash(s.as_bytes()).to_hex();
    full[..16].to_string()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn deterministic() {
        let a = hash_hex(b"hello");
        let b = hash_hex(b"hello");
        assert_eq!(a, b);
        assert_eq!(a.len(), 64);
    }

    #[test]
    fn short_hash_length() {
        let s = hash_short("test");
        assert_eq!(s.len(), 16);
    }

    #[test]
    fn different_inputs_differ() {
        assert_ne!(hash_str("foo"), hash_str("bar"));
    }
}