iocore 3.1.0

IOCore is a safe library for unix CLI tools and Systems programming. IOCore provides the [`iocore::Path`] abstraction of file-system paths designed to replace most [`std::path`] and [`std::fs`] operations with practical methods, other abstractions include: - handling file-system permissions via [`iocore::PathPermissions`] powered by the crate [`trilobyte`]. - handling file-system timestamps via [`iocore::PathTimestamps`] granularly via [`iocore::PathDateTime`]. IOCore provides the [`iocore::walk_dir`] function and its companion trait [`iocore::WalkProgressHandler`] which traverses file-systems quickly via threads. IOcore provides [`iocore::User`] which provides unix user information such as uid, path to home etc. The module [`iocore::env`] provides [`iocore::env:args`] returns a [`Vec<String>`] from [`std::env:args`], and [`iocore::env:var`] that returns environment variables as string.
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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use k9::assert_equal;
use iocore::{User, guess_unix_home, unix_user_info_home, var as env_var, *};
use iocore_test::path_to_test_file;

#[cfg(target_os = "macos")]
#[test]
fn test_guess_unix_home_macosx() {
    let user = env_var("USER").unwrap();
    assert_equal!(guess_unix_home(&user).unwrap(), format!("/Users/{}", &user));
}

#[cfg(target_os = "linux")]
#[test]
fn test_guess_unix_home_linux() {
    let user = env_var("USER").unwrap();
    assert_equal!(guess_unix_home(&user).unwrap(), format!("/home/{}", &user));
}

#[test]
fn test_user_from_id_cmd_string() -> Result<()> {
    let stdout = format!(
        "uid=501(name) gid=20(group) groups=20(group),101(access_bpf),12(everyone),61(localaccounts),79(_appserverusr),80(admin),81(_appserveradm),98(_lpadmin),701(com.apple.sharepoint.group.1),702(com.apple.sharepoint.group.2),33(_appstore),100(_lpoperator),204(_developer),250(_analyticsusers),395(com.apple.access_ftp),398(com.apple.access_screensharing)"
    );
    let user = User::from_id_cmd_string(stdout)?;

    assert_equal!(user.gid, Some(20));
    assert_equal!(user.uid, 501);
    assert_equal!(user.name, "name");
    assert_equal!(user.group, Some("group".to_string()));
    assert_equal!(
        user.groups,
        vec![
            Group {
                gid: 501,
                name: format!("name"),
            },
            Group {
                gid: 20,
                name: format!("group"),
            },
            Group {
                gid: 20,
                name: format!("group"),
            },
            Group {
                gid: 101,
                name: format!("access_bpf"),
            },
            Group {
                gid: 12,
                name: format!("everyone"),
            },
            Group {
                gid: 61,
                name: format!("localaccounts"),
            },
            Group {
                gid: 79,
                name: format!("_appserverusr"),
            },
            Group {
                gid: 80,
                name: format!("admin"),
            },
            Group {
                gid: 81,
                name: format!("_appserveradm"),
            },
            Group {
                gid: 98,
                name: format!("_lpadmin"),
            },
            Group {
                gid: 701,
                name: format!("com.apple.sharepoint.group.1"),
            },
            Group {
                gid: 702,
                name: format!("com.apple.sharepoint.group.2"),
            },
            Group {
                gid: 33,
                name: format!("_appstore"),
            },
            Group {
                gid: 100,
                name: format!("_lpoperator"),
            },
            Group {
                gid: 204,
                name: format!("_developer"),
            },
            Group {
                gid: 250,
                name: format!("_analyticsusers"),
            },
            Group {
                gid: 395,
                name: format!("com.apple.access_ftp"),
            },
            Group {
                gid: 398,
                name: format!("com.apple.access_screensharing"),
            }
        ]
    );
    Ok(())
}

#[test]
fn test_unix_user_info_home() -> Result<()> {
    let passwd = path_to_test_file!("passwd.osx").write(
        [
            "root:*:0:0:System Administrator:/var/root:/bin/sh",
            "daemon:*:1:1:System Services:/var/root:/usr/bin/false",
            "_cvmsroot:*:212:212:CVMS Root:/var/empty:/usr/bin/false",
        ]
        .join("\n")
        .as_bytes(),
    )?;
    assert_equal!(unix_user_info_home(passwd.to_string().as_str(), "root", 0)?, "/var/root");
    Ok(())
}