fmodeparser 0.1.0

A tool to parse the file permission into a unix-like text representation
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

/// accepts an 3-digit str represents the first three digits of the octal mode and
/// returns the file Kind
///
/// see its opposite [`symbol_to_file_type_number`](symbol_to_file_type_number)
pub fn file_type_number_to_symbol(file_type: &str) -> char {
    // returns the file type
    match file_type {
        "040" => 'd', // directory
        "120" => 'l', // symlink
        "020" => 'c', // character device
        "060" => 'b', // block device
        "010" => 'p', // fifo
        "140" => 's', // socket
        _ => '-',     // 100 for regular file
    }
}
/// accepts a single character represents one of the 7 file kinds of the file system and returns
/// the corresponding 3-digit octal number.
/// its the opposite of the [`file_type_number_to_symbol`](file_type_number_to_symbol)
pub fn symbol_to_file_type_number(symbol_type: char) -> String {
    // returns the file type as an octal string representation
    match symbol_type {
        'd' => "040", // directory
        'l' => "120", // symlink
        'c' => "020", // character device
        'b' => "060", // block device
        'p' => "010", // fifo
        's' => "140", // socket
        _ => "100",   // regular file
    }
    .to_string()
}

/// accepts a single 1-digit str number and returns its corresponding permission.
///
///see also [`permission_to_digit`](permission_to_digit)

pub fn digit_to_permission(num: &str) -> String {
    // returns the corresponding permission where the wildcard maps to 0 or else
    match num {
        "1" => "--x",
        "2" => "-w-",
        "3" => "-wx",
        "4" => "r--",
        "5" => "r-x",
        "6" => "rw-",
        "7" => "rwx",
        _ => "---", // if 0 or else
    }
    .to_string()
}

/// accepts a 3 str long and returns its corresponding digit number.
///
///see also [`digit_to_permission`](digit_to_permission)
pub fn permission_to_digit(perm: &str) -> String {
    // returns the corresponding permission where the wildcard maps to 0 or else
    match perm {
        "--x" => "1",
        "-w-" => "2",
        "-wx" => "3",
        "r--" => "4",
        "r-x" => "5",
        "rw-" => "6",
        "rwx" => "7",
        _ => "0", // if all are empty
    }
    .to_string()
}