Struct LovedTracksRequestBuilder 

pub struct LovedTracksRequestBuilder { /* private fields */ }

Builder for loved tracks requests

Implementations

impl LovedTracksRequestBuilder

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 async fn fetch(self) -> Result<TrackList<LovedTrack>>

Fetch the tracks

Errors

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

Trait Implementations

impl Debug for LovedTracksRequestBuilder

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

Formats the value using the given formatter.

impl FetchAndSave for LovedTracksRequestBuilder

type Item = LovedTrack

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 FetchAndUpdate for LovedTracksRequestBuilder

async fn fetch_since(self, max_ts: Option<u32>) -> Result<Vec<Self::Item>>

Fetch all loved tracks and return only those newer than max_ts.

Because the loved tracks API does not support a from timestamp filter, all tracks are fetched and those already present (by timestamp) are filtered out in memory.

type Item = LovedTrack

The item type produced by this builder.

async fn fetch_and_update(self, file_path: &str) -> Result<usize>

Fetch only items newer than the most recent entry in an existing file and prepend them to it. Creates the file if it does not exist.

impl LimitBuilder for LovedTracksRequestBuilder

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

Set the maximum number of items to fetch.

fn unlimited(self) -> Self

Fetch all available items (no limit).