Struct ArtistTracksIterator

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

Iterator for browsing an artist’s tracks from a user’s library.

This iterator provides paginated access to all tracks by a specific artist in the authenticated user’s Last.fm library, ordered by play count.

Examples

let mut client = LastFmEditClientImpl::from_session(Box::new(http_client::native::NativeClient::new()), test_session);

let mut tracks = client.artist_tracks("The Beatles");

// Get the top 5 most played tracks
let top_tracks = tracks.take(5).await?;
for track in top_tracks {
    println!("{} (played {} times)", track.name, track.playcount);
}

Implementations

impl<C: LastFmEditClient> ArtistTracksIterator<C>

pub fn new(client: C, artist: String) -> Self

Create a new artist tracks iterator.

This is typically called via LastFmEditClient::artist_tracks.

pub async fn next_page(&mut self) -> Result<Option<TrackPage>>

Fetch the next page of tracks.

This method handles pagination automatically and includes rate limiting to be respectful to Last.fm’s servers.

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

Get the total number of pages, if known.

Returns None until at least one page has been fetched.

Trait Implementations

impl<C: LastFmEditClient> AsyncPaginatedIterator<Track> for ArtistTracksIterator<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.