x-path 0.1.0-alpha.0

x-path is a if-it-compiles-it-works solution for safe Rust paths with abs/rel and file/dir variants for API safety and cross platform support
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

pub(crate) trait CharExt {
    fn is_slash(&self) -> bool;
    fn is_forbidden_in_path(&self) -> bool;
    fn is_allowed_in_environment_var(&self) -> bool;
}

impl CharExt for char {
    fn is_slash(&self) -> bool {
        *self == '\\' || *self == '/'
    }

    /// https://en.wikipedia.org/wiki/Filename#Reserved_characters_and_words
    fn is_forbidden_in_path(&self) -> bool {
        #[cfg(not(feature = "strict"))]
        {
            self.is_ascii_control() || *self == ':'
        }
        #[cfg(feature = "strict")]
        {
            self.is_ascii_control()
                || [':', '"', '*', '/', '<', '>', '?', '\\', '|'].contains(&self)
        }
    }

    fn is_allowed_in_environment_var(&self) -> bool {
        self.is_ascii_uppercase() || self.is_ascii_digit() || *self == '_'
    }
}