Struct CredentialResolver 

pub struct CredentialResolver { /* private fields */ }

Resolves the credential for a single command invocation, memoizing the result.

Resolution — including any interactive browser/OAuth flow — runs at most once: a handler and an authorizer that both ask share a single resolution, and the engine resolves it up front for AuthRequirement::Required commands. For Optional commands resolution is deferred until a handler or authorizer calls resolve or try_resolve, and --schema/--dry-run short-circuit before any resolution happens.

The resolved credential is memoized: a handler and an authorizer that both ask share a single resolution. Clones share the same underlying state, so the engine can observe (via peek) whatever a handler resolved.

Implementations

impl CredentialResolver

pub async fn resolve(&self) -> Result<Credential>

Resolves the credential, memoizing the result after the first success.

Errors

Returns an error when the command is marked no_auth (such commands have no credential), or when the auth provider fails to produce one.

pub async fn try_resolve(&self) -> Result<Option<Credential>>

Resolves the credential when one is available.

Returns Ok(None) for no-auth commands, Ok(Some(_)) on success, and propagates the provider error on failure. Use this for commands whose auth is genuinely optional; most commands should call resolve instead.

Errors

Propagates the auth provider error when resolution is attempted and fails.

pub fn peek(&self) -> Option<&Credential>

Returns the memoized credential without triggering resolution.

Yields None until something resolves the credential. Used by the engine to record identity in audit/activity output after a handler runs.

Trait Implementations

impl Clone for CredentialResolver

fn clone(&self) -> CredentialResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CredentialResolver

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

Formats the value using the given formatter.