Enum OAuth 

pub enum OAuth {
    Google,
    Microsoft {
        personal: bool,
    },
}

Who gives an account its access tokens, when it signs in with OAuth rather than a password.

Variants

Google

Google’s sign-in, the mail grant kept in the keyring (google::Purpose::Mail).

Microsoft

Microsoft’s sign-in (microsoft.rs); personal: an Outlook.com account (its microsoft_kind says so), else a work or school one.

Fields

personal: bool

Implementations

impl OAuth

pub fn of(account: &Account) -> Option<OAuth>

The provider of a mail account that signs in with one (auth = "google", auth = "microsoft"); None: a password. Calendars signed in with Google are not mail: their token is asked by the DAV client.

pub fn token(self, login: &str, fresh: bool) -> Result<String, SyncError>

An access token for login’s mail: kept in memory while it lasts, else asked with the refresh token; fresh asks a new one (after a refusal).

pub(crate) async fn token_async( self, login: &str, fresh: bool, ) -> Result<String, SyncError>

The same, from async code: the token is asked over blocking HTTP.

pub(crate) fn may_reach(self, host: &str, smtp: bool) -> Result<(), SyncError>

Whether a server may be given this provider’s token: Microsoft’s only to Microsoft’s own servers, named exactly (a configuration that names another is refused before any token is asked). Google’s as before.

pub(crate) fn refused(self, detail: &str) -> SyncError

What a token refused even fresh says: the access must be given again (it was withdrawn, or the mail was not ticked on the provider’s page).

pub(crate) fn not_connected(self, refusal: &str) -> Option<SyncError>

An IMAP refusal that a fresh token does not change, said for what it is: Microsoft’s “User is authenticated but not connected” (IMAP off for the mailbox). None: try a fresh token.

pub(crate) fn smtp_refused(self, refusal: &str) -> Option<SyncError>

An SMTP refusal that a fresh token does not change: Microsoft’s Authenticated SMTP switched off (5.7.139). None: try a fresh token.

pub(crate) fn mark(self, login: &str) -> Result<String, SyncError>

What stands for the account’s password, so that a watcher parked after a refusal sees a new sign-in as a new credential (fetch::Parked): the grant’s mark. None kept: the sign-in must be done again.

Trait Implementations

impl Clone for OAuth

fn clone(&self) -> OAuth

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for OAuth

impl Debug for OAuth

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

Formats the value using the given formatter.

impl Eq for OAuth

impl PartialEq for OAuth

fn eq(&self, other: &OAuth) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for OAuth