tidemark 0.1.3

Snapshot a directory tree and diff what changed - no git required. Built for humans and agents.
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

//! Content hashing (blake3) and symlink target capture.

use crate::error::{ErrorKind, TidemarkError};
use std::path::Path;

/// Hash a byte slice, returning `"blake3:<hex>"`.
pub fn hash_bytes(bytes: &[u8]) -> String {
    format!("blake3:{}", blake3::hash(bytes).to_hex())
}

/// Read a symlink's target as a UTF-8 string.
pub fn read_link(path: &Path) -> Result<String, TidemarkError> {
    let target = std::fs::read_link(path)?;
    target
        .to_str()
        .map(|s| s.replace('\\', "/"))
        .ok_or_else(|| {
            TidemarkError::new(
                ErrorKind::Unsupported,
                "non-UTF-8 symlink target".to_string(),
            )
        })
}

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

    #[test]
    fn same_content_same_hash() {
        assert_eq!(hash_bytes(b"hello"), hash_bytes(b"hello"));
    }

    #[test]
    fn different_content_different_hash() {
        assert_ne!(hash_bytes(b"hello"), hash_bytes(b"world"));
    }

    #[test]
    fn hash_has_prefix() {
        assert!(hash_bytes(b"x").starts_with("blake3:"));
    }
}