Struct TopTracksRequestBuilder 

pub struct TopTracksRequestBuilder { /* private fields */ }

Builder for top tracks requests

Implementations

impl TopTracksRequestBuilder

pub fn on_progress( self, callback: impl Fn(u32, u32) + Send + Sync + 'static, ) -> Self

Register a progress callback invoked with (fetched, total) after each batch.

pub const fn period(self, period: Period) -> Self

Set the time period for top tracks

Arguments

• period - The time range to calculate top tracks over. Use Period::Overall for all-time, Period::Week for last 7 days, Period::Month for last 30 days, etc. If not set, defaults to the Last.fm API’s default behavior (typically overall).

Example

use lastfm_client::api::Period;

let tracks = client.top_tracks("username")
    .period(Period::Month)
    .limit(50)
    .fetch()
    .await?;

pub async fn fetch(self) -> Result<TrackList<TopTrack>>

Fetch the tracks

Errors

Returns an error if the HTTP request fails or the response cannot be parsed.

Trait Implementations

impl Debug for TopTracksRequestBuilder

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

Formats the value using the given formatter.

impl FetchAndSave for TopTracksRequestBuilder

type Item = TopTrack

The item type produced by this builder.

fn resource_label() -> &'static str

A human-readable label used in log messages (e.g. "top tracks").

fn latest_timestamp(_items: &[Self::Item]) -> Option<u32>

Return the most recent timestamp from the given items, used to write a sidecar file after saving. Return None (the default) if the item type has no timestamp.

async fn fetch_and_save( self, format: FileFormat, filename_prefix: &str, ) -> Result<String>

Fetch items and save them to a file.

impl LimitBuilder for TopTracksRequestBuilder

fn limit(self, n: u32) -> Self

Set the maximum number of items to fetch.

fn unlimited(self) -> Self

Fetch all available items (no limit).