Enum LastFmError

pub enum LastFmError {
    Http(String),
    Auth(String),
    CsrfNotFound,
    Parse(String),
    RateLimit {
        retry_after: u64,
    },
    EditFailed(String),
    Io(Error),
}

Error types for Last.fm operations.

This enum covers all possible errors that can occur when interacting with Last.fm, including network issues, authentication failures, parsing errors, and rate limiting.

Error Handling Examples

use lastfm_edit::{LastFmClient, LastFmError};

#[tokio::main]
async fn main() {
    let mut client = LastFmClient::new(Box::new(http_client::native::NativeClient::new()));

    match client.login("username", "password").await {
        Ok(()) => println!("Login successful"),
        Err(LastFmError::Auth(msg)) => eprintln!("Authentication failed: {}", msg),
        Err(LastFmError::RateLimit { retry_after }) => {
            eprintln!("Rate limited, retry in {} seconds", retry_after);
        }
        Err(LastFmError::Http(msg)) => eprintln!("Network error: {}", msg),
        Err(e) => eprintln!("Other error: {}", e),
    }
}

Automatic Retry

Some operations like LastFmClient::edit_scrobble_with_retry automatically handle rate limiting errors by waiting and retrying:

let mut client = LastFmClient::new(Box::new(http_client::native::NativeClient::new()));
// client.login(...).await?;

let edit = ScrobbleEdit::from_track_info("Track", "Album", "Artist", 1640995200);

// This will automatically retry on rate limits up to 3 times
match client.edit_scrobble_with_retry(&edit, 3).await {
    Ok(response) => println!("Edit completed: {:?}", response),
    Err(e) => eprintln!("Edit failed after retries: {}", e),
}

Variants

Http(String)

HTTP/network related errors.

This includes connection failures, timeouts, DNS errors, and other low-level networking issues.

Auth(String)

Authentication failures.

This occurs when login credentials are invalid, sessions expire, or authentication is required but not provided.

Common Causes

• Invalid username/password
• Expired session cookies
• Account locked or suspended
• Two-factor authentication required

CsrfNotFound

CSRF token not found in response.

This typically indicates that Last.fm’s page structure has changed or that the request was blocked.

Parse(String)

Failed to parse Last.fm’s response.

This can happen when Last.fm changes their HTML structure or returns unexpected data formats.

RateLimit

Rate limiting from Last.fm.

Last.fm has rate limits to prevent abuse. When hit, the client should wait before making more requests.

The retry_after field indicates how many seconds to wait before the next request attempt.

Fields

retry_after: u64

Number of seconds to wait before retrying

EditFailed(String)

Scrobble edit operation failed.

This is returned when an edit request is properly formatted and sent, but Last.fm rejects it for business logic reasons.

Io(Error)

File system I/O errors.

This can occur when saving debug responses or other file operations.

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.