Struct ArtistTracksIterator

pub struct ArtistTracksIterator<'a> { /* 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 = LastFmClient::new(Box::new(http_client::native::NativeClient::new()));
// client.login(...).await?;

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<'a> ArtistTracksIterator<'a>

pub fn new(client: &'a mut LastFmClient, artist: String) -> Self

Create a new artist tracks iterator.

This is typically called via LastFmClient::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<'a> AsyncPaginatedIterator for ArtistTracksIterator<'a>

type Item = Track

The item type yielded by this iterator

async fn next(&mut self) -> Result<Option<Self::Item>>

Fetch the next item from the iterator.

fn current_page(&self) -> u32

Get the current page number (0-indexed).

async fn collect_all(&mut self) -> Result<Vec<Self::Item>>

Collect all remaining items into a Vec.

async fn take(&mut self, n: usize) -> Result<Vec<Self::Item>>

Take up to n items from the iterator.