Struct mal_api::oauth::OauthClient

pub struct OauthClient<State = Unauthenticated> { /* private fields */ }

Client used to navigate and manage Oauth credentials with MAL

Implementations

impl OauthClient<Unauthenticated>

pub fn new() -> Result<Self, OauthError>

pub fn generate_auth_url(&mut self) -> String

Generate an authorization URL for the user to navigate to, to begin the authorization process

pub async fn authenticate( self, authorization_response: RedirectResponse ) -> Result<OauthClient<Authenticated>, Box<dyn Error>>

Try and authenticate the client to get an authenticated Oauth client back.

pub fn load_from_config() -> Result<OauthClient<Authenticated>, OauthError>

Load Oauth credentials from the MAL config

It is recommended to refresh the client after loading to ensure that all of the tokens are still valid

pub fn load_from_values( access_token: String, refresh_token: String, expires_at: u64 ) -> Result<OauthClient<Authenticated>, OauthError>

Load an authenticated OauthClient by passing the necessary values

It’s recommended to refresh the client after to ensure that the given values are still valid credentials.

Note: This method still relies on the MAL_CLIENT_ID, MAL_CLIENT_SECRET, and MAL_REDIRECT_URL environment variables being set

impl OauthClient<Authenticated>

pub fn get_access_token_secret(&self) -> &String

Get the access token secret value

pub fn get_refresh_token_secret(&self) -> &String

Get the refresh token secret value

pub fn get_expires_at(&self) -> &u64

Get the time at which the token will expire

The time is represented as number of seconds since the Unix Epoch

pub fn save_to_config(&self) -> Result<(), OauthError>

Save the Oauth credentials to the config

pub async fn refresh(self) -> Result<Self, Box<dyn Error>>

Refresh the access token using the refresh token

Trait Implementations

impl<State: Debug> Debug for OauthClient<State>

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

Formats the value using the given formatter.