github_auth

Authenticate with GitHub from the command line. Caches the authentication token so that future interactions just work.

• Documentation
• Crates.io

Usage

```rust,ignore extern crate github_auth;

use github_auth::{Authenticator, Scope};

let auth = Authenticator::builder("github_auth main example".into()) .scope(Scope::PublicRepo) .build();

let token = auth.auth().unwrap(); println!("{:?}", token);

let location = auth.location(); println!("Token stored at: {:?}", location); ```

Example Output

This dialog is only required to generate a valid token. Once a valid token is created, it will no longer be shown. txt GitHub username: my_name GitHub password: GitHub OTP (optional): 5678

Authenticating with the token

Once you've acquired an access token, you can use it to authenticate. Here's how to authenticate with the reqwest crate. ```rust,ignore extern crate github_auth; extern crate reqwest;

use github_auth::Authenticator; use reqwest::{ header::{Authorization, Headers, UserAgent}, Client, };

let auth = Authenticator::new("myexampleapp"); let token = auth.auth().unwrap();

let mut headers = Headers::new(); headers.set(Authorization(format!("token {}", token.asstr())).toowned()); headers.set(UserAgent::new("my_app"));

let url = "https://api.github.com/user"; let mut res = client.get(&url).headers(headers).send()?; println!("{:?}", res.status()); ```

Installation

sh $ cargo add github_auth

License

MIT OR Apache-2.0