gauth 0.5.3

HTTP Client for Google OAuth2
Documentation

gauth

The library supports the following Google Auth flows:

[dependencies]
gauth = "0.5.0"

OAuth2

  1. Create your application in Google API Console
    a. Credentials > Create credentials > OAuth client ID
    b. Set application type to Other
    c. Enter your application name
    d. Download JSON configuration of the newly created application

Client implementation with defaults

use gauth::app::Auth;

fn main() {
    let auth_client = Auth::from_file(
        "my_credentials.json",
        vec!["https://www.googleapis.com/auth/drive"]
    ).unwrap();

    let token = auth_client.access_token().unwrap();
    println!("access token: {}", token);
}

Custom app name and handler: access token will be stored in $HOME/.{app_name}/access_token.json

To assign a custom directory as access token caching, set env var value: GAUTH_TOKEN_DIR

use gauth::app::Auth;

fn main() {
    let auth_handler = |consent_uri: String| -> Result<String, Box<dyn std::error::Error>> {
        // business logic
        Ok("auth_code".to_owned())
    }

    let mut auth_client = Auth::from_file(
        "my_credentials.json",
        vec!["https://www.googleapis.com/auth/drive"]
    ).unwrap();

    let auth_client = auth_client.app_name("new_name").handler(auth_handler);
    let token = auth_client.access_token().unwrap();
    println!("access token: {}", token);
}

Service Account

Follow instructions for creating a service account. After a service account key has been created, it can be used to obtain an access token.

use gauth::serv_account::ServiceAccount;

fn access_token() {
    let scopes = vec!["https://www.googleapis.com/auth/drive"];
    let key_path = "test_fixtures/service-account-key.json";

    let mut service_account = ServiceAccount::from_file(key_path, scopes);
    let access_token = service_account.access_token().unwrap();

    println!("access token {}:", access_token);
}

License

License under either or: