Struct CompilationCache 

pub struct CompilationCache<K, V> { /* private fields */ }

A server’s in-memory compilation cache: the compiled artifacts it memoizes — pipelines, loaded modules — in front of a persistent compilation_store.

Entries are dropped when the environment switches, because the map is bound to an environment exactly as the store it mirrors is. One served after a switch would describe the environment that is gone, and, worse, would never be written to the new environment’s store, so a bundle exported from that environment would silently be missing that kernel. This is the same contract Store applies to itself, for the state a store cannot see — see cubecl_environment::environment::generation.

Every accessor resets before it answers, so a backend has nothing to remember beyond using this in place of a plain map.

Implementations

impl<K: Eq + Hash, V> CompilationCache<K, V>

pub fn mirroring<SK: StoreKey, SV: StoreValue>( store: &Option<Store<SK, SV>>, ) -> Self

An empty cache in front of store, bound to the active environment exactly when that store exists.

Unbound otherwise: with nothing persisted, a switch changes nothing about what the cache holds, so resetting it would only buy a redundant compilation — the same reason the autotune cache survives a switch when its persistent cache is off.

pub fn unbound() -> Self

An empty cache that no environment switch ever resets, for a backend with no persistent store to mirror.

pub fn get(&mut self, key: &K) -> Option<&V>

The artifact compiled for key, if it is still valid.

pub fn contains(&mut self, key: &K) -> bool

Whether an artifact for key is cached and still valid.

pub fn insert(&mut self, key: K, value: V)

Records a freshly compiled artifact.

Trait Implementations

impl<K: Debug, V: Debug> Debug for CompilationCache<K, V>

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

Formats the value using the given formatter.