shell-rs 0.2.6

Rust reimplementation of common coreutils APIs
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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

// Copyright (c) 2021 Xu Shaohua <shaohua@biofan.org>. All rights reserved.
// Use of this source is governed by Apache-2.0 License that can be found
// in the LICENSE file.

use std::fs::File;
use std::io::{BufRead, BufReader};
use std::str::FromStr;

use crate::error::{Error, ErrorKind};

#[derive(Debug, Default, Clone)]
pub struct Group {
    /// Group name.
    pub name: String,

    /// Group passwd, commonly empty.
    pub passwd: String,

    /// Group ID.
    pub gid: nc::gid_t,

    /// Usernames in this group.
    pub mem: Vec<String>,
}

impl FromStr for Group {
    type Err = Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let parts: Vec<&str> = s.split(':').collect();
        if parts.len() != 4 {
            return Err(Error::from_string(
                ErrorKind::PwdGroupError,
                format!("Invalid group entry: {}", s),
            ));
        }

        let gid = parts[2].parse()?;
        let mem = parts[3]
            .split(",")
            .map(|name| name.trim().to_string())
            .collect();
        Ok(Self {
            name: parts[0].to_string(),
            passwd: parts[1].to_string(),
            gid,
            mem,
        })
    }
}

#[derive(Debug)]
pub struct GroupIter {
    reader: BufReader<File>,
}

pub fn getgrent() -> Result<GroupIter, Error> {
    let fd = File::open("/etc/group")?;
    let reader = BufReader::new(fd);
    Ok(GroupIter { reader })
}

impl Iterator for GroupIter {
    type Item = Group;

    fn next(&mut self) -> Option<Self::Item> {
        let mut line = String::new();
        let len = self.reader.read_line(&mut line);
        if len.is_err() {
            return None;
        }

        match Group::from_str(&line.trim()) {
            Ok(p) => Some(p),
            Err(err) => {
                log::error!("{:?}", err);
                None
            }
        }
    }
}

pub fn getgrgid(gid: nc::gid_t) -> Result<Option<Group>, Error> {
    let iter = getgrent()?;
    for g in iter {
        if g.gid == gid {
            return Ok(Some(g));
        }
    }
    Ok(None)
}

pub fn getgrname(name: &str) -> Result<Option<Group>, Error> {
    let iter = getgrent()?;
    for g in iter {
        if g.name == name {
            return Ok(Some(g));
        }
    }
    Ok(None)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_group_iter() {
        let iter = getgrent();
        assert!(iter.is_ok());
        let mut iter = iter.unwrap();
        let g0 = iter.next();
        println!("g0: {:#?}", g0);
        assert!(g0.is_some());
    }

    #[test]
    fn test_getgrgid() {
        let mail_gid = 8;
        let g = getgrgid(mail_gid);
        assert!(g.is_ok());
        let g = g.unwrap();
        assert!(g.is_some());
        let g = g.unwrap();
        assert_eq!(g.gid, mail_gid);
    }

    #[test]
    fn test_getgrname() {
        let mail_name = "mail";
        let g = getgrname(mail_name);
        assert!(g.is_ok());
        let g = g.unwrap();
        assert!(g.is_some());
        let g = g.unwrap();
        assert_eq!(g.name, mail_name);
    }
}