Struct Precompiler 

pub struct Precompiler { /* private fields */ }

An engine and compiled-forms handle for storing the forms of installed artifacts.

Implementations

impl Precompiler

pub fn new(capsule_writable: Option<&Path>) -> Option<Self>

A precompiler whose forms are withheld, as a launch withholds them, when the murmur home or ~/.murmur/compiled is reachable from capsule_writable, the directory the consuming capsule’s writable root is created in. None for a writer that stages no capsule, such as an install into the global store. None when the engine cannot be built.

pub fn precompile( &self, name: &str, version: &str, payload: &[u8], ) -> Precompiled

Stores the compiled form of the artifact name@version whose payload is payload, unless a usable one is already stored. Never fails, panics or prints: whatever the outcome, a launch that stages payload behaves as it would have without this call, only faster when it returns Precompiled::Compiled or Precompiled::AlreadyStored.

Eligible payloads are those whose packed manifest resolves to wasm execution in any role but capsule: a capsule’s own component is staged under the sha256 of the component, not of its payload. The role itself is left open because staging takes it from the consuming manifest’s entry, not from the packed runtime:.

pub fn precompile_all(&self, items: &[PrecompileItem<'_>]) -> Vec<Precompiled>

precompile for every item, one outcome per item in input order, whatever order the compiles finish in.

Up to std::thread::available_parallelism eligible payloads compile at once, each on a thread of its own outside rayon’s global pool. That pool is where wasmtime compiles one component’s functions in parallel, so a compile’s serial phases never hold a pool thread another compile’s functions are waiting for. Payloads that are not eligible are settled on the calling thread first, so a batch with no WASM payload starts no thread.