Struct ScrobbleEdit 

pub struct ScrobbleEdit {
    pub track_name_original: Option<String>,
    pub album_name_original: Option<String>,
    pub artist_name_original: String,
    pub album_artist_name_original: Option<String>,
    pub track_name: Option<String>,
    pub album_name: Option<String>,
    pub artist_name: String,
    pub album_artist_name: Option<String>,
    pub timestamp: Option<u64>,
    pub edit_all: bool,
}

Represents a scrobble edit operation.

This structure contains all the information needed to edit a specific scrobble on Last.fm, including both the original and new metadata values.

Fields

track_name_original: Option<String>

Original track name as it appears in the scrobble (optional - if None, edits all tracks)

album_name_original: Option<String>

Original album name as it appears in the scrobble (optional)

artist_name_original: String

Original artist name as it appears in the scrobble (required)

album_artist_name_original: Option<String>

Original album artist name as it appears in the scrobble (optional)

track_name: Option<String>

New track name to set (optional - if None, keeps original track names)

album_name: Option<String>

New album name to set (optional - if None, keeps original album names)

artist_name: String

New artist name to set

album_artist_name: Option<String>

New album artist name to set (optional - if None, keeps original album artist names)

timestamp: Option<u64>

Unix timestamp of the scrobble to edit (optional)

This identifies the specific scrobble instance to modify. If None, the client will attempt to find a representative timestamp.

edit_all: bool

Whether to edit all instances or just this specific scrobble

When true, Last.fm will update all scrobbles with matching metadata. When false, only this specific scrobble (identified by timestamp) is updated.

Implementations

impl ScrobbleEdit

pub fn new( track_name_original: Option<String>, album_name_original: Option<String>, artist_name_original: String, album_artist_name_original: Option<String>, track_name: Option<String>, album_name: Option<String>, artist_name: String, album_artist_name: Option<String>, timestamp: Option<u64>, edit_all: bool, ) -> Self

Create a new ScrobbleEdit with all required fields.

This is the most general constructor that allows setting all fields. For convenience, consider using from_track_info instead.

Arguments

• track_name_original - The current track name in the scrobble
• album_name_original - The current album name in the scrobble
• artist_name_original - The current artist name in the scrobble
• album_artist_name_original - The current album artist name in the scrobble
• track_name - The new track name to set
• album_name - The new album name to set
• artist_name - The new artist name to set
• album_artist_name - The new album artist name to set
• timestamp - Unix timestamp identifying the scrobble
• edit_all - Whether to edit all matching scrobbles or just this one

pub fn from_track_info( original_track: &str, original_album: &str, original_artist: &str, timestamp: u64, ) -> Self

Create an edit request from track information (convenience constructor).

This constructor creates a ScrobbleEdit with the new values initially set to the same as the original values. Use the builder methods like with_track_name to specify what should be changed.

Arguments

• original_track - The current track name
• original_album - The current album name
• original_artist - The current artist name
• timestamp - Unix timestamp identifying the scrobble

pub fn with_track_name(self, track_name: &str) -> Self

Set the new track name.

pub fn with_album_name(self, album_name: &str) -> Self

Set the new album name.

pub fn with_artist_name(self, artist_name: &str) -> Self

Set the new artist name.

This also sets the album artist name to the same value.

pub fn with_edit_all(self, edit_all: bool) -> Self

Set whether to edit all instances of this track.

When true, Last.fm will update all scrobbles with the same metadata. When false (default), only the specific scrobble is updated.

pub fn with_minimal_info( track_name: &str, artist_name: &str, album_name: &str, timestamp: u64, ) -> Self

Create an edit request with minimal information, letting the client look up missing metadata.

This constructor is useful when you only know some of the original metadata and want the client to automatically fill in missing information by looking up the scrobble.

Arguments

• track_name - The new track name to set
• artist_name - The new artist name to set
• album_name - The new album name to set
• timestamp - Unix timestamp identifying the scrobble

pub fn from_track_and_artist(track_name: &str, artist_name: &str) -> Self

Create an edit request with just track and artist information.

This constructor is useful when you only know the track and artist names. The client will use these as both original and new values, and will attempt to find a representative timestamp and album information.

Arguments

• track_name - The track name (used as both original and new)
• artist_name - The artist name (used as both original and new)

pub fn for_artist(old_artist_name: &str, new_artist_name: &str) -> Self

Create an edit request for all tracks by an artist.

This constructor creates a ScrobbleEdit that will edit all tracks by the specified artist, changing the artist name to the new value.

Arguments

• old_artist_name - The current artist name to change from
• new_artist_name - The new artist name to change to

pub fn for_album( album_name: &str, old_artist_name: &str, new_artist_name: &str, ) -> Self

Create an edit request for all tracks in a specific album.

This constructor creates a ScrobbleEdit that will edit all tracks in the specified album by the specified artist.

Arguments

• album_name - The album name containing tracks to edit
• artist_name - The artist name for the album
• new_artist_name - The new artist name to change to

Trait Implementations

impl Clone for ScrobbleEdit

fn clone(&self) -> ScrobbleEdit

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ScrobbleEdit

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ScrobbleEdit

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ScrobbleEdit

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

Formats the value using the given formatter.

impl Hash for ScrobbleEdit

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ScrobbleEdit

fn eq(&self, other: &ScrobbleEdit) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ScrobbleEdit

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ScrobbleEdit

impl StructuralPartialEq for ScrobbleEdit