Struct ArtistsIterator

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

Iterator for browsing all artists in the user’s library.

This iterator provides access to all artists in the authenticated user’s Last.fm library, sorted by play count (highest first). The iterator loads artists as needed and handles rate limiting automatically to be respectful to Last.fm’s servers.

Examples

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

let mut artists = client.artists();

// Get the top 10 artists
let top_artists = artists.take(10).await?;
for artist in top_artists {
    println!("{} ({} plays)", artist.name, artist.playcount);
}

Implementations

impl<C: LastFmEditClient> ArtistsIterator<C>

pub fn new(client: C) -> Self

Create a new artists iterator.

This iterator will start from page 1 and load all artists in the user’s library.

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

Create a new artists iterator starting from a specific page.

This is useful for implementing offset functionality efficiently by starting at the appropriate page rather than iterating through all previous pages.

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

Fetch the next page of artists.

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<Artist> for ArtistsIterator<C>

fn next<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Option<Artist>>> + '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 total_pages(&self) -> Option<u32>

Get the total number of pages, if known.

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.