Struct TopAlbumsRequestBuilder 

pub struct TopAlbumsRequestBuilder { /* private fields */ }

Builder for top albums requests

Implementations

impl TopAlbumsRequestBuilder

pub const fn limit(self, limit: u32) -> Self

Set the maximum number of albums to fetch

Arguments

• limit - Maximum number of albums to fetch. The Last.fm API supports fetching up to thousands of albums. If you need all albums, use unlimited() instead.

pub const fn unlimited(self) -> Self

Fetch all available albums (no limit)

pub const fn period(self, period: Period) -> Self

Set the time period for top albums

Arguments

• period - The time range to calculate top albums over. Use Period::Overall for all-time, Period::Week for last 7 days, Period::Month for last 30 days, etc. If not set, defaults to the Last.fm API’s default behavior (typically overall).

pub async fn fetch(self) -> Result<TrackList<TopAlbum>>

Fetch the albums

Errors

Returns an error if the HTTP request fails or the response cannot be parsed.

pub async fn fetch_and_save( self, format: FileFormat, filename_prefix: &str, ) -> Result<String>

Fetch albums and save them to a file

Arguments

• format - The file format to save the albums in
• filename_prefix - Prefix for the generated filename

Errors

Returns an error if the HTTP request fails, response cannot be parsed, or file cannot be saved.

Returns

• Result<String> - The filename of the saved file

Trait Implementations

impl Debug for TopAlbumsRequestBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.