lastfm-client 4.0.1

A modern, async Rust library for fetching and analyzing Last.fm user data
Documentation 
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

use std::sync::Arc;

use crate::api::constants::{BASE_URL, METHOD_USER_INFO};
use crate::api::user_params;
use crate::client::HttpClient;
use crate::config::Config;
use crate::error::Result;
use crate::types::{UserInfo, UserInfoResponse};
use crate::url_builder::Url;

/// Builder for `user.getInfo` requests
#[derive(Debug)]
pub struct UserInfoRequestBuilder {
    http: Arc<dyn HttpClient>,
    config: Arc<Config>,
    username: String,
}

impl UserInfoRequestBuilder {
    pub(crate) fn new(http: Arc<dyn HttpClient>, config: Arc<Config>, username: String) -> Self {
        Self {
            http,
            config,
            username,
        }
    }

    /// Fetch the user profile.
    ///
    /// # Errors
    /// Returns an error if the HTTP request fails, the user does not exist, or the
    /// response cannot be parsed.
    pub async fn fetch(self) -> Result<UserInfo> {
        let params = user_params(METHOD_USER_INFO, &self.username, self.config.api_key());
        let url = Url::new(BASE_URL).add_args(params).build();
        let value = self.http.get(&url).await?;
        let response: UserInfoResponse = serde_json::from_value(value)?;

        Ok(UserInfo::from(response))
    }
}