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 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
// #![feature(non_ascii_idents)] #![allow(clippy::needless_doctest_main)] #![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::client::Spotify; //! use rspotify::util::get_token; //! use rspotify::oauth2::{SpotifyClientCredentials, SpotifyOAuth}; //! //! #[tokio::main] //! async 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).await { //! 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).await; //! println!("{:?}", history); //! } //! None => println!("auth failed"), //! }; //! } //! //! ``` #[macro_use] extern crate log; extern crate env_logger; #[cfg(any(feature = "default-tls", feature = "blocking"))] extern crate reqwest_default_tls as reqwest; #[cfg(any(feature = "native-tls-crate", feature = "native-tls-crate-blocking"))] extern crate reqwest_native_tls as reqwest; #[cfg(any( feature = "native-tls-vendored", feature = "native-tls-vendored-blocking" ))] extern crate reqwest_native_tls_vendored as reqwest; #[cfg(any(feature = "rustls-tls", feature = "rustls-tls-blocking"))] extern crate reqwest_rustls_tls as 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 base64; extern crate percent_encoding; extern crate rand; extern crate url; #[cfg(feature = "blocking")] pub mod blocking; pub mod client; pub mod model; pub mod oauth2; pub mod senum; pub mod util;