Struct BytecodeCache 

pub struct BytecodeCache { /* private fields */ }

On-disk bytecode cache stored under ~/.shape/cache/bytecode/

Implementations

impl BytecodeCache

pub fn new() -> Option<Self>

Create a new bytecode cache, creating the cache directory if needed.

The cache lives at ~/.shape/cache/bytecode/. Returns None if the home directory cannot be determined or the directory cannot be created.

pub fn with_dir(cache_dir: PathBuf) -> Result<Self>

Create a cache at a specific directory (for testing).

pub fn get(&self, source: &str) -> Option<BytecodeProgram>

Look up cached bytecode for the given source content.

Returns Some(program) on cache hit, None on miss or deserialization error.

pub fn put(&self, source: &str, program: &BytecodeProgram) -> Result<()>

Store compiled bytecode for the given source content.

W17-make-closure note. Programs whose compiler produced any closure_function_layouts entries (i.e. the source contains at least one closure literal) are not cached. The ClosureLayout side-table is currently #[serde(skip)] on BytecodeProgram and ContentAddressedProgram — a deserialized program would load with an empty layouts vector, and op_make_closure would then surface no ClosureLayout registered for function N (crates/shape-vm/src/executor/control_flow/mod.rs:447). Until ClosureLayout (+ ConcreteType / FieldInfo / NativeKind / CaptureKind) grow Serialize/Deserialize derives, the safe disposition is to skip caching for closure-bearing programs. Caching for closure-free programs remains in force.

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

Remove all cached bytecode files.