Struct CacheManager 

pub struct CacheManager { /* private fields */ }

Manages cache lifecycle: freshness check, rebuild, and fallback to TSJSON.

Usage

use bones_core::cache::manager::CacheManager;

let mgr = CacheManager::new(".bones/events", ".bones/cache/events.bin");
let events = mgr.load_events().unwrap();

Implementations

impl CacheManager

pub fn new( events_dir: impl Into<PathBuf>, cache_path: impl Into<PathBuf>, ) -> Self

Create a new cache manager.

Arguments

• events_dir — Path to .bones/events/ shard directory.
• cache_path — Path to .bones/cache/events.bin.

pub fn is_fresh(&self) -> Result<bool>

Check whether the cache file exists and is fresh.

Returns true if:

• The cache file exists and can be opened.
• The stored fingerprint matches the current shard fingerprint.

Returns false otherwise (missing, corrupt, stale, or on any error).

Errors

Returns an error if computing the shard fingerprint fails.

pub fn load_events(&self) -> Result<LoadResult>

Load events, preferring the binary cache when fresh.

1. Compute a fingerprint over event shard files.
2. If cache exists and fingerprint matches → decode from cache.
3. Otherwise → parse TSJSON, then rebuild the cache in the foreground (so next call is fast). Cache rebuild failures are logged but do not cause the load to fail.

Errors

Returns an error only if TSJSON parsing itself fails. Cache errors are handled by falling back to TSJSON.

pub fn rebuild(&self) -> Result<CacheStats>

Force a cache rebuild from TSJSON event shards.

Returns statistics about the rebuilt cache.

Errors

Returns an error if shard replay, parsing, or cache writing fails.

pub fn events_dir(&self) -> &Path

Return the path to the events directory.

pub fn cache_path(&self) -> &Path

Return the path to the cache file.

Trait Implementations

impl Clone for CacheManager

fn clone(&self) -> CacheManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheManager

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

Formats the value using the given formatter.