Struct ArtistAlbumsIterator

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

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

This iterator provides paginated access to all albums 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 albums = client.artist_albums("Pink Floyd");

// Get all albums (be careful with large discographies!)
while let Some(album) = albums.next().await? {
    println!("{} (played {} times)", album.name, album.playcount);
}

Implementations

impl<C: LastFmEditClient> ArtistAlbumsIterator<C>

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

Create a new artist albums iterator.

This is typically called via LastFmEditClient::artist_albums.

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

Fetch the next page of albums.

This method handles pagination automatically and includes rate limiting.

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<Album> for ArtistAlbumsIterator<C>

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