Struct Executor

pub struct Executor<K, V>
where
    K: AsRef<OsStr> + Clone,
    V: AsRef<OsStr> + Clone,
{ /* private fields */ }

An execution environment, consisting of environment variables which are provided on the launch of each new process.

Implementations

impl<K, V> Executor<K, V>

where K: AsRef<OsStr> + Clone, V: AsRef<OsStr> + Clone,

pub fn new(env: Vec<(K, V)>) -> Self

Initializes a new Executor.

All environment variables are provided to processes launched with the run method.

pub fn run<I, S>(&self, args: I)

where I: IntoIterator<Item = S>, S: AsRef<OsStr>,

Launches a new subprocess and awaits its completion.

Pretty-prints stdout/stderr on failure.

Panics

This method is a little aggressive about panicking; it can totally evolve structured errors if that would be useful. However, given that the primary purpose is testing, this behavior is currently acceptable.

Panics if…

• args is empty.
• The sub-process fails to execute.
• The execution of the sub-process returns a non-zero exit code.
• The sub-process writes invalid UTF-8 stdout/stderr.