Struct Principal 

pub struct Principal<I = ()> {
    pub name: String,
    pub identity: I,
}

The identity a successful Dispatch::authenticate resolves to. Stored on the Session and fed to Dispatch::capabilities for the HELLO reply (SRV-014).

Fields

name: String

Product-defined principal name (user, key id, …).

identity: I

The product’s own resolved identity — roles, permissions, quotas, tenant, whatever authorization actually needs.

Before this existed a product could only carry the name, so every privileged command had to re-resolve the user from its credential store. That was not merely a cost: the second lookup reads live state, so a user edited or deleted mid-session was evaluated against the new record. Carrying the identity here restores the other semantics — captured at AUTH, stable for the session — and makes the choice the product’s rather than an accident of the transport.

Defaults to () for products that only need the name.

Implementations

impl Principal

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

A principal carrying only a name — the Identity = () case.

impl<I> Principal<I>

pub fn with_identity(name: impl Into<String>, identity: I) -> Self

A principal carrying the product’s resolved identity.

Trait Implementations

impl<I: Clone> Clone for Principal<I>

fn clone(&self) -> Principal<I>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I: Debug> Debug for Principal<I>

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

Formats the value using the given formatter.

impl<I: Eq> Eq for Principal<I>

impl<I: PartialEq> PartialEq for Principal<I>

fn eq(&self, other: &Principal<I>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<I: PartialEq> StructuralPartialEq for Principal<I>