Struct Subject

pub struct Subject { /* private fields */ }

A subject represents an entity that can be assigned roles (user, group, service, etc.).

Implementations

impl Subject

pub fn new(id: impl Into<String>) -> Self

Create a new subject with a generated UUID.

pub fn user(id: impl Into<String>) -> Self

Create a new user subject.

pub fn group(id: impl Into<String>) -> Self

Create a new group subject.

pub fn service(id: impl Into<String>) -> Self

Create a new service subject.

pub fn device(id: impl Into<String>) -> Self

Create a new device subject.

pub fn custom(id: impl Into<String>, custom_type: impl Into<String>) -> Self

Create a new custom subject type.

pub fn id(&self) -> &str

Get the subject’s unique identifier.

pub fn subject_type(&self) -> &SubjectType

Get the subject’s type.

pub fn with_display_name(self, display_name: impl Into<String>) -> Self

Set the display name for the subject.

pub fn display_name(&self) -> Option<&str>

Get the subject’s display name.

pub fn set_display_name(&mut self, display_name: impl Into<String>)

Set the display name.

pub fn with_attribute( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add an attribute to the subject.

pub fn set_attribute( &mut self, key: impl Into<String>, value: impl Into<String>, )

Set an attribute on the subject.

pub fn attribute(&self, key: &str) -> Option<&str>

Get an attribute value.

pub fn attributes(&self) -> &HashMap<String, String>

Get all attributes.

pub fn remove_attribute(&mut self, key: &str) -> Option<String>

Remove an attribute.

pub fn has_attribute(&self, key: &str) -> bool

Check if the subject has a specific attribute.

pub fn effective_name(&self) -> &str

Get the effective name for display purposes.

Trait Implementations

impl Clone for Subject

fn clone(&self) -> Subject

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Subject

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

Formats the value using the given formatter.

impl Display for Subject

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

Formats the value using the given formatter.

impl PartialEq for Subject

fn eq(&self, other: &Subject) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Subject

impl StructuralPartialEq for Subject