path-rs 0.1.0

Cross-platform path expansion, normalization, traversal, searching, and caching
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

use path_rs::{PathError, normalize};
use proptest::prelude::*;
use std::path::PathBuf;

#[test]
fn basic_normalization() {
    assert_eq!(normalize(".").unwrap(), PathBuf::from("."));
    assert_eq!(normalize("./").unwrap(), PathBuf::from("."));
    assert_eq!(normalize("foo").unwrap(), PathBuf::from("foo"));
    assert_eq!(normalize("./foo").unwrap(), PathBuf::from("foo"));
    assert_eq!(normalize("foo/../bar").unwrap(), PathBuf::from("bar"));
    assert_eq!(normalize("foo//bar").unwrap(), PathBuf::from("foo/bar"));
    assert_eq!(normalize("foo///bar").unwrap(), PathBuf::from("foo/bar"));
    assert_eq!(normalize("foo/./bar").unwrap(), PathBuf::from("foo/bar"));
    assert_eq!(normalize("../foo").unwrap(), PathBuf::from("../foo"));
    assert_eq!(normalize("foo/../../bar").unwrap(), PathBuf::from("../bar"));
}

#[test]
fn empty_input() {
    assert!(matches!(normalize(""), Err(PathError::EmptyInput)));
}

#[cfg(unix)]
#[test]
fn unix_absolute_root() {
    assert_eq!(normalize("/").unwrap(), PathBuf::from("/"));
    assert_eq!(normalize("/foo/../bar").unwrap(), PathBuf::from("/bar"));
    // Cannot escape root
    assert_eq!(normalize("/../foo").unwrap(), PathBuf::from("/foo"));
}

#[cfg(windows)]
#[test]
fn windows_drive_absolute() {
    let p = normalize(r"C:\Users\floris\..\other").unwrap();
    assert_eq!(p, PathBuf::from(r"C:\Users\other"));
    assert!(matches!(
        normalize(r"C:foo"),
        Err(PathError::DriveRelativePath { .. })
    ));
    assert!(matches!(
        normalize(r"C:"),
        Err(PathError::DriveRelativePath { .. })
    ));
}

proptest! {
    #[test]
    fn normalize_is_idempotent(s in "[A-Za-z0-9_./]{1,64}") {
        // Avoid empty and pure-dot-oddities that may map differently.
        if s.trim().is_empty() {
            return Ok(());
        }
        // Skip Windows drive-relative-looking inputs on all platforms for simplicity.
        if s.len() >= 2 && s.as_bytes()[1] == b':' {
            return Ok(());
        }
        if let Ok(once) = normalize(&s) {
            let twice = normalize(&once).unwrap();
            prop_assert_eq!(once, twice);
        }
    }
}