Struct ArtifactCache 

pub struct ArtifactCache { /* private fields */ }

A thread-safe, byte-bounded cache of compiled artifacts keyed by [ArtifactKey]. Read-mostly after warm-up; once the budget is reached, further artifacts are built and returned but not

Implementations

impl ArtifactCache

pub fn new() -> Self

An empty cache with the default byte budget.

pub fn with_budget(budget: usize) -> Self

An empty cache with an explicit retained-byte budget.

pub fn get_or_build_json_schema( &self, schema: &str, assume_closed: bool, vocab_fingerprint: VocabFingerprint, mask_vocab_size: usize, bind_mode: BindMode, build: impl FnOnce() -> Result<CompiledArtifact, CompileError>, ) -> Result<Arc<CompiledArtifact>, CompileError>

The cached artifact for the exact JSON Schema text and options, calling build and inserting its result on a miss. The key is derived from schema/assume_closed INSIDE this

pub fn get_or_build_mfir_wire( &self, wire: &[u8], vocab_fingerprint: VocabFingerprint, mask_vocab_size: usize, bind_mode: BindMode, build: impl FnOnce() -> Result<CompiledArtifact, CompileError>, ) -> Result<Arc<CompiledArtifact>, CompileError>

Same contract as Self::get_or_build_json_schema, keyed on the exact MFIR wire bytes instead of schema text.

pub fn get_or_build_executable( &self, semantic_identity: &[u8], vocab_fingerprint: VocabFingerprint, mask_vocab_size: usize, bind_mode: BindMode, build: impl FnOnce() -> Result<CompiledArtifact, CompileError>, ) -> Result<Arc<CompiledArtifact>, CompileError>

Returns or binds one exact vocabulary-neutral executable identity.

pub fn clear(&self)

Drops every retained artifact. Also clears the LRU touch-log. Traffic counters (stats()) are NOT reset - they are a lifetime total, not scoped to content currently retained.

pub fn len(&self) -> usize

The number of retained artifacts.

pub fn is_empty(&self) -> bool

Whether the cache retains no artifact.

pub fn bytes(&self) -> usize

Retained artifact bytes. Bounds the CACHE only - an artifact a Matcher still holds its own Arc to stays alive via that reference even if evicted or never cached here.

pub fn stats(&self) -> (u64, u64, u64, u64)

(hits, misses, evictions, oversized_bypasses) since creation - a lifetime traffic total, NOT reset by clear(). oversized_bypasses is a built artifact whose conservative upper

Trait Implementations

impl Default for ArtifactCache

fn default() -> Self

Returns the “default value” for a type.