Struct ProcessDriver 

pub struct ProcessDriver { /* private fields */ }

One instantiated process driver. The runtime keeps one for a whole run, so the driver may carry what launch was given into parse.

Implementations

impl ProcessDriver

pub async fn instantiate( engine: &Engine, component: &Component, name: &str, version: &str, ) -> Result<Self, RuntimeError>

Instantiates component with no grants: a WASI context with no environment, arguments, preopened directories, inherited stdio or network, and no Murmur host import.

Each call into the driver is bounded by the hook call limits (ExecutionLimits::for_hook_calls with no declared deadline), so engine must have an epoch ticker running. name and version identify the driver in errors. Any failure, including an import the empty context does not provide, is RuntimeError::ProcessDriverLoad carrying wasmtime’s message.

pub async fn describe(&mut self) -> Result<Description, RuntimeError>

Calls the driver’s describe.

A trap, an exceeded deadline, or a required-env entry that is not a usable variable name (empty, or containing = or NUL) is RuntimeError::ProcessDriverLoad.

pub async fn launch( &mut self, request: LaunchRequest, ) -> Result<Result<LaunchPlan, String>, RuntimeError>

Asks the driver to plan one harness run. The inner Err is the driver’s own refusal, reported to the operator verbatim; the outer one is a trap or an exceeded deadline.

pub async fn parse( &mut self, lines: Vec<String>, ) -> Result<Vec<Event>, RuntimeError>

Reads one batch of complete stdout lines into events. The same instance serves a whole run, so the driver may answer from what launch was given.

pub async fn classify_exit( &mut self, exit: ExitStatus, ) -> Result<Event, RuntimeError>

Asks the driver what a run whose output ended without a terminal event amounts to.