file-hashing 0.1.2

Library for hashing files and folders
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
128
129
130
131
132
133
134
135
136
137
138
139

//! Folder functions

use super::*;
use std::path::PathBuf;

/// Get hash from **folder**
///
/// This function gets all files from a folder recursively and gets their hash
///
/// # Example
///
/// ```no_run
/// use std::path::PathBuf;
/// use blake2::{Blake2s256, Digest};
/// use file_hashing::get_hash_folder;
///
/// let mut hash = Blake2s256::new();
///
/// let result = get_hash_folder(
///     &PathBuf::from("/home/gladi/Pictures"),
///     &mut hash,
///     12,
///     |_| {},
/// )
/// .unwrap();
///
/// assert_eq!(result.len(), 64); // Blake2s256 len == 64
/// ```
///
/// # Error
///
/// * If the folder **is empty**, the **IOErrorKind::InvalidInput** error will be returned
pub fn get_hash_folder<HashType, P>(
    dir: P,
    hash: &mut HashType,
    num_threads: usize,
    progress: impl Fn(ProgressInfo),
) -> Result<String, IOError>
where
    HashType: DynDigest + Clone + std::marker::Send,
    P: AsRef<Path> + std::marker::Sync,
{
    get_hash_files(
        &fs::get_all_file_from_folder(dir),
        hash,
        num_threads,
        progress,
    )
}

/// Get hash from **folders**
///
/// This function gets all files from a folders recursively and gets their hash
///
/// # Example
///
/// ```no_run
/// use std::path::PathBuf;
/// use blake2::{Blake2s256, Digest};
/// use file_hashing::get_hash_folders;
///
/// let mut hash = Blake2s256::new();
///
/// let result = get_hash_folders(
///     &vec![PathBuf::from("/home/gladi/Pictures"), PathBuf::from("/home/gladi/Hentai")],
///     &mut hash,
///     12,
///     |_| {},
/// )
/// .unwrap();
///
/// assert_eq!(result.len(), 64); // Blake2s256 len == 64
/// ```
///
/// # Error
///
/// * If the folders **is empty**, the **IOErrorKind::InvalidInput** error will be returned
pub fn get_hash_folders<HashType, P>(
    dirs: &Vec<P>,
    hash: &mut HashType,
    num_threads: usize,
    progress: impl Fn(ProgressInfo),
) -> Result<String, IOError>
where
    HashType: DynDigest + Clone + std::marker::Send,
    P: AsRef<Path> + std::marker::Sync,
{
    let mut paths: Vec<PathBuf> = vec![];

    for dir in dirs {
        paths.append(&mut fs::get_all_file_from_folder(dir));
    }

    get_hash_files(&paths, hash, num_threads, progress)
}

#[cfg(test)]
mod tests {
    use crate::fs::extra;
    use blake2::{Blake2s256, Digest};

    #[test]
    fn get_hash_folder() {
        let mut hash = Blake2s256::new();
        let (temp_dir, _path) =
            extra::generate_random_folder_with_files(325, 32);

        let result = super::get_hash_folder(
            &temp_dir.to_path_buf(),
            &mut hash,
            12,
            |_| {},
        )
        .unwrap();

        println!("result: {}", result);
        assert_eq!(result.len(), 64); // Blake2s256 len == 64
    }

    #[test]
    fn get_hash_folders() {
        let mut hash = Blake2s256::new();
        let (temp_dir1, _path1) =
            extra::generate_random_folder_with_files(325, 32);
        let (temp_dir2, _path2) =
            extra::generate_random_folder_with_files(325, 32);

        let result = super::get_hash_folders(
            &vec![temp_dir1.to_path_buf(), temp_dir2.to_path_buf()],
            &mut hash,
            12,
            |_| {},
        )
        .unwrap();

        println!("result: {}", result);
        assert_eq!(result.len(), 64); // Blake2s256 len == 64
    }
}