qobuz-api 1.0.2

A Rust client library for the Qobuz music streaming 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

//! Query helpers for finding albums, artists, and tracks by search query.

use anyhow::{Error, Result, anyhow};

use qobuz_api::{
    api::service::QobuzApiService,
    models::{album::Album, artist::Artist},
};

/// Finds a track ID by query string.
///
/// # Arguments
///
/// * `service` - The Qobuz API service
/// * `query` - Search query string
///
/// # Returns
///
/// The track ID if found.
pub fn find_track_id(service: &QobuzApiService, query: &str) -> Result<i32> {
    let search = service.search_tracks(query, Some(1), None)?;
    let items = search
        .items
        .ok_or_else(|| anyhow!("search_tracks returned no items for '{query}'"))?;

    let first = items
        .first()
        .ok_or_else(|| anyhow!("empty track results for '{query}'"))?;

    first.id.ok_or_else(|| anyhow!("track missing ID"))
}

/// Finds an album ID by query string.
///
/// # Arguments
///
/// * `service` - The Qobuz API service
/// * `query` - Search query string
///
/// # Returns
///
/// The album ID if found.
pub fn find_album_id(service: &QobuzApiService, query: &str) -> Result<String> {
    let search = service.search_albums(query, Some(1), None)?;
    let items = search
        .items
        .ok_or_else(|| anyhow!("search_albums returned no items for '{query}'"))?;

    let first = items
        .first()
        .ok_or_else(|| anyhow!("empty album results for '{query}'"))?;

    first
        .id
        .as_ref()
        .ok_or_else(|| anyhow!("album missing ID"))
        .map(String::from)
}

/// Finds an artist ID by query string.
///
/// # Arguments
///
/// * `service` - The Qobuz API service
/// * `query` - Search query string
///
/// # Returns
///
/// The artist ID if found.
pub fn find_artist_id(service: &QobuzApiService, query: &str) -> Result<i32> {
    let search = service.search_artists(query, Some(1), None)?;
    let items = search
        .items
        .ok_or_else(|| anyhow!("search_artists returned no items for '{query}'"))?;

    let first = items
        .first()
        .ok_or_else(|| anyhow!("empty artist results for '{query}'"))?;

    first.id.ok_or_else(|| anyhow!("artist missing ID"))
}

/// Gets an album by query string.
///
/// # Arguments
///
/// * `service` - The Qobuz API service
/// * `query` - Search query string
/// * `extra` - Optional extra fields to include
///
/// # Returns
///
/// The album if found.
pub fn get_album_by_query(
    service: &QobuzApiService,
    query: &str,
    extra: Option<&str>,
) -> Result<Album> {
    let album_id = find_album_id(service, query)?;
    service.get_album(&album_id, extra).map_err(Error::from)
}

/// Gets an artist by query string.
///
/// # Arguments
///
/// * `service` - The Qobuz API service
/// * `query` - Search query string
/// * `extra` - Optional extra fields to include
///
/// # Returns
///
/// The artist if found.
pub fn get_artist_by_query(
    service: &QobuzApiService,
    query: &str,
    extra: Option<&str>,
) -> Result<Artist> {
    let artist_id = find_artist_id(service, query)?;
    service.get_artist(artist_id, extra).map_err(Error::from)
}