Struct GovernedCache 

pub struct GovernedCache { /* private fields */ }

An OutputCache decorator: the durable promoted store is consulted first, then the mutable disposable DerivedCache. Promotion is decided in OutputCache::note.

Implementations

impl GovernedCache

pub fn open(store_root: impl AsRef<Path>, gov: Governor) -> Result<Self>

Open the governed cache over a store root: the disposable cache/ plus the durable promoted/, sharing gov. On the first open of a governor the durable byte count is reconciled from disk; a store already over budget is cleared wholesale (the coarse bound ModelMemo uses).

pub fn promoted(&self) -> &PromotedStore

The durable promoted store (for courts and stats).

Trait Implementations

impl Debug for GovernedCache

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

Formats the value using the given formatter.

impl OutputCache for GovernedCache

fn get(&self, id: &NodeId) -> Result<Option<Vec<u8>>>

Fetch a cached node output, or None on a miss. A get error is treated as a miss by the caller (the cache is disposable, never authority).

fn put(&mut self, id: &NodeId, bytes: &[u8]) -> Result<()>

Store a node output. Best-effort: a put error does not fail the materialization.

fn note(&mut self, note: CacheNote<'_>)

Phase 15.6. Advisory, best-effort reuse/store event, reported for every cache hit and store. The default is a no-op, so NoCache and DerivedCache are byte-identical to a build without this method; it is never on the exactness path and can never change an output.