fstool 0.4.15

Build disk images and filesystems (ext2/3/4, MBR, GPT) from a directory tree and TOML spec, in the spirit of genext2fs.
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

//! Path helpers shared by the archive core. Archives store flat path
//! lists; [`ArchiveIndex`](super::ArchiveIndex) synthesises the
//! directory tree from these.

/// Normalise a path to start with `/` and not end with `/` (root is
/// `/`). Collapses repeated slashes and strips `.` components, matching
/// how tar normalises entry names.
pub fn normalise_path(p: &str) -> String {
    let mut out = String::new();
    for comp in p.split('/') {
        if comp.is_empty() || comp == "." {
            continue;
        }
        out.push('/');
        out.push_str(comp);
    }
    if out.is_empty() {
        out.push('/');
    }
    out
}

/// Split a normalised path into `(parent, leaf)`. The input must start
/// with `/` and not end with `/`.
pub fn split_path(p: &str) -> (&str, &str) {
    match p.rfind('/') {
        Some(0) => ("/", &p[1..]),
        Some(i) => (&p[..i], &p[i + 1..]),
        None => ("/", p),
    }
}

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

    #[test]
    fn normalise_handles_edges() {
        assert_eq!(normalise_path(""), "/");
        assert_eq!(normalise_path("/"), "/");
        assert_eq!(normalise_path("a"), "/a");
        assert_eq!(normalise_path("/a/"), "/a");
        assert_eq!(normalise_path("a/b/"), "/a/b");
        assert_eq!(normalise_path("./a//b/./c"), "/a/b/c");
        assert_eq!(normalise_path("///"), "/");
    }

    #[test]
    fn split_parent_and_leaf() {
        assert_eq!(split_path("/a"), ("/", "a"));
        assert_eq!(split_path("/a/b"), ("/a", "b"));
        assert_eq!(split_path("/a/b/c.txt"), ("/a/b", "c.txt"));
    }
}