Struct RecentTracksIterator 

pub struct RecentTracksIterator<C: LastFmEditClient> { /* private fields */ }

Iterator for browsing a user’s recent tracks/scrobbles.

This iterator provides access to the user’s recent listening history with timestamps, which is essential for finding tracks that can be edited. It supports optional timestamp-based filtering to avoid reprocessing old data.

Implementations

impl<C: LastFmEditClient> RecentTracksIterator<C>

pub fn new(client: C) -> Self

Create a new recent tracks iterator starting from page 1.

This is typically called via LastFmEditClient::recent_tracks.

pub fn with_starting_page(client: C, starting_page: u32) -> Self

Create a new recent tracks iterator starting from a specific page.

This allows resuming pagination from an arbitrary page, useful for continuing from where a previous iteration left off.

Arguments

• client - The LastFmEditClient to use for API calls
• starting_page - The page number to start from (1-indexed)

pub fn with_stop_timestamp(self, timestamp: u64) -> Self

Set a timestamp to stop iteration at.

When this is set, the iterator will stop returning tracks once it encounters a track with a timestamp less than or equal to the specified value. This is useful for incremental processing to avoid reprocessing old data.

Arguments

• timestamp - Unix timestamp to stop at

Trait Implementations

impl<C: LastFmEditClient> AsyncPaginatedIterator<Track> for RecentTracksIterator<C>

fn next<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Option<Track>>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch the next item from the iterator.

fn current_page(&self) -> u32

Get the current page number (0-indexed).

fn collect_all<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Vec<T>>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Collect all remaining items into a Vec.

fn take<'life0, 'async_trait>( &'life0 mut self, n: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<T>>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Take up to n items from the iterator.

fn total_pages(&self) -> Option<u32>

Get the total number of pages, if known.