Struct Runner 

pub struct Runner { /* private fields */ }

Available on crate feature std only.

An external runner that executes program text in a language runtime.

The pattern consumes text conforming to the runtime’s grammar and produces the execution result as text. This wrapper transports input and output as bytes; the external program parses and executes the input.

Each definition is passed as a --define=<key>=<value> argument; its meaning is determined by the runtime. Input and output use the buffering and stream-handling behavior described in crate::programs. For direct control over command configuration, use Executor instead.

Implementations

impl Runner

pub fn new( program: impl AsRef<OsStr>, input: Input, output: Output, options: RunnerOptions, ) -> Self

Configures a runner without starting it.

Adds one --define=<key>=<value> argument per entry in options.define, in BTreeMap key order, followed by options.other. Duplicate keys have already been collapsed by the map; ordered or repeated definitions can instead be supplied through options.other. Names must be nonempty and contain no =; values may be empty or contain =. This constructor does not validate them. The input and output values select stdin and stdout; stderr is captured for failure diagnostics.

pub async fn execute(&mut self) -> RunnerResult

Sends the remaining input to a new child and returns captured stdout bytes.

Errors

Returns an ExecutorError if spawning, copying input, or waiting fails, or if the runner exits unsuccessfully.

Trait Implementations

impl Debug for Runner

fn fmt(&self, __derive_more_f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Execute<Cursor<Vec<u8>>> for Runner

type Error = ExecutorError

The implementation-specific error returned directly by execution.

fn execute<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = RunnerResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Executes the operation using its current input and configuration.

impl Runner<Cursor<Vec<u8>>> for Runner