opensubsonic 0.3.0

Complete async Rust client for the OpenSubsonic/Subsonic REST 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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

//! Types for the Browsing API section.

use serde::{Deserialize, Serialize};

use super::common::{Artist, Child};

/// A directory in the music library (folder-based browsing).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Directory {
    /// Directory ID.
    pub id: String,
    /// Parent directory ID.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub parent: Option<String>,
    /// Directory name.
    pub name: String,
    /// Date starred (ISO 8601).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub starred: Option<String>,
    /// User rating (1–5).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub user_rating: Option<i32>,
    /// Average rating (1.0–5.0).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub average_rating: Option<f64>,
    /// Play count.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
    /// Child entries in this directory.
    #[serde(default)]
    pub child: Vec<Child>,
}

/// An index entry grouping artists by first letter (folder-based).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Index {
    /// Index name (e.g. "A", "B", "#").
    pub name: String,
    /// Artists in this index.
    #[serde(default)]
    pub artist: Vec<Artist>,
}

/// The full indexes response (folder-based artist listing).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Indexes {
    /// Ignored articles (space-separated).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub ignored_articles: Option<String>,
    /// Last modified timestamp (millis since epoch).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub last_modified: Option<i64>,
    /// Shortcut artists.
    #[serde(default)]
    pub shortcut: Vec<Artist>,
    /// Child entries.
    #[serde(default)]
    pub child: Vec<Child>,
    /// Index list.
    #[serde(default)]
    pub index: Vec<Index>,
}

/// Album info (external metadata).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct AlbumInfo {
    /// Album notes/biography.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub notes: Option<String>,
    /// MusicBrainz ID.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub music_brainz_id: Option<String>,
    /// Last.fm URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub last_fm_url: Option<String>,
    /// Small image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub small_image_url: Option<String>,
    /// Medium image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub medium_image_url: Option<String>,
    /// Large image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub large_image_url: Option<String>,
}

/// Artist info with similar artists (folder-based).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ArtistInfo {
    /// Artist biography.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub biography: Option<String>,
    /// MusicBrainz ID.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub music_brainz_id: Option<String>,
    /// Last.fm URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub last_fm_url: Option<String>,
    /// Small image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub small_image_url: Option<String>,
    /// Medium image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub medium_image_url: Option<String>,
    /// Large image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub large_image_url: Option<String>,
    /// Similar artists.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub similar_artist: Vec<Artist>,
}

/// Artist info with similar artists (ID3-based).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ArtistInfo2 {
    /// Artist biography.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub biography: Option<String>,
    /// MusicBrainz ID.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub music_brainz_id: Option<String>,
    /// Last.fm URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub last_fm_url: Option<String>,
    /// Small image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub small_image_url: Option<String>,
    /// Medium image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub medium_image_url: Option<String>,
    /// Large image URL.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub large_image_url: Option<String>,
    /// Similar artists (ID3).
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub similar_artist: Vec<super::common::ArtistId3>,
}