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
// #![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 failure;
#[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;
/// Spotify API Module
pub mod spotify;