uzers 0.12.2

Continuation of users, a library for accessing Unix users and groups
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

use std::ffi::OsStr;
use std::sync::Arc;

use libc::{gid_t, uid_t};

use base::{Group, User};

/// Trait for producers of users.
pub trait Users {
    /// Returns a `User` if one exists for the given user ID; otherwise, returns `None`.
    fn get_user_by_uid(&self, uid: uid_t) -> Option<Arc<User>>;

    /// Returns a `User` if one exists for the given username; otherwise, returns `None`.
    fn get_user_by_name<S: AsRef<OsStr> + ?Sized>(&self, username: &S) -> Option<Arc<User>>;

    /// Returns the user ID for the user running the process.
    fn get_current_uid(&self) -> uid_t;

    /// Returns the username of the user running the process.
    fn get_current_username(&self) -> Option<Arc<OsStr>>;

    /// Returns the effective user id.
    fn get_effective_uid(&self) -> uid_t;

    /// Returns the effective username.
    fn get_effective_username(&self) -> Option<Arc<OsStr>>;
}

/// Trait for producers of groups.
pub trait Groups {
    /// Returns a `Group` if one exists for the given group ID; otherwise, returns `None`.
    fn get_group_by_gid(&self, gid: gid_t) -> Option<Arc<Group>>;

    /// Returns a `Group` if one exists for the given groupname; otherwise, returns `None`.
    fn get_group_by_name<S: AsRef<OsStr> + ?Sized>(&self, group_name: &S) -> Option<Arc<Group>>;

    /// Returns the group ID for the user running the process.
    fn get_current_gid(&self) -> gid_t;

    /// Returns the group name of the user running the process.
    fn get_current_groupname(&self) -> Option<Arc<OsStr>>;

    /// Returns the effective group id.
    fn get_effective_gid(&self) -> gid_t;

    /// Returns the effective group name.
    fn get_effective_groupname(&self) -> Option<Arc<OsStr>>;
}

/// Trait for providers of user iterators.
pub trait AllUsers {
    /// [`User`] iterator returned by [`get_all_users`][Self::get_all_users].
    type UserIter<'a>: Iterator<Item = &'a User>
    where
        Self: 'a;

    /// Creates a new iterator over every user.
    fn get_all_users(&self) -> Self::UserIter<'_>;
}

/// Trait for providers of group iterators.
pub trait AllGroups {
    /// [`Group`] iterator returned by [`get_all_groups`][Self::get_all_groups].
    type GroupIter<'a>: Iterator<Item = &'a Group>
    where
        Self: 'a;

    /// Creates a new iterator over every group.
    fn get_all_groups(&self) -> Self::GroupIter<'_>;
}