soniq 0.0.2

A Rust library to interact with the Last.fm API.
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! Authentication-related functionality for Last.fm API.

use std::collections::BTreeMap;

use serde::Deserialize;
use tracing::instrument;

use crate::client::Client;
use crate::error::Error;

/// Response from `auth.getToken`
#[derive(Debug, Deserialize)]
pub struct TokenResponse {
    pub token: String,
}

/// Response from `auth.getSession`
#[derive(Debug, Deserialize)]
pub struct SessionResponse {
    pub session: Session,
}

/// A Last.fm session returned after authentication.
#[derive(Debug, Deserialize)]
pub struct Session {
    pub name: String,
    pub key: String,
    pub subscriber: u32,
}

impl Client {
    /// Get an authentication token.
    ///
    /// This token must be approved by the user before exchanging it for a session.
    ///
    /// [Last.fm docs](https://www.last.fm/api/show/auth.getToken)
    #[instrument(skip(self))]
    pub async fn get_token(&self) -> Result<String, Error> {
        let params = BTreeMap::new();
        let response: TokenResponse = self.signed_post("auth.getToken", params).await?;
        Ok(response.token)
    }

    /// Get a session key after the user has approved the token.
    ///
    /// This is used to perform authenticated requests on behalf of a user.
    ///
    /// [Last.fm docs](https://www.last.fm/api/show/auth.getSession)
    #[instrument(skip(self))]
    pub async fn get_session(&self, token: &str) -> Result<Session, Error> {
        let mut params = BTreeMap::new();
        params.insert("token".into(), token.into());

        let response: SessionResponse = self.signed_post("auth.getSession", params).await?;
        Ok(response.session)
    }
}