Struct ExpertStore 

pub struct ExpertStore<S: ExpertSource> { /* private fields */ }

The bounded cache. See the module docs for the design contract.

Implementations

impl<S: ExpertSource> ExpertStore<S>

pub fn new(source: S, budget_bytes: usize) -> Self

pub fn budget_bytes(&self) -> usize

pub fn stats(&self) -> ExpertStoreStats

pub fn prefetch(&self, keys: &[ExpertKey])

Best-effort warm of keys into the cache (ds4-style SSD streaming prefetch): acquires each key and drops the lease so the entry stays resident under the budget until eviction. Concurrent acquires on the same key may duplicate I/O; never returns wrong bytes. Failures on individual keys are skipped.

pub fn acquire(&self, key: ExpertKey) -> Result<ExpertLease>

Returns a pinned lease on key’s bytes, reading them from the source on a miss. Never blocks waiting for other leases to be released: if the entry cannot fit in the budget right now, the bytes are returned uncached (see module docs).