Struct DeviceFlow 

pub struct DeviceFlow { /* private fields */ }

Runs the device flow: start_device_flow, show the code, then complete_login.

Implementations

impl DeviceFlow

pub fn new(config: AuthConfig) -> Result<Self, AuthError>

A flow on the real clock.

pub fn with_time( config: AuthConfig, clock: Arc<dyn Clock>, sleeper: Arc<dyn Sleeper>, ) -> Result<Self, AuthError>

A flow with an injected clock and sleep (tests).

pub async fn start_device_flow(&self) -> Result<DeviceCode, AuthError>

POST {auth_base}/device_authorization (AC1).

pub async fn poll( &self, code: &DeviceCode, interval: Duration, ) -> Result<PollOutcome, AuthError>

One POST {auth_base}/token for code (AC2). A transport error is “not yet” (the live API dropped one poll, see the spec’s edge cases).

pub async fn wait_for_session( &self, code: &DeviceCode, ) -> Result<Session, AuthError>

Polls until the user approves, the code expires or is denied (AC2), and builds the session from the token response (AC3).

pub async fn complete_login( &self, code: &DeviceCode, store: &dyn SessionStore, ) -> Result<Login, AuthError>

wait_for_session, one refresh under the PKCE client (AC19), then saves the session to store. When that refresh fails for any reason, the grant’s session is saved as is. Nothing is stored when the login fails.

Trait Implementations

impl Debug for DeviceFlow

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

Formats the value using the given formatter.