cmn-hypha 0.4.0

The reference CMN client CLI — release spores, query synapses, resolve bonds, and manage your local mycelium.
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

use substrate::CmnEndpoint;

pub(super) fn dist_git_url(entry: &substrate::SporeDist) -> Option<&str> {
    entry.git_url()
}

pub(super) fn dist_git_ref(entry: &substrate::SporeDist) -> Option<&str> {
    entry.git_ref()
}

pub(super) fn dist_has_type(entry: &substrate::SporeDist, expected: &str) -> bool {
    entry.kind.as_str() == expected
}

pub(super) fn build_archive_url_from_endpoint(
    endpoint: &CmnEndpoint,
    hash: &str,
) -> Result<String, crate::HyphaError> {
    endpoint.resolve_url(hash).map_err(|e| {
        crate::HyphaError::new(
            "url_error",
            format!(
                "Invalid archive endpoint for format {:?}: {}",
                endpoint.format, e
            ),
        )
    })
}

pub(super) fn build_archive_delta_url_from_endpoint(
    endpoint: &CmnEndpoint,
    hash: &str,
    old_hash: &str,
) -> Result<Option<String>, crate::HyphaError> {
    endpoint.resolve_delta_url(hash, old_hash).map_err(|e| {
        crate::HyphaError::new(
            "url_error",
            format!(
                "Invalid archive delta endpoint for format {:?}: {}",
                endpoint.format, e
            ),
        )
    })
}

/// Validate a bond directory segment used under `.cmn/bonds/`.
pub(super) fn is_safe_bond_dir_name(name: &str) -> bool {
    substrate::is_safe_local_path_segment(name)
}

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

    #[test]
    fn bond_dir_validation_checks_safety_without_requiring_canonical_slug_format() {
        assert!(is_safe_bond_dir_name("Foo"));
        assert!(is_safe_bond_dir_name("foo_bar"));
        assert!(is_safe_bond_dir_name("b3.hash"));

        assert!(!is_safe_bond_dir_name(""));
        assert!(!is_safe_bond_dir_name(".."));
        assert!(!is_safe_bond_dir_name("bad/name"));
        assert!(!is_safe_bond_dir_name("bad\\name"));
        assert!(!is_safe_bond_dir_name("bad name"));
        assert!(!is_safe_bond_dir_name("bad\x01name"));
    }
}