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, 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 = LastFmEditClient::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, AsyncPaginatedIterator, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let http_client = http_client::native::NativeClient::new();
    let mut client = LastFmEditClient::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, ScrobbleEdit, AsyncPaginatedIterator, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let http_client = http_client::native::NativeClient::new();
    let mut client = LastFmEditClient::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, AsyncPaginatedIterator, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let http_client = http_client::native::NativeClient::new();
    let mut client = LastFmEditClient::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(())
}

§License

MIT

Re-exports§

pub use album::Album;
pub use album::AlbumPage;
pub use client::LastFmEditClient;
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 track::Track;
pub use track::TrackPage;

Modules§

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

Structs§

Html
An HTML tree.

Type Aliases§

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