spotify-oauth 0.1.0

An implementation of the Spotify Authorization Code Flow in Rust
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

# spotify-oauth
[![Docs](https://docs.rs/spotify-oauth/badge.svg)](https://docs.rs/spotify-oauth/)

## Description
spotify-oauth is a library for [Spotify Authorization](https://developer.spotify.com/documentation/general/guides/authorization-guide/).
It features a full implementation of the Authorization Code Flow that Spotify requires a user to undergo before using the web API.

## Installation

```shell
cargo install spotify-oauth
```

## Basic Example
This example shows how the library can be used to create a full authorization flow for retrieving the token required to use the web API.
```rust
use std::io::stdin;
use std::str::FromStr;
use spotify_oauth::{SpotifyAuth, SpotifyCallback};

fn main() -> Result<(), Box<std::error::Error>> {

    // Setup Spotify Auth URL
    let auth_url = SpotifyAuth::default().authorize_url()?;

    // Open the auth URL in the default browser of the user.
    open::that(auth_url)?;

    println!("Input callback URL:");
    let mut buffer = String::new();
    stdin().read_line(&mut buffer)?;

    let token = SpotifyCallback::from_str(buffer.trim())?.convert_into_token()?;

    println!("Token: {:#?}", token);

    Ok(())
}
```

### API Documentation
More API information can be located [here](https://docs.rs/spotify-oauth/).

### Contribution
If you have any suggestions or issues towards this library, please submit an
issue. Pull requests, code reviewing and feedback are welcome.

### License
[MIT](LICENSE)