gauth 0.3.1

HTTP Client for Google OAuth2
Documentation 
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

rust_google_oauth2
================

The library currently supports **Google OAuth2** flow for [installed](https://developers.google.com/identity/protocols/OAuth2?hl=en_US#installed) desktop applications and has been initally tested with [manual copy/paste](https://developers.google.com/identity/protocols/OAuth2InstalledApp#redirect-uri_oob-manual) (_of authorization code_) redirect method.

Going forward support for [Loopback IP redirect](https://developers.google.com/identity/protocols/OAuth2InstalledApp#redirect-uri_loopback) is planned to be added.

### Prerequisites

1. Create your application in [Google API Console](https://console.developers.google.com/apis/credentials)  
   a. `Credentials` > `Create credentials` > `OAuth client ID`  
   b. Set application type to `Other`  
   c. Enter your application name  
   d. `Download JSON` configuration of newly created application  

## Example
```toml
[dependencies]
gauth = "0.3.1"
```
Sample client implementation

```rust,no_run
fn main() {
    // define consent URL handler
    // returns an auth. code which is then exchanged against access token
    let handle_auth = |consent_url: String| -> Result<String, <Box std:error:Error>> {
        println!("> open the link in browser\n\n{}\n", consent_url);
        println!("> enter the auth. code\n");

        let mut auth_code = String::new();
        io::stdin().read_line(&mut auth_code)?;

        Ok(auth_code)
    }

    let auth_client = gauth::Auth::new(
        "my-new-application",
        &[
            "https://www.googleapis.com/auth/drive.readonly",
        ],
        PathBuf::from("/my-google-credentials/oauth-credentials.json"),
    );

    let token = auth_client
        .access_token(handle_auth)
        .expect("failed to retrieve access token");

    println!("obtained token: {:?}", token);
}
```

## License

License under either or:

* [MIT](LICENSE-MIT)
* [Apache License, Version 2.0](LICENSE-APACHE)