yash-builtin 0.9.1

Implementation of the built-in utilities of yash
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

// This file is part of yash, an extended POSIX shell.
// Copyright (C) 2024 WATANABE Yuki
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

//! Formatting the file mode creating mask for printing

/// Formats the file mode creation mask in symbolic notation.
#[must_use]
pub fn format_symbolic(mask: u16) -> String {
    let mut result = String::with_capacity(18);
    result.push_str("u=");
    if mask & 0o400 != 0 {
        result.push('r');
    }
    if mask & 0o200 != 0 {
        result.push('w');
    }
    if mask & 0o100 != 0 {
        result.push('x');
    }
    result.push_str(",g=");
    if mask & 0o40 != 0 {
        result.push('r');
    }
    if mask & 0o20 != 0 {
        result.push('w');
    }
    if mask & 0o10 != 0 {
        result.push('x');
    }
    result.push_str(",o=");
    if mask & 0o4 != 0 {
        result.push('r');
    }
    if mask & 0o2 != 0 {
        result.push('w');
    }
    if mask & 0o1 != 0 {
        result.push('x');
    }
    result
}

#[test]
fn empty() {
    assert_eq!(format_symbolic(0), "u=,g=,o=");
}

#[test]
fn full() {
    assert_eq!(format_symbolic(0o777), "u=rwx,g=rwx,o=rwx");
}

#[test]
fn combination() {
    assert_eq!(format_symbolic(0o124), "u=x,g=w,o=r");
    assert_eq!(format_symbolic(0o241), "u=w,g=r,o=x");
    assert_eq!(format_symbolic(0o412), "u=r,g=x,o=w");
}

#[test]
fn bits_outside_permission_range() {
    // POSIX requires us to ignore bits other than the nine permission bits.
    assert_eq!(format_symbolic(0o1000), "u=,g=,o=");
}