Struct Dispatcher 

pub struct Dispatcher { /* private fields */ }

Routes auth operations to registered providers by name.

Clones share the same provider registry, so provider facades and transport injectors see later registration or replacement.

Implementations

impl Dispatcher

pub fn new() -> Self

Creates an empty dispatcher.

pub fn register(&mut self, provider: Arc<dyn AuthProvider>)

Registers or replaces a provider under its AuthProvider::name.

pub fn registered_names(&self) -> Vec<String>

Returns provider names in registration order.

pub async fn get_credential( &self, name: &str, env: &str, command: &str, tier: &str, ) -> Result<Credential>

Gets a credential from a named provider.

pub async fn get_credential_for( &self, name: &str, req: &CredentialRequest<'_>, ) -> Result<Credential>

Gets a credential from a named provider, passing the command’s full CredentialRequest so metadata-aware providers (e.g. OAuth scope step-up) can act on it.

pub async fn login(&self, name: &str, env: &str) -> Result<Credential>

Clears any cached credential, ignoring logout failures, then authenticates.

pub async fn login_with_scopes( &self, name: &str, env: &str, additional_scopes: &[String], ) -> Result<Credential>

Like login, but requests additional_scopes on top of the provider’s defaults.

The scopes are carried as CommandMeta::scopes on a synthesized request; providers without scope support ignore them.

pub async fn status(&self, name: &str, env: &str) -> Result<Credential>

Gets cached credential status from a named provider.

pub async fn logout(&self, name: &str, env: &str) -> Result<()>

Clears cached credentials for a named provider and environment.

pub async fn all_statuses(&self) -> Vec<StatusEntry>

Queries every provider for every cached environment it reports.

pub fn for_provider(&self, name: impl Into<String>) -> SingleProvider

Returns an auth-provider facade backed by this dispatcher.

Trait Implementations

impl Clone for Dispatcher

fn clone(&self) -> Dispatcher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dispatcher

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

Formats the value using the given formatter.

impl Default for Dispatcher

fn default() -> Dispatcher

Returns the “default value” for a type.