Struct LoopbackFlow 

pub struct LoopbackFlow { /* private fields */ }

A started loopback flow: the authorization URL to open plus the capture server waiting on an ephemeral loopback port.

Implementations

impl LoopbackFlow

pub fn start( authorize_url: &str, client_id: &str, scopes: &[String], login_hint: Option<&str>, timeout: Duration, ) -> Result<Self, LoopbackError>

Binds an ephemeral loopback port and builds the authorization URL.

Errors

LoopbackError::Bind if the loopback listener cannot bind.

pub fn start_for_provider( provider: &MailProvider, login_hint: Option<&str>, timeout: Duration, ) -> Result<Self, LoopbackError>

Convenience wrapper binding a flow for a [MailProvider] preset.

Errors

LoopbackError::Bind if the loopback listener cannot bind.

pub fn port(&self) -> u16

The ephemeral port the capture server is listening on.

pub fn authorization_url(&self) -> &str

The full authorization URL for the user’s browser.

pub fn state(&self) -> &str

The single-use state token (exposed for tests and diagnostics).

pub fn wait_for_code(self) -> Result<CapturedCode, LoopbackError>

Waits for exactly one redirect, validates the single-use state, serves a confirmation page, and shuts the listener down.

Consumes self: after this returns (ok or err) the port is closed and a second redirect is refused.

Errors

LoopbackError variants for timeout, provider error, state mismatch, missing code, or I/O failure.