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;