Struct RoleRegistry 

pub struct RoleRegistry { /* private fields */ }

Bidirectional mapping of role ids to RoleSpecs plus an assignment table tracking each member’s current role.

Implementations

impl RoleRegistry

pub fn new() -> Self

Empty registry.

pub fn define(&mut self, spec: RoleSpec)

Registers a role. Replaces any existing role with the same id.

pub fn define_role( &mut self, id: u32, name: impl Into<String>, permissions: Permissions, )

Convenience: defines a role from primitive components.

pub fn role(&self, id: u32) -> Option<&RoleSpec>

Looks up a role by id.

pub fn roles(&self) -> impl Iterator<Item = &RoleSpec>

Iterates every defined role.

pub fn assign( &mut self, member: MemberId, role_id: u32, ) -> Result<(), RoleError>

Assigns a role to a member.

pub fn role_of(&self, member: MemberId) -> Option<&RoleSpec>

Returns the role currently assigned to member, if any.

pub fn permissions_of(&self, member: MemberId) -> Permissions

Returns the effective permissions of member (zero if no role is assigned).

pub fn require(&self, member: MemberId, mask: u32) -> Result<(), RoleError>

Ok(()) if member carries every bit in mask; otherwise RoleError::Unauthorised.

Trait Implementations

impl Default for RoleRegistry

fn default() -> RoleRegistry

Returns the “default value” for a type.