rsoundcloud 0.2.6

A SoundCloud API client
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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

use serde::{Serialize, Deserialize};
use chrono::{DateTime, Utc};

use super::{user::{BasicUser, UltraBasicUser}, visual::Visuals};

// ==================================================
// Track
// ==================================================

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BaseTrack {
    // Base item fields
    pub artwork_url: Option<String>,
    pub created_at: DateTime<Utc>,
    pub description: Option<String>,
    pub duration: i32,
    pub embeddable_by: String,
    pub genre: Option<String>,
    pub id: u64,
    pub kind: String,
    pub label_name: Option<String>,
    pub last_modified: DateTime<Utc>,
    pub license: Option<String>,
    pub likes_count: Option<i32>,
    pub permalink: String,
    pub permalink_url: String,
    pub public: bool,
    pub purchase_title: Option<String>,
    pub purchase_url: Option<String>,
    pub release_date: Option<String>,
    pub reposts_count: Option<i32>,
    pub secret_token: Option<String>,
    pub sharing: String,
    pub tag_list: String,
    pub title: String,
    pub uri: String,
    pub user_id: u64,
    pub display_date: String,

    // Track specific fields
    pub caption: Option<String>,
    pub commentable: bool,
    pub comment_count: Option<i32>,
    pub downloadable: bool,
    pub download_count: Option<i32>,
    pub full_duration: i32,
    pub has_downloads_left: bool,
    pub playback_count: Option<i32>,
    pub state: String,
    pub streamable: bool,
    pub urn: String,
    pub visuals: Option<Visuals>,
    pub waveform_url: String,
    pub media: Media,
    pub station_urn: Option<String>,
    pub station_permalink: Option<String>,
    pub track_authorization: String,
    pub monetization_model: String,
    pub policy: String,
    pub publisher_metadata: Option<PublisherMetadata>,
}

impl BaseTrack {
    pub fn get_all_tags(&self) -> Vec<String> {
        self.genre.iter().cloned()
            .chain(self.tag_list.split('"')
                .map(str::trim)
                .filter(|tag| !tag.is_empty())
                .map(String::from))
            .collect()
    }
    
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Track {
    pub user: BasicUser,
    #[serde(flatten)]
    pub track: BaseTrack,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BasicTrack {
    pub user: UltraBasicUser,
    #[serde(flatten)]
    pub track: BaseTrack,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MiniTrack {
    pub id: u64,
    pub kind: String,
    pub monetization_model: String,
    pub policy: String,
}

// ==================================================
// Comment track
// ==================================================

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CommentTrack {
    pub artwork_url: Option<String>,
    pub caption: Option<String>,
    pub id: u64,
    pub kind: String,
    pub last_modified: DateTime<Utc>,
    pub permalink: String,
    pub permalink_url: String,
    pub public: bool,
    pub secret_token: Option<String>,
    pub sharing: String,
    pub title: String,
    pub uri: String,
    pub urn: String,
    pub user_id: u64,
    pub full_duration: i32,
    pub duration: i32,
    pub display_date: DateTime<Utc>,
    pub media: Media,
    pub station_urn: Option<String>,
    pub station_permalink: Option<String>,
    pub track_authorization: String,
    pub monetization_model: String,
    pub policy: String,
    pub user: UltraBasicUser,
}

// ==================================================
// Nested
// ==================================================

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TranscodingFormat {
    pub protocol: String,
    pub mime_type: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Transcoding {
    pub url: String,
    pub preset: String,
    pub duration: i32,
    pub snipped: bool,
    pub format: TranscodingFormat,
    pub quality: String,
    pub is_legacy_transcoding: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Media {
    pub transcodings: Vec<Transcoding>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PublisherMetadata {
    pub id: u64,
    pub urn: String,
    pub artist: Option<String>,
    pub contains_music: Option<bool>,
    pub isrc: Option<String>,
}