Struct CacheStore 

pub struct CacheStore { /* private fields */ }

Handle to an open cache directory. Cheap to clone if needed (just holds a PathBuf); creating a new one with CacheStore::open is also cheap once the version check has run.

Implementations

impl CacheStore

pub fn open(root: impl Into<PathBuf>) -> Result<Self>

Open (or create) a cache rooted at root. If a version file exists with a value other than CACHE_SCHEMA_VERSION, the entire directory is wiped before the store returns.

pub fn root(&self) -> &Path

pub fn get(&self, kind: CacheKind, key: &CacheKey) -> Result<Option<Vec<u8>>>

Look up a blob. Returns Ok(None) if the entry is absent; Err(_) only on real I/O failures.

pub fn put(&self, kind: CacheKind, key: &CacheKey, data: &[u8]) -> Result<()>

Insert (or overwrite) a blob. Atomic: writes to tmp/<random> and renames into place. Concurrent inserts of the same key are safe; whichever rename wins is the visible result.

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

Wipe every cache file. Equivalent to gruel cache clean.

pub fn stats(&self) -> Result<[(CacheKind, CacheStats); 3]>

Walk the cache directory and accumulate per-kind stats. O(N) in the number of entries; called only by gruel cache stats and during tests, never on the hot path.

Trait Implementations

impl Clone for CacheStore

fn clone(&self) -> CacheStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheStore

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

Formats the value using the given formatter.