Struct EvalCache 

pub struct EvalCache { /* private fields */ }

Content-addressed evaluation cache with optional persistence.

Implementations

impl EvalCache

pub fn new() -> Self

Create a new in-memory-only cache.

pub fn with_persistent(db_path: PathBuf) -> Self

Create a cache with persistent storage at the given path. Loads existing entries from disk if the file exists.

pub fn default_persistent() -> Self

Create a cache using the default persistent path (~/.cache/sui/eval-cache.json).

pub fn disabled() -> Self

Create a disabled cache (always misses).

pub fn with_graph_store(self, store: GraphStore) -> Self

Stack a GraphStore tier on this cache. Existing tiers (in-memory + optional JSON file) are preserved verbatim. Calls this builder-style: EvalCache::default_persistent().with_graph_store(gs).

pub fn with_all_tiers(db_path: PathBuf, store: GraphStore) -> Self

Construct an EvalCache with all three tiers enabled.

• In-memory — always.
• JSON file — at db_path (also loaded on construction).
• GraphStore — using store.

pub fn is_enabled(&self) -> bool

Whether the cache is enabled.

pub fn has_graph_store(&self) -> bool

True iff the GraphStore tier is wired.

pub fn get(&mut self, key: &CacheKey) -> Option<&CachedValue>

Look up a cached result. Tier order: memory → graph_store. Behavior contract: a hit from the graph_store tier is promoted into the memory tier so the next same-process lookup is sub-microsecond. The promotion is the only mutation get performs.

pub fn put(&mut self, key: CacheKey, value: CachedValue)

Store a result in the cache. Writes to memory unconditionally and to every wired persistence tier (JSON + GraphStore) best-effort. Tier writes never fail loudly — eval-cache puts are advisory; a failed write doesn’t change the correctness of the eval, just the chance of a future hit.

pub fn len(&self) -> usize

Number of cached entries.

pub fn is_empty(&self) -> bool

Whether the cache is empty.

pub fn key_for_file(path: &Path) -> Option<CacheKey>

Compute the cache key for a file on disk.

The source hash is the SHA-256 of the file content. If a flake.lock exists in the same directory, its hash is included as the lock_hash.

Trait Implementations

impl Default for EvalCache

fn default() -> Self

Returns the “default value” for a type.