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

use async_trait::async_trait;

use crate::{api::{convert_collection, convert_stream_items}, client::SoundCloudClient, http::Query, models::{history::HistoryItem, user::User, StreamItem}, need_authentication, utils::schemas::CollectionParams, ClientResult};

use super::convert_result;

#[async_trait]
pub trait MeApi {

    /// Get current user's profile.
    /// ! Need authentication.
    async fn get_me(&self) -> ClientResult<User>;

    /// Get the user's listening history.
    /// ! Need authentication.
    async fn get_my_history(&self, collection_params: CollectionParams) -> ClientResult<Vec<HistoryItem>>;

    /// Get the user's stream of uploads and reposts.
    /// ! Need authentication.
    async fn get_my_stream(&self, collection_params: CollectionParams) -> ClientResult<Vec<StreamItem>>;

}

#[async_trait]
impl MeApi for SoundCloudClient {

    async fn get_me(&self) -> ClientResult<User> {
        need_authentication!(self);
        let uri = format!("/me");

        let result = self.api_get(&uri, Query::new()).await?;
        convert_result(&result)
    }

    async fn get_my_history(&self, collection_params: CollectionParams) -> ClientResult<Vec<HistoryItem>> {
        need_authentication!(self);
        let uri = format!("/me/play-history/tracks");
        let query_params = collection_params.to_query();

        let result = self.api_get(&uri, query_params).await?;
        convert_collection(&result)
    }

    async fn get_my_stream(&self, collection_params: CollectionParams) -> ClientResult<Vec<StreamItem>> {
        need_authentication!(self);
        let uri = format!("/stream");
        let query_params = collection_params.to_query();

        let result = self.api_get(&uri, query_params).await?;
        convert_stream_items(&result)
    }
    
}