Struct TrackCache 

pub struct TrackCache {
    pub recent_tracks: Vec<Track>,
    pub artist_tracks: HashMap<String, Vec<Track>>,
    pub metadata: CacheMetadata,
}

Cache structure for storing track data on disk

Fields

recent_tracks: Vec<Track>

Recent tracks (ordered newest first)

artist_tracks: HashMap<String, Vec<Track>>

Artist tracks by artist name

metadata: CacheMetadata

Cache metadata

Implementations

impl TrackCache

pub fn load() -> Self

Load cache from disk, returns default cache if file doesn’t exist or can’t be read

pub fn save(&self) -> Result<(), Box<dyn Error>>

Save cache to disk

pub fn get_recent_tracks(&self, limit: usize) -> &[Track]

Get recent tracks (limited to first n tracks)

pub fn add_recent_tracks(&mut self, tracks: Vec<Track>)

Add recent tracks to the cache (merges and maintains order)

pub fn get_artist_tracks(&self, artist: &str) -> Option<&Vec<Track>>

Get artist tracks

pub fn cache_artist_tracks(&mut self, artist: String, tracks: Vec<Track>)

Cache artist tracks

pub fn clear(&mut self)

Clear all cached data

pub fn clear_artist(&mut self, artist: &str)

Clear cached data for a specific artist

pub fn stats(&self) -> CacheStats

Get cache statistics

pub fn get_all_recent_tracks(&self) -> Vec<Track>

Get all recent tracks (already sorted newest first)

pub fn get_recent_tracks_limited(&self, limit: usize) -> Vec<Track>

Get the N most recent tracks

pub fn get_most_recent_timestamp(&self) -> Option<DateTime<Utc>>

Get the timestamp of the most recent track in cache (if any)

pub fn merge_recent_tracks(&mut self, new_tracks: Vec<Track>) -> CacheMergeStats

Merge new tracks from API into the cache

pub async fn update_cache_from_api( &mut self, client: &(dyn LastFmEditClient + Send + Sync), fetch_bound: Option<DateTime<Utc>>, ) -> Result<()>

Update cache with latest tracks from Last.fm API Fetches tracks until we hit EITHER the fetch_bound OR the cache’s most recent timestamp (whichever comes first chronologically). If fetch_bound is None, fetches without lower bound.

Trait Implementations

impl Clone for TrackCache

fn clone(&self) -> TrackCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TrackCache

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

Formats the value using the given formatter.

impl Default for TrackCache

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TrackCache

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TrackCache

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.