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
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109

// #![feature(non_ascii_idents)]
#![allow(dead_code)]
//! ## Description
//! Rspotify is a lightweight wrapper for the [Spotify Web API](https://developer.spotify.com/web-api/) It includes helper functions for
//! **all Spotify's endpoints**, such as fetching metadata (search and look-up of
//! albums, artists, tracks, playlists, new releases) and user's information (follow
//! users, artists and playlists, and saved tracks management).
//! ## Features
//! *rspotify* supports all of the features of the Spotify Web API including access
//! to all end points, and support for user authorization, notes that before
//! accessing to any end points, you need to be authorized. For details on the
//! capabilities you are encouraged to review the [Spotify Web Endpoint
//! Reference](https://developer.spotify.com/web-api/endpoint-reference/)
//! documentation
//! 
//! ## Getting Started
//! ### Authorization
//! Since all methods require user authorization now, you will need to
//! generate an authorization token that indicates that the user has granted
//! permission for your application to perform the given task.  You will need to
//! register your app to get the credentials necessary to make authorized calls.
//! 
//! Even if your script does not have an accessible URL you need to specify one when
//! registering your application where the spotify authentication API will redirect
//! to after successful login. The URL doesn't need to work or be accessible, you
//! can specify "http://localhost/", after successful login you just need to copy
//! the "http://localhost/?code=..." URL from your browser and paste it to the
//! console where your application is running. 
//! 
//! ## Examples
//! If you have a use case you are intertested in, you could check the
//! [examples](./examples), which has all kinds of detailed examples. For example,
//! If you want to get recently played history, you could check
//! [current_user_recently_played](https://github.com/samrayleung/rspotify/blob/master/examples/current_user_recently_played.rs). This is
//! the example code:
//! ``` rust
//! extern crate rspotify;
//! 
//! use rspotify::spotify::client::Spotify;
//! use rspotify::spotify::util::get_token;
//! use rspotify::spotify::oauth2::{SpotifyClientCredentials, SpotifyOAuth};
//! 
//! fn main() {
    //! // Set client_id and client_secret in .env file or
    //! // export CLIENT_ID="your client_id"
    //! // export CLIENT_SECRET="secret"
    //! // export REDIRECT_URI=your-direct-uri
//! 
    //! // Or set client_id, client_secret,redirect_uri explictly
    //! // let oauth = SpotifyOAuth::default()
    //! //     .client_id("this-is-my-client-id")
    //! //     .client_secret("this-is-my-client-secret")
    //! //     .redirect_uri("http://localhost:8888/callback")
    //! //     .build();
//! 
    //! let mut oauth = SpotifyOAuth::default()
        //! .scope("user-read-recently-played")
        //! .build();
    //! match get_token(&mut oauth) {
        //! Some(token_info) => {
            //! let client_credential = SpotifyClientCredentials::default()
                //! .token_info(token_info)
                //! .build();
            //! // Or set client_id and client_secret explictly
            //! // let client_credential = SpotifyClientCredentials::default()
            //! //     .client_id("this-is-my-client-id")
            //! //     .client_secret("this-is-my-client-secret")
            //! //     .build();
            //! let spotify = Spotify::default()
                //! .client_credentials_manager(client_credential)
                //! .build();
            //! let history = spotify.current_user_recently_played(10);
            //! println!("{:?}", history);
        //! }
        //! None => println!("auth failed"),
    //! };
//! }
//! 
//! ```

#[macro_use]
extern crate log;
extern crate env_logger;
extern crate reqwest;
extern crate serde;
#[macro_use]
extern crate serde_json;
extern crate chrono;
#[macro_use]
extern crate serde_derive;
extern crate webbrowser;
#[macro_use]
extern crate error_chain;
#[macro_use]
extern crate itertools;
#[macro_use]
extern crate lazy_static;
extern crate dotenv;
// use serde_json::Error;
extern crate url;
extern crate percent_encoding;
extern crate rand;
extern crate base64;
extern crate hyper;

/// Spotify API Module 
pub mod spotify;
mod errors;
pub use errors::{Result, Error, ErrorKind};