Struct RecentTracksRequestBuilder

Source

pub struct RecentTracksRequestBuilder { /* private fields */ }

Expand description

Builder for recent tracks requests

Implementations§

Source §

impl RecentTracksRequestBuilder

Source

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

Set the maximum number of tracks to fetch

§Arguments

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

Source

pub const fn unlimited(self) -> Self

Fetch all available tracks (no limit)

Source

pub const fn since(self, timestamp: i64) -> Self

Fetch tracks from this timestamp onwards

§Arguments

timestamp - Unix timestamp in seconds (not milliseconds) since January 1, 1970 UTC

§Example

// Fetch tracks since January 1, 2024 00:00:00 UTC
let tracks = client.recent_tracks()
    .builder("username")
    .since(1704067200)
    .fetch()
    .await?;

Source

pub const fn between(self, from: i64, to: i64) -> Self

Fetch tracks between two timestamps

§Arguments

from - Start Unix timestamp in seconds (not milliseconds) since January 1, 1970 UTC
to - End Unix timestamp in seconds (not milliseconds) since January 1, 1970 UTC

§Example

// Fetch tracks between January 1, 2024 and February 1, 2024 (UTC)
let tracks = client.recent_tracks()
    .builder("username")
    .between(1704067200, 1706745600)
    .fetch()
    .await?;

Source

pub const fn extended(self, extended: bool) -> Self

Fetch extended track information

Source

pub fn on_progress( self, callback: impl Fn(u32, u32) + Send + Sync + 'static, ) -> Self

Register a progress callback invoked with (fetched, total) after each batch.

Source

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

Fetch the tracks

§Errors

Returns an error if:

The HTTP request fails or the response cannot be parsed
The date range is invalid (to <= from when both timestamps are set)

Source

pub async fn fetch_extended(self) -> Result<TrackList<RecentTrackExtended>>

Fetch tracks with extended information

§Errors

Returns an error if:

The HTTP request fails or the response cannot be parsed
The date range is invalid (to <= from when both timestamps are set)

Source

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

Fetch tracks and save them to a file

§Arguments

format - The file format to save the tracks 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

Source

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

Fetch tracks with extended information and save them to a file

§Arguments

format - The file format to save the tracks 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

Source

pub async fn fetch_and_update(self, file_path: &str) -> Result<usize>

Fetch only tracks newer than the most recent entry in an existing JSON file and prepend them to it. If the file does not exist, all tracks are fetched and the file is created.

§Arguments

file_path - Path to the JSON file to update (or create)

§Errors

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

§Returns

Result<usize> - Number of new tracks prepended

Source

pub async fn fetch_extended_and_update(self, file_path: &str) -> Result<usize>

Fetch only extended tracks newer than the most recent entry in an existing JSON file and prepend them to it. If the file does not exist, all tracks are fetched and the file is created.

§Arguments

file_path - Path to the JSON file to update (or create)

§Errors

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

§Returns

Result<usize> - Number of new tracks prepended

Source

pub async fn analyze(self, threshold: usize) -> Result<TrackStats>

Analyze tracks and return statistics

§Arguments

threshold - Minimum play count threshold. Tracks with fewer plays than this value will be counted separately in tracks_below_threshold. For example, use 5 to identify tracks played less than 5 times.

§Errors

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

§Returns

Result<crate::analytics::TrackStats> - Analysis results including play counts, most played tracks, etc.

Source

pub async fn analyze_and_print(self, threshold: usize) -> Result<()>

Analyze tracks and print statistics

§Arguments

threshold - Minimum play count threshold. Tracks with fewer plays than this value will be counted separately. For example, use 5 to identify tracks played less than 5 times.