Struct MockPwdGrpProvider 

pub struct MockPwdGrpProvider(/* private fields */);

Mock provider of passwd/group data

An implementor of PwdGrpProvider which doesn’t look at the real system databases.

The Default contains just dummy entries for root.

You can pre-program it with passwd and group data.

The mock provider has interior mutability, so the trait can take non-mut references.

Note: this affects only the methods on PwdGrpProvider, not the plain functions in the pwd-grp crate toplevel.

Example

use pwd_grp::Group;
use pwd_grp::mock::MockPwdGrpProvider;
use pwd_grp::PwdGrpProvider as _;

let mock = MockPwdGrpProvider::new();
assert_eq!(mock.getgrnam::<String>("root").unwrap().unwrap().gid, 0);

mock.add_to_groups([Group {
    name: "wombats".to_string(),
    passwd: "*".to_string(),
    gid: 42,
    mem: vec!["alice".to_string()].into(),
    ..Group::blank()
}]);
let grent: Group = mock.getgrgid(42).unwrap().unwrap();
assert_eq!(grent.passwd, "*");

Implementations

impl MockPwdGrpProvider

pub fn new() -> Self

Create a new MockPwdGrpProvider containing dummy entries for root

impl MockPwdGrpProvider

pub fn new_empty() -> Self

Create a new empty MockPwdGrpProvider

All lookups will return None

pub fn add_to_passwds<I>(&self, data: impl IntoIterator<Item = I>)

where I: Into<Passwd<Box<[u8]>>>,

Append entries to the mock passwd database

pub fn add_to_groups<I>(&self, data: impl IntoIterator<Item = I>)

where I: Into<Group<Box<[u8]>>>,

Append entries to the mock group database

pub fn set_uids(&self, uids: RealEffectiveSavedIds)

Set the mock uids

pub fn set_gids(&self, gids: RealEffectiveSavedIds)

Set the mock gids

pub fn set_supplementary_groups(&self, supplementary_groups: Vec<uid_t>)

Set the mock supplementary_groups

Trait Implementations

impl Clone for MockPwdGrpProvider

fn clone(&self) -> MockPwdGrpProvider

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MockPwdGrpProvider

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MockPwdGrpProvider

fn default() -> MockPwdGrpProvider

Returns the “default value” for a type.

impl PwdGrpProvider for MockPwdGrpProvider

fn getpwnam<S: PwdGrpString>( &self, name: impl AsRef<<S as Deref>::Target>, ) -> Result<Option<Passwd<S>>>

Look up a passwd entry by name, returning strings as S

fn getpwuid<S: PwdGrpString>(&self, uid: uid_t) -> Result<Option<Passwd<S>>>

Look up a passwd entry by uid, returning strings as S

fn getgrnam<S: PwdGrpString>( &self, name: impl AsRef<<S as Deref>::Target>, ) -> Result<Option<Group<S>>>

Look up a group entry by name, returning strings as S

fn getgrgid<S: PwdGrpString>(&self, gid: uid_t) -> Result<Option<Group<S>>>

Look up a group entry by gid, returning strings as S

fn getuid(&self) -> uid_t

Get the current process’s (real) uid

fn geteuid(&self) -> uid_t

Get the current process’s effective uid

fn getresuid(&self) -> (uid_t, uid_t, uid_t)

Get the current process’s real, effective and saved set-uid

fn getgid(&self) -> uid_t

Get the current process’s (real) gid

fn getegid(&self) -> uid_t

Get the current process’s effective gid

fn getresgid(&self) -> (uid_t, uid_t, uid_t)

Get the current process’s real, effective and saved set-gid

fn getgroups(&self) -> Result<Vec<uid_t>>

Get the current process’s supplementary group list