#spotify #oauth #api #async #web-api #async-std

spotify-oauth

An implementation of the Spotify Authorization Code Flow in Rust

3 releases (breaking)

0.3.0 Dec 28, 2019
0.2.0 Jul 27, 2019
0.1.0 Mar 15, 2019

#61 in #spotify

24 downloads per month

MIT license

29KB
350 lines

spotify-oauth

Docs

Description

spotify-oauth is a library for Spotify Authorization. It features a full implementation of the Authorization Code Flow that Spotify requires a user to undergo before using the web API.

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.

use std::{io::stdin, str::FromStr, error::Error};
use spotify_oauth::{SpotifyAuth, SpotifyCallback, SpotifyScope};

#[async_std::main]
async fn main() -> Result<(), Box<dyn Error + Send + Sync + 'static>> {

    // Setup Spotify Auth URL
    let auth = SpotifyAuth::new_from_env("code".into(), vec![SpotifyScope::Streaming], false);
    let auth_url = auth.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)?;

    // Convert the given callback URL into a token.
    let token = SpotifyCallback::from_str(buffer.trim())?
        .convert_into_token(auth.client_id, auth.client_secret, auth.redirect_uri).await?;

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

    Ok(())
}

API Documentation

More API information can be located here.

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

Dependencies

~9MB
~183K SLoC