Crate lastfm_edit

Source
Expand description

§lastfm-edit

A Rust crate for programmatic access to Last.fm’s scrobble editing functionality via web scraping.

This crate provides a high-level interface for authenticating with Last.fm, browsing user libraries, and performing bulk edits on scrobbled tracks. It uses web scraping to access functionality not available through Last.fm’s public API.

§Features

  • Authentication: Login to Last.fm with username/password
  • Library browsing: Paginated access to tracks, albums, and recent scrobbles
  • Bulk editing: Edit track names, artist names, and album information
  • Async iterators: Stream large datasets efficiently
  • HTTP client abstraction: Works with any HTTP client implementation

§Quick Start

use lastfm_edit::{LastFmEditClient, LastFmEditClientImpl, AsyncPaginatedIterator, Result};

#[tokio::main]
async fn main() -> Result<()> {
    // Create client with any HTTP implementation
    let http_client = http_client::native::NativeClient::new();
    let mut client = LastFmEditClientImpl::new(Box::new(http_client));

    // Login to Last.fm
    client.login("username", "password").await?;

    // Browse recent tracks
    let mut recent_tracks = client.recent_tracks();
    while let Some(track) = recent_tracks.next().await? {
        println!("{} - {}", track.artist, track.name);
    }

    Ok(())
}

§Core Components

§Installation

Add this to your Cargo.toml:

[dependencies]
lastfm-edit = "0.1.0"
http-client = { version = "6.5", features = ["curl_client"] }
tokio = { version = "1.0", features = ["full"] }

§Usage Patterns

§Basic Library Browsing

use lastfm_edit::{LastFmEditClient, LastFmEditClientImpl, AsyncPaginatedIterator, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let http_client = http_client::native::NativeClient::new();
    let client = LastFmEditClientImpl::new(Box::new(http_client));

    client.login("username", "password").await?;

    // Get all tracks by an artist
    let mut tracks = client.artist_tracks("Radiohead");
    while let Some(track) = tracks.next().await? {
        println!("{} - {}", track.artist, track.name);
    }

    Ok(())
}

§Bulk Track Editing

use lastfm_edit::{LastFmEditClient, LastFmEditClientImpl, ScrobbleEdit, AsyncPaginatedIterator, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let http_client = http_client::native::NativeClient::new();
    let client = LastFmEditClientImpl::new(Box::new(http_client));

    client.login("username", "password").await?;

    // Find and edit tracks
    let tracks = client.artist_tracks("Artist Name").collect_all().await?;
    for track in tracks {
        if track.name.contains("(Remaster)") {
            let new_name = track.name.replace(" (Remaster)", "");

            // Create edit for this track
            let edit = ScrobbleEdit::from_track_info(
                &track.name,
                &track.name, // Use track name as album fallback
                &track.artist,
                0 // No timestamp needed for bulk edit
            )
            .with_track_name(&new_name)
            .with_edit_all(true);

            let response = client.edit_scrobble(&edit).await?;
            if response.success {
                println!("Successfully edited: {} -> {}", track.name, new_name);
            }
        }
    }

    Ok(())
}

§Recent Tracks Monitoring

use lastfm_edit::{LastFmEditClient, LastFmEditClientImpl, AsyncPaginatedIterator, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let http_client = http_client::native::NativeClient::new();
    let client = LastFmEditClientImpl::new(Box::new(http_client));

    client.login("username", "password").await?;

    // Get recent tracks (first 100)
    let recent_tracks = client.recent_tracks().take(100).await?;
    println!("Found {} recent tracks", recent_tracks.len());

    Ok(())
}

§Mocking for Testing

Enable the mock feature to use MockLastFmEditClient for testing:

[dev-dependencies]
lastfm-edit = { version = "1.0.0", features = ["mock"] }
mockall = "0.13"
ⓘ
#[cfg(feature = "mock")]
mod tests {
    use lastfm_edit::{LastFmEditClient, MockLastFmEditClient, Result, EditResponse, ScrobbleEdit};
    use mockall::predicate::*;

    #[tokio::test]
    async fn test_edit_workflow() -> Result<()> {
        let mut mock_client = MockLastFmEditClient::new();

        // Set up expectations
        mock_client
            .expect_login()
            .with(eq("testuser"), eq("testpass"))
            .times(1)
            .returning(|_, _| Ok(()));

        mock_client
            .expect_edit_scrobble()
            .times(1)
            .returning(|_| Ok(EditResponse {
                success: true,
                message: Some("Edit successful".to_string()),
            }));

        // Use as trait object
        let client: &dyn LastFmEditClient = &mock_client;

        client.login("testuser", "testpass").await?;

        let edit = ScrobbleEdit::new(
            Some("Old Track".to_string()),
            Some("Old Album".to_string()),
            Some("Old Artist".to_string()),
            Some("Old Artist".to_string()),
            "New Track".to_string(),
            "New Album".to_string(),
            "New Artist".to_string(),
            "New Artist".to_string(),
            1640995200,
            false,
        );

        let response = client.edit_scrobble(&edit).await?;
        assert!(response.success);

        Ok(())
    }
}

§License

MIT

Re-exports§

pub use album::Album;
pub use album::AlbumPage;
pub use client::LastFmEditClient;
pub use client::LastFmEditClientImpl;
pub use edit::EditResponse;
pub use edit::ScrobbleEdit;
pub use error::LastFmError;
pub use iterator::ArtistAlbumsIterator;
pub use iterator::ArtistTracksIterator;
pub use iterator::AsyncPaginatedIterator;
pub use iterator::RecentTracksIterator;
pub use session::LastFmEditSession;
pub use track::Track;
pub use track::TrackPage;

Modules§

album
client
edit
error
iterator
parsing
HTML parsing utilities for Last.fm pages.
session
track

Structs§

Html
An HTML tree.

Type Aliases§

Result
A convenient type alias for Result with LastFmError as the error type.