am-api 1.1.0

A library for interfacing with the Apple Music 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

use am_api::error::Error;
use am_api::resource::catalog::album::{
    Album, AlbumAttributesExtension, AlbumRelationshipType, AlbumViewType,
};
use futures::StreamExt;

mod common;

#[tokio::test]
async fn fetch_album() -> Result<(), Error> {
    let client = common::create_client();

    let album = Album::get()
        .one(&client, "1676791755")
        .await?
        .expect("album fetch returned none");

    let attributes = album
        .attributes
        .expect("album fetch returned an album without attributes");

    assert_eq!(attributes.name, "Unrequited Love - EP");

    Ok(())
}

#[tokio::test]
async fn fetch_album_extended() -> Result<(), Error> {
    let client = common::create_client();

    let album = Album::get()
        .extend(AlbumAttributesExtension::ArtistUrl)
        .one(&client, "1676791755")
        .await?
        .expect("album fetch returned none");

    let attributes = album
        .attributes
        .expect("album fetch returned an album without attributes");

    assert_eq!(attributes.name, "Unrequited Love - EP");
    assert_eq!(
        attributes.artist_url,
        Some(String::from(
            "https://music.apple.com/us/artist/hkmori/1672126480"
        ))
    );

    Ok(())
}

#[tokio::test]
async fn fetch_album_relationship() -> Result<(), Error> {
    let client = common::create_client();

    let album = Album::get()
        .extend(AlbumAttributesExtension::ArtistUrl)
        .include(AlbumRelationshipType::Tracks)
        .one(&client, "1676791755")
        .await?
        .expect("album fetch returned none");

    let attributes = album
        .attributes
        .expect("album fetch returned an album without attributes");

    assert_eq!(attributes.name, "Unrequited Love - EP");
    assert_eq!(
        attributes.artist_url,
        Some(String::from(
            "https://music.apple.com/us/artist/hkmori/1672126480"
        ))
    );

    let tracks_relationships = album
        .relationships
        .tracks
        .iter(&client)
        .collect::<Vec<_>>()
        .await;

    assert_eq!(tracks_relationships.len(), 6);

    Ok(())
}

#[tokio::test]
async fn fetch_album_view() -> Result<(), Error> {
    let client = common::create_client();

    let album = Album::get()
        .extend(AlbumAttributesExtension::ArtistUrl)
        .view(AlbumViewType::AppearsOn)
        .one(&client, "1651577210")
        .await?
        .expect("album fetch returned none");

    let attributes = album
        .attributes
        .expect("album fetch returned an album without attributes");

    assert_eq!(attributes.name, "Remember That You Will Die");
    assert_eq!(
        attributes.artist_url,
        Some(String::from(
            "https://music.apple.com/us/artist/polyphia/640294344"
        ))
    );

    let appears_on = album.views.appears_on;
    assert!(appears_on.is_some());

    Ok(())
}