blazehash 0.2.4

Forensic file hasher — hashdeep for the modern era, BLAKE3 by default
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

use blazehash::algorithm::Algorithm;
use blazehash::piecewise::hash_file_piecewise;
use std::io::Write;
use tempfile::NamedTempFile;

#[test]
fn piecewise_small_file_one_chunk() {
    let mut f = NamedTempFile::new().unwrap();
    f.write_all(b"hello world").unwrap();
    f.flush().unwrap();

    let results = hash_file_piecewise(f.path(), &[Algorithm::Blake3], 1024).unwrap();
    assert_eq!(results.len(), 1);
    assert_eq!(results[0].offset, 0);
    assert_eq!(results[0].chunk_size, 11);
}

#[test]
fn piecewise_splits_file() {
    let mut f = NamedTempFile::new().unwrap();
    let data = vec![0x42u8; 1000];
    f.write_all(&data).unwrap();
    f.flush().unwrap();

    let results = hash_file_piecewise(f.path(), &[Algorithm::Blake3], 400).unwrap();
    assert_eq!(results.len(), 3);
    assert_eq!(results[0].offset, 0);
    assert_eq!(results[0].chunk_size, 400);
    assert_eq!(results[1].offset, 400);
    assert_eq!(results[1].chunk_size, 400);
    assert_eq!(results[2].offset, 800);
    assert_eq!(results[2].chunk_size, 200);
}

#[test]
fn piecewise_different_chunks_different_hashes() {
    let mut f = NamedTempFile::new().unwrap();
    let mut data = vec![0x41u8; 100];
    data.extend(vec![0x42u8; 100]);
    f.write_all(&data).unwrap();
    f.flush().unwrap();

    let results = hash_file_piecewise(f.path(), &[Algorithm::Blake3], 100).unwrap();
    assert_eq!(results.len(), 2);
    assert_ne!(
        results[0].hashes[&Algorithm::Blake3],
        results[1].hashes[&Algorithm::Blake3]
    );
}

#[test]
fn piecewise_empty_file() {
    let f = NamedTempFile::new().unwrap();
    let results = hash_file_piecewise(f.path(), &[Algorithm::Blake3], 1024).unwrap();
    assert!(results.is_empty());
}

#[test]
fn piecewise_exact_chunk_multiple() {
    let mut f = NamedTempFile::new().unwrap();
    let data = vec![0x42u8; 200]; // exactly 2 chunks of 100
    f.write_all(&data).unwrap();
    f.flush().unwrap();

    let results = hash_file_piecewise(f.path(), &[Algorithm::Blake3], 100).unwrap();
    assert_eq!(results.len(), 2);
    assert_eq!(results[0].chunk_size, 100);
    assert_eq!(results[1].chunk_size, 100);
    assert_eq!(results[0].offset, 0);
    assert_eq!(results[1].offset, 100);
}

#[test]
fn piecewise_multiple_algorithms() {
    let mut f = NamedTempFile::new().unwrap();
    f.write_all(b"piecewise multi algo test").unwrap();
    f.flush().unwrap();

    let algos = vec![Algorithm::Blake3, Algorithm::Sha256, Algorithm::Md5];
    let results = hash_file_piecewise(f.path(), &algos, 1024).unwrap();
    assert_eq!(results.len(), 1);
    assert_eq!(results[0].hashes.len(), 3);
    for algo in &algos {
        assert!(results[0].hashes.contains_key(algo));
    }
}

#[test]
fn piecewise_nonexistent_file_returns_error() {
    let result = hash_file_piecewise(
        std::path::Path::new("/nonexistent/file.txt"),
        &[Algorithm::Blake3],
        1024,
    );
    assert!(result.is_err());
}

#[test]
fn piecewise_single_byte_file() {
    let mut f = NamedTempFile::new().unwrap();
    f.write_all(b"x").unwrap();
    f.flush().unwrap();

    let results = hash_file_piecewise(f.path(), &[Algorithm::Blake3], 1024).unwrap();
    assert_eq!(results.len(), 1);
    assert_eq!(results[0].chunk_size, 1);
    assert_eq!(results[0].offset, 0);
}

#[test]
fn piecewise_hashes_match_full_file_hash() {
    // For a file that fits in one chunk, piecewise hash should match hash_file
    use blazehash::hash::hash_file;

    let mut f = NamedTempFile::new().unwrap();
    f.write_all(b"consistency check").unwrap();
    f.flush().unwrap();

    let piecewise = hash_file_piecewise(f.path(), &[Algorithm::Blake3], 4096).unwrap();
    let full = hash_file(f.path(), &[Algorithm::Blake3], false, false).unwrap();

    assert_eq!(piecewise.len(), 1);
    assert_eq!(
        piecewise[0].hashes[&Algorithm::Blake3],
        full.hashes[&Algorithm::Blake3]
    );
}