Struct LruCompilationCache 

pub struct LruCompilationCache { /* private fields */ }

LRU compilation cache with configurable capacity.

Stores compiled EinsumGraph instances keyed by ExprFingerprint. When capacity is exceeded the least-recently-used entry is evicted.

This cache is not thread-safe — wrap it in Arc<Mutex<_>> or use CompilationCache if you need concurrent access.

Example

use tensorlogic_compiler::cache::{LruCompilationCache, ExprFingerprint};
use tensorlogic_ir::EinsumGraph;

let mut cache = LruCompilationCache::new(4);
let fp = ExprFingerprint::compute("pred(x)");
cache.insert(fp.clone(), EinsumGraph::new());
assert!(cache.get(&fp).is_some());

Implementations

impl LruCompilationCache

pub fn new(capacity: usize) -> Self

Create a new LRU cache with the given capacity (minimum 1).

pub fn insert(&mut self, fp: ExprFingerprint, graph: EinsumGraph)

Insert a compiled result for the given fingerprint.

If the fingerprint already exists the stored graph is updated and the entry is promoted to the most-recently-used position.

If the cache is at capacity the least-recently-used entry is evicted before the new entry is inserted.

pub fn get(&mut self, fp: &ExprFingerprint) -> Option<&CachedResult>

Look up a fingerprint.

On a hit the entry is promoted to the most-recently-used position, its hit_count is incremented, and a reference to it is returned. On a miss None is returned.

pub fn contains(&self, fp: &ExprFingerprint) -> bool

Check if a fingerprint is present without updating LRU order or stats.

pub fn invalidate(&mut self, fp: &ExprFingerprint) -> bool

Remove a specific entry by fingerprint.

Returns true if the entry existed and was removed, false otherwise.

pub fn clear(&mut self)

Clear all cached entries, resetting memory accounting.

Statistics counters (hits, misses, evictions) are not reset.

pub fn stats(&self) -> &CacheStats

Reference to the current statistics snapshot.

pub fn len(&self) -> usize

Number of cached entries.

pub fn is_empty(&self) -> bool

Returns true when the cache contains no entries.

pub fn capacity(&self) -> usize

The maximum number of entries this cache can hold before eviction.

Trait Implementations

impl Default for LruCompilationCache

fn default() -> Self

Returns the “default value” for a type.