Struct LocalCache 

pub struct LocalCache { /* private fields */ }

Filesystem-based cache store.

Each entry is stored as a JSON file named by the cache key’s hex. Suitable for persistent local caching across process restarts.

Implementations

impl LocalCache

pub fn new(base_dir: impl Into<PathBuf>) -> Result<Self>

Open (or create) a cache rooted at base_dir.

pub fn len(&self) -> usize

Number of cached entries (scans filesystem).

pub fn is_empty(&self) -> bool

Whether the cache holds no entries (scans the filesystem).

pub fn clear(&self) -> Result<()>

Remove all cached entries.

Trait Implementations

impl CacheStore for LocalCache

fn tier(&self) -> CacheTier

Which tier this store is, for reporting.

fn get(&self, key: &CacheKey) -> Result<Option<Value>>

Look up the value stored under key, None on a miss.

fn put(&self, key: &CacheKey, value: &Value) -> Result<()>

Store value under key, replacing any existing entry.

fn put_with_origin( &self, key: &CacheKey, value: &Value, origin: &Origin, ) -> Result<()>

Store a value together with its provenance. Stores that persist metadata should override this; the default discards the origin.

fn exists(&self, key: &CacheKey) -> Result<bool>

Whether key has an entry, without loading the value.

fn remove(&self, key: &CacheKey) -> Result<()>

Delete the entry under key; absent keys are not an error.

fn metadata(&self, key: &CacheKey) -> Result<Option<EntryMeta>>

The entry’s EntryMeta, without loading the value.

fn put_computed( &self, key: &CacheKey, value: &Value, origin: &Origin, compute: Duration, deterministic: bool, ) -> Result<(), SomaError>

Store a freshly-computed value with its full provenance record: origin, wall-clock compute cost, and the producer’s determinism declaration. Cost-aware eviction needs the compute time — a tiny value that took days must outlive a huge one that took seconds. The default discards the extra metadata.

fn get_located( &self, key: &CacheKey, ) -> Result<Option<(Value, CacheTier)>, SomaError>

Like CacheStore::get, but also reports which tier served the value.