Struct CompilationCache 

pub struct CompilationCache { /* private fields */ }

Thread-safe LRU cache for compiled schemas.

Design

• Fingerprinting: Uses SHA-256 hash of schema JSON for cache keys
• LRU eviction: Automatically evicts least-recently-used entries
• Thread-safe: All operations use interior mutability

Memory Safety

• Hard LRU limit ensures bounded memory usage
• Default config: 100 entries (reasonable for most deployments)

Example

use fraiseql_core::compiler::compilation_cache::{CompilationCache, CompilationCacheConfig};
use fraiseql_core::compiler::Compiler;

let cache = CompilationCache::new(CompilationCacheConfig::default());
let compiler = Compiler::new();

let schema_json = r#"{"types": [], "queries": []}"#;

// First compilation - cache miss
let compiled = cache.compile(&compiler, schema_json)?;

// Second compilation - cache hit
let compiled_cached = cache.compile(&compiler, schema_json)?;

Implementations

impl CompilationCache

pub fn new(config: CompilationCacheConfig) -> Self

Create new compilation cache with configuration.

Panics

Panics if cache is enabled but max_entries is 0. Uses parking_lot::Mutex internally, so lock operations are infallible (no poison panics).

pub fn compile( &self, compiler: &Compiler, schema_json: &str, ) -> Result<Arc<CompiledSchema>>

Compile schema with caching.

If cache is enabled and schema fingerprint matches a cached entry, returns the cached compiled schema. Otherwise, compiles the schema and stores result in cache.

Arguments

• compiler - Schema compiler
• schema_json - JSON schema emitted by the authoring-language decorators

Errors

Returns FraiseQLError if schema compilation fails.

pub fn metrics(&self) -> Result<CompilationCacheMetrics>

Get current cache metrics.

Errors

This function is currently infallible. The Result return type is reserved for future implementations that may use fallible storage.

pub fn clear(&self) -> Result<()>

Clear all cached compilations.

Errors

This function is currently infallible. The Result return type is reserved for future implementations that may use fallible storage.

pub fn hit_rate(&self) -> Result<f64>

Get cache hit rate as percentage (0-100).

Errors

This function is currently infallible. The Result return type is reserved for future implementations that may use fallible storage.