qubit-fs 0.1.0

Pluggable filesystem abstraction for Rust
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

use qubit_fs::FsPath;

#[test]
fn test_root_path_reports_root_properties() {
    let root = FsPath::root();

    assert!(root.is_absolute());
    assert_eq!("/", root.as_str());
    assert_eq!(None, root.parent());
    assert_eq!(None, root.file_name());
    assert_eq!(None, root.file_extension());
    assert_eq!("/", root.to_string());
}

#[test]
fn test_parse_normalizes_segments_and_rejects_invalid_paths() {
    let path = FsPath::parse("/a//b/./c").expect("path should parse");

    assert_eq!("/a/b/c", path.as_str());
    assert_eq!(Some("c"), path.file_name());
    assert!(FsPath::parse("").is_err());
    assert!(FsPath::parse("../escape").is_err());
    assert!(FsPath::parse("bad\0path").is_err());
    assert_eq!(
        "/",
        FsPath::parse("/a/..")
            .expect("absolute parent normalization should reach root")
            .as_str(),
    );
    assert_eq!(
        "b",
        FsPath::parse("a/../b")
            .expect("relative parent normalization should succeed")
            .as_str(),
    );
    assert!(FsPath::parse("a/..").is_err());
}

#[test]
fn test_parent_and_join_handle_root_absolute_and_relative_paths() {
    let root = FsPath::root();
    let path = FsPath::parse("/a//b/./c").expect("path should parse");

    assert_eq!("/a/b", path.parent().expect("path should have parent").as_str());
    assert_eq!(
        "/a/b/d",
        path.parent()
            .expect("parent should exist")
            .join("d")
            .expect("join should succeed")
            .as_str(),
    );
    assert_eq!(
        "/absolute",
        path.join("/absolute")
            .expect("absolute child should replace base")
            .as_str(),
    );
    assert_eq!("/child", root.join("child").expect("root join should succeed").as_str(),);
    assert_eq!(
        "/",
        FsPath::parse("/a")
            .expect("path should parse")
            .parent()
            .expect("absolute child should have root parent")
            .as_str(),
    );
    assert_eq!(
        "a",
        FsPath::parse("a/b")
            .expect("relative path should parse")
            .parent()
            .expect("relative nested path should have parent")
            .as_str(),
    );
    assert_eq!(
        None,
        FsPath::parse("file")
            .expect("single relative path should parse")
            .parent(),
    );
}

#[test]
fn test_file_extension_returns_last_meaningful_extension() {
    assert_eq!(
        Some("gz"),
        FsPath::parse("/a/archive.tar.gz")
            .expect("path should parse")
            .file_extension(),
    );
    assert_eq!(
        None,
        FsPath::parse("/a/.profile")
            .expect("path should parse")
            .file_extension(),
    );
    assert_eq!(
        None,
        FsPath::parse("/a/trailing.")
            .expect("path should parse")
            .file_extension(),
    );
}