Struct Cache 

pub struct Cache { /* private fields */ }

On-disk content-addressed embedding cache.

Implementations

impl Cache

pub fn open<P: AsRef<Path>>(path: P) -> Result<Self>

Open or create a cache at path with no TTL.

pub fn open_with_ttl<P: AsRef<Path>>( path: P, ttl_secs: Option<u64>, ) -> Result<Self>

Open or create a cache at path with an optional TTL in seconds.

pub fn key(model: &str, text: &str) -> [u8; 32]

32-byte content-addressed key for (model, text).

pub fn get(&self, model: &str, text: &str) -> Result<Option<Vec<f32>>>

Look up a vector. Returns None if absent or expired.

pub fn put(&self, model: &str, text: &str, vector: &[f32]) -> Result<()>

Insert or overwrite a vector for (model, text).

pub fn remove(&self, model: &str, text: &str) -> Result<bool>

Remove a single entry. Returns true if the key was present.

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

Remove every entry. Returns the number of entries removed.

pub fn purge_expired(&self) -> Result<u64>

Remove every entry whose inserted_at + ttl < now. Returns the count. No-op when the cache has no TTL.

pub fn purge_to_size(&self, target_bytes: u64) -> Result<u64>

Evict oldest entries until the total stored value bytes are <= target_bytes. Returns the count removed.

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

Counts and bytes for the cache.

pub fn len(&self) -> Result<u64>

Number of entries.

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

True if no entries are stored.