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 describe(&mut self) -> Result<Description, RuntimeError>

Calls the driver’s describe.

A trap, an exceeded deadline, a required-env entry that is not a usable variable name (empty, or containing = or NUL), or a login-check command naming no arguments is RuntimeError::ProcessDriverLoad. The bare harness binary may start a session, so the login check must never run it with nothing after it.

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.

pub async fn read_login( &mut self, output: LoginOutput, ) -> Result<LoginState, RuntimeError>

Asks the driver to read what its login-check command printed.