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
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

//! Models for user-related Last.fm API responses.

use serde::Deserialize;

use crate::models::common::Image;
use crate::utils::{from_str, from_str_opt};

/// Response wrapper from the API: `{ "user": { ... } }`
#[derive(Debug, Deserialize)]
pub struct UserGetInfoResponse {
    pub user: UserInfo,
}

/// Main user info object returned by `user.getInfo`
#[derive(Debug, Deserialize)]
pub struct UserInfo {
    pub name: String,
    pub realname: Option<String>,
    pub url: String,
    pub country: Option<String>,

    #[serde(deserialize_with = "from_str_opt")]
    pub age: Option<u32>,

    pub gender: Option<String>,

    #[serde(deserialize_with = "from_str")]
    pub playcount: u64,

    #[serde(deserialize_with = "from_str_opt")]
    pub playlists: Option<u32>,

    pub registered: Registered,
    pub image: Vec<Image>,

    #[serde(rename = "type")]
    pub user_type: Option<String>,

    #[serde(deserialize_with = "from_str_opt")]
    pub subscriber: Option<u8>,
}

/// Info about when the user registered their account.
#[derive(Debug, Deserialize)]
pub struct Registered {
    #[serde(rename = "#text")]
    pub timestamp: i64,

    #[serde(deserialize_with = "from_str")]
    pub unixtime: i64,
}

/// Response wrapper from the API: `{ "friends": { ... } }`
#[derive(Debug, Deserialize)]
pub struct UserGetFriendsResponse {
    pub friends: UserFriends,
}

/// A list of friends and pagination info.
#[derive(Debug, Deserialize)]
pub struct UserFriends {
    #[serde(rename = "@attr")]
    pub attr: UserFriendsAttributes,
    pub user: Vec<Friend>,
}

/// Pagination attributes for the friends list.
#[derive(Debug, Deserialize)]
pub struct UserFriendsAttributes {
    pub user: String,

    #[serde(rename = "totalPages", deserialize_with = "from_str")]
    pub total_pages: u32,

    #[serde(deserialize_with = "from_str")]
    pub page: u32,

    #[serde(rename = "perPage", deserialize_with = "from_str")]
    pub per_page: u32,

    #[serde(deserialize_with = "from_str")]
    pub total: u32,
}

/// A single friend object.
#[derive(Debug, Deserialize)]
pub struct Friend {
    pub name: String,
    pub url: String,
    pub country: Option<String>,
    pub realname: Option<String>,

    #[serde(deserialize_with = "from_str")]
    pub playlists: u32,

    #[serde(deserialize_with = "from_str")]
    pub playcount: u64,

    pub image: Vec<Image>,
    pub registered: FriendRegistered,

    #[serde(deserialize_with = "from_str")]
    pub subscriber: u8,

    #[serde(rename = "type")]
    pub user_type: String,

    #[serde(deserialize_with = "from_str")]
    pub bootstrap: u8,
}

/// Info about when a friend registered their account.
///
/// This is different from the [`Registered`] struct used in [`UserInfo`]
/// for some reason.
#[derive(Debug, Deserialize)]
pub struct FriendRegistered {
    #[serde(rename = "#text")]
    pub date: String,

    #[serde(deserialize_with = "from_str")]
    pub unixtime: i64,
}