Struct RomCache 

pub struct RomCache { /* private fields */ }

In-memory view of the persisted ROM cache.

Internally this is just a HashMap keyed by RomCacheKey, plus the path of the JSON file on disk. All callers go through RomCache::load so they never touch the filesystem directly.

Implementations

impl RomCache

pub fn load() -> Self

Load cache from disk (or start empty if the file is missing / corrupt).

pub fn effective_path() -> PathBuf

Effective ROM cache path (ROMM_CACHE_PATH override wins over OS-local default).

pub fn clear_file() -> Result<bool>

Remove the cache file from disk if it exists.

pub fn read_info() -> RomCacheInfo

Read best-effort metadata and parse information for the current cache file.

pub fn save(&self)

Persist current cache to disk (best-effort; errors are silently ignored).

pub fn get_valid( &self, key: &RomCacheKey, expected_count: u64, ) -> Option<&RomList>

Return cached data only if the platform’s rom_count hasn’t changed since we cached it. We compare the stored count (from the platforms endpoint at cache time) against the current count — NOT RomList.total, which can legitimately differ from rom_count.

pub fn insert(&mut self, key: RomCacheKey, data: RomList, expected_count: u64)

Insert (or replace) an entry, then persist to disk. expected_count is the platform/collection rom_count at this moment.

pub fn remove(&mut self, key: &RomCacheKey) -> bool

Drop one cache entry if present, then persist.

pub fn remove_all_platform_entries(&mut self) -> usize

Remove every RomCacheKey::Platform entry (e.g. after a full scan_library).