ytmusicapi 0.4.2

Rust client for YouTube 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

//! Error types for the YouTube Music API client.

/// The error type for YouTube Music API operations.
///
/// Methods in this crate return `Result<T, Error>`. No automatic retries are
/// performed; network, server, and parse failures are surfaced as returned.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// HTTP request failed (network error or request failure).
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    /// JSON parsing failed.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    /// Authentication is required for this operation.
    #[error("Authentication required for this operation")]
    AuthRequired,

    /// Server returned an error (non-2xx response or an error payload).
    #[error("Server error {status}: {message}")]
    Server {
        /// HTTP status code
        status: u16,
        /// Error message from server
        message: String,
    },

    /// Failed to navigate JSON response.
    #[error("Navigation error: could not find path '{path}'")]
    Navigation {
        /// The path that could not be found
        path: String,
    },

    /// Invalid authentication data.
    #[error("Invalid auth: {0}")]
    InvalidAuth(String),

    /// Invalid input provided by caller.
    #[error("Invalid input: {0}")]
    InvalidInput(String),

    /// I/O error.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
}

/// A specialized Result type for YouTube Music API operations.
pub type Result<T> = std::result::Result<T, Error>;