Struct PendingDeviceCode 

pub struct PendingDeviceCode { /* private fields */ }

A device code flow that is waiting for the user to authorize.

Returned by DeviceCodeStrategy::begin. Display the user_code and verification_uri_complete to the user (or call open_in_browser), then call poll_for_token to wait for authorization.

Example

let pending = strategy.begin().await?;

println!("Go to: {}", pending.verification_uri_complete());
println!("Enter code: {}", pending.user_code());

let token = pending.poll_for_token().await?;

Implementations

impl PendingDeviceCode

pub fn user_code(&self) -> &str

The short code the user must enter to authorize this device.

pub fn verification_uri(&self) -> &str

The base verification URI (without the user code embedded).

pub fn verification_uri_complete(&self) -> &str

The full verification URI with the user code pre-filled.

pub fn expires_in(&self) -> u64

How many seconds the device code remains valid.

pub fn open_in_browser(&self) -> bool

Open the verification URI in the user’s default browser.

Returns true if the browser was opened successfully.

pub async fn poll_for_token(self) -> Result<Token, AuthError>

Poll the auth server until the user authorizes (or the code expires).

This method consumes self and blocks asynchronously, polling at a server-controlled interval (starting at 5 seconds). It returns a Token on success.

Errors

• AuthError::AccessDenied — the user rejected the request.
• AuthError::TokenExpired — the device code expired before the user authorized.
• AuthError::Request — a network error occurred while polling.

Trait Implementations

impl Debug for PendingDeviceCode

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

Formats the value using the given formatter.