batpak 0.7.0

Event sourcing with causal graphs and policy gates. Sync API, zero async.
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

//! Path-byte materialization for stable identity digests (not display strings).

use std::borrow::Cow;
use std::path::Path;

#[cfg(any(not(unix), test))]
fn normalize_non_unix_path_identity_string(raw: &str) -> Cow<'_, str> {
    if let Some(rest) = raw.strip_prefix("\\\\?\\UNC\\") {
        let mut normalized = String::with_capacity(raw.len() - 6);
        normalized.push_str("\\\\");
        normalized.push_str(rest);
        return Cow::Owned(normalized);
    }

    if let Some(rest) = raw.strip_prefix("\\\\?\\") {
        return Cow::Borrowed(rest);
    }

    Cow::Borrowed(raw)
}

/// Os-native path bytes suitable for hashing as store identity material.
///
/// On Unix this is the exact `OsStr` byte sequence. On other targets it falls
/// back to a UTF-8 lossy encoding allocation so hashing remains defined. Windows
/// verbatim prefixes are presentation details from canonicalization, so they are
/// stripped before hashing.
#[must_use]
pub(crate) fn path_bytes_for_identity_digest(path: &Path) -> Cow<'_, [u8]> {
    #[cfg(unix)]
    {
        use std::os::unix::ffi::OsStrExt;
        Cow::Borrowed(path.as_os_str().as_bytes())
    }
    #[cfg(not(unix))]
    {
        let s = path.to_string_lossy();
        Cow::Owned(
            normalize_non_unix_path_identity_string(&s)
                .as_bytes()
                .to_vec(),
        )
    }
}

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

    #[test]
    fn non_unix_path_identity_strips_windows_verbatim_prefix() {
        assert_eq!(
            normalize_non_unix_path_identity_string("\\\\?\\batpak\\store").as_ref(),
            "batpak\\store"
        );
        assert_eq!(
            normalize_non_unix_path_identity_string("\\\\?\\UNC\\server\\share\\store").as_ref(),
            "\\\\server\\share\\store"
        );
        assert_eq!(
            normalize_non_unix_path_identity_string("batpak\\store").as_ref(),
            "batpak\\store"
        );
    }
}