1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! Tokens.
//!
//! Access token types are abstracted through the `Token` trait. See
//! [RFC 6749, section 7.1](http://tools.ietf.org/html/rfc6749#section-7.1).
//!
//! Expiring and non-expiring tokens are abstracted through the `Lifetime` trait.

mod bearer;
mod expiring;
mod refresh;
mod statik;

pub use self::bearer::Bearer;
pub use self::expiring::Expiring;
pub use self::refresh::Refresh;
pub use self::statik::Static;

use client::response::FromResponse;

/// OAuth 2.0 tokens.
///
/// See [RFC 6749, section 5](http://tools.ietf.org/html/rfc6749#section-5).
pub trait Token<L: Lifetime>: FromResponse {
    /// Returns the access token.
    ///
    /// See [RF C6749, section 1.4](http://tools.ietf.org/html/rfc6749#section-1.4).
    fn access_token(&self) -> &str;

    /// Returns the scope, if available.
    fn scope(&self) -> Option<&str>;

    /// Returns the token lifetime.
    fn lifetime(&self) -> &L;
}

/// OAuth 2.0 token lifetimes.
pub trait Lifetime: FromResponse {
    /// Returns true if the access token is no longer valid.
    fn expired(&self) -> bool;
}