Struct Executor 

pub struct Executor<R: CommandRunner> { /* private fields */ }

Orchestration engine that walks a Program AST and applies shell-like execution semantics.

Generic over CommandRunner so the actual command dispatch is pluggable. The composition root wires in a concrete runner (e.g., a process spawner, a hook dispatcher, or a test double).

Semantics

• && / || — connect pipelines; the gate is the previous pipeline’s success.
• | — pipe stdout of one command into the next.
• |& — pipe stdout + stderr of one command into the next.
• ? suffix — marks a command as optional; optional commands in sequence accumulate their outputs into a Context, which is serialized as JSON and passed to the first non-optional command that follows.
• > / >> — redirect the final command’s stdout to a file.

Implementations

impl<R: CommandRunner> Executor<R>

pub fn new(runner: R) -> Self

pub fn into_runner(self) -> R

Consume the executor and return the underlying runner.

Useful in tests to inspect what the runner recorded after execution.

Trait Implementations

impl<R: CommandRunner> Execute for Executor<R>

fn execute( &self, program: &Program, ) -> Result<Option<PipeValue>, ExecutionError>