Struct Scrobble 

pub struct Scrobble { /* private fields */ }

Repesents a single music track played at a point in time. In the Last.fm universe, this is known as a “scrobble”.

Takes an artist, track and album name. Can hold a timestamp indicating when the track was listened to. Scrobble objects are submitted via Scrobbler::now_playing, Scrobbler::scrobble and batches of Scrobbles are sent via Scrobbler::scrobble_batch.

Implementations

impl Scrobble

pub fn new(artist: &str, track: &str, album: &str) -> Self

Constructs a new Scrobble instance, representing a single playthrough of a music track. Scrobbles are submitted to Last.fm via an instance of Scrobbler. A new Scrobble requires an artist name, song/track name, and an album name.

Example

let scrobble = Scrobble::new("Example Artist", "Example Track", "Example Album")

pub fn with_timestamp(&mut self, timestamp: u64) -> &mut Self

Sets the timestamp (date/time of play) of a Scrobble. Used in a builder-style pattern, typically after Scrobble::new.

Example

let mut scrobble = Scrobble::new(...).with_timestamp(12345);

Note on Timestamps

Scrobbles without timestamps are automatically assigned a timestamp of the current time when submitted via Scrobbler::scrobble or Scrobbler::scrobble_batch. Timestamps only need to be explicitly set when you are submitting a Scrobble at a point in the past, or in the future.

pub fn as_map(&self) -> HashMap<String, String>

Converts the Scrobble metadata (track name, artist & album name) into a HashMap. Map keys are "track", "artist" and "album". If a timestamp is set, it will be present in the map under key "timestamp".

Example

let scrobble = Scrobble::new("Example Artist", ...);
let scrobble_map = scrobble.as_map();
assert_eq!(scrobble_map.get("artist"), "Example Artist");

pub fn artist(&self) -> &str

Returns the Scrobble’s artist name

pub fn track(&self) -> &str

Returns the Scrobble’s track name

pub fn album(&self) -> &str

Returns the Scrobble’s album name

Trait Implementations

impl Clone for Scrobble

fn clone(&self) -> Scrobble

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scrobble

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

Formats the value using the given formatter.

impl Extend<Scrobble> for ScrobbleBatch

fn extend<T: IntoIterator<Item = Scrobble>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl From<&(&str, &str, &str)> for Scrobble

Converts from tuple of &strs in the form (artist, track, album)

Designed to make it easier to cooperate with other track info types.

fn from((artist, track, album): &(&str, &str, &str)) -> Self

Converts to this type from the input type.

impl From<&(String, String, String)> for Scrobble

Converts from tuple of Strings in the form (artist, track, album)

Designed to make it easier to cooperate with other track info types.

fn from((artist, track, album): &(String, String, String)) -> Self

Converts to this type from the input type.

impl FromIterator<Scrobble> for ScrobbleBatch

fn from_iter<I: IntoIterator<Item = Scrobble>>(iter: I) -> Self

Creates a value from an iterator.

impl Hash for Scrobble

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 Ord for Scrobble

fn cmp(&self, other: &Scrobble) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Scrobble

fn eq(&self, other: &Scrobble) -> 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 PartialOrd for Scrobble

fn partial_cmp(&self, other: &Scrobble) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Scrobble

impl StructuralPartialEq for Scrobble