Enum LastFmError 

#[non_exhaustive]
pub enum LastFmError {
    Api {
        method: String,
        message: String,
        error_code: u32,
        retryable: bool,
    },
    RateLimited {
        retry_after: Option<Duration>,
    },
    Network(Error),
    Parse(Error),
    Io(Error),
    Csv(Error),
    MissingEnvVar(String),
    Config(String),
    Http {
        status: u16,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Url {
        source: ParseError,
    },
}

Errors that can occur when interacting with the Last.fm API

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Api

Represents a Last.fm API error with code and message Access details via the struct fields: method, message, error_code, retryable

Fields

method: String

API method that caused the error

message: String

Human-readable error message

error_code: u32

Numeric Last.fm error code

retryable: bool

Whether this error is retryable

RateLimited

Represents rate limiting error Access retry_after via the struct field

Fields

retry_after: Option<Duration>

Suggested delay before retrying

Network(Error)

Represents HTTP/network errors Access source error via Error::source()

Parse(Error)

Represents JSON parsing errors Access source error via Error::source()

Io(Error)

Represents file I/O errors Access source error via Error::source()

Csv(Error)

Represents CSV errors Access source error via Error::source()

MissingEnvVar(String)

Represents missing environment variable errors

Config(String)

Represents configuration errors

Http

Represents HTTP response errors (non-success status codes)

Fields

status: u16

HTTP status code

source: Option<Box<dyn Error + Send + Sync>>

Underlying error source

Url

Represents URL parsing errors

Fields

source: ParseError

URL parse error

Implementations

impl LastFmError

pub const fn is_retryable(&self) -> bool

Check if this error is retryable

pub const fn retry_after(&self) -> Option<Duration>

Get the retry delay if specified

pub fn api_method(&self) -> Option<&str>

Get the API method name if this is an API error

pub const fn api_error_code(&self) -> Option<u32>

Get the API error code if this is an API error

pub fn api_message(&self) -> Option<&str>

Get the API error message if this is an API error

pub fn env_var_name(&self) -> Option<&str>

Get the environment variable name if this is a missing env var error

pub const fn http_status(&self) -> Option<u16>

Get the HTTP status code if this is an HTTP error

Trait Implementations

impl Debug for LastFmError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for LastFmError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for LastFmError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for LastFmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LastFmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LastFmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LastFmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for LastFmError

fn from(err: ParseError) -> Self

Converts to this type from the input type.