Struct CommandBuilder 

pub struct CommandBuilder { /* private fields */ }

A guest command being assembled — see Sandbox::command.

Implementations

impl CommandBuilder

pub fn arg(self, arg: impl Into<String>) -> Self

Append one argument.

pub fn args<I, S>(self, args: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Append arguments.

pub fn env(self, key: impl Into<String>, value: impl Into<String>) -> Self

Set a per-command environment variable (-e K=V).

pub fn cwd(self, cwd: impl Into<String>) -> Self

Run in a working directory (emulated: cd, then exec the real argv).

pub fn stdin(self, data: impl AsRef<[u8]>) -> Self

Pipe bytes (or a string) to the command’s stdin.

pub fn tty(self, tty: bool) -> Self

Allocate a PTY (-t).

pub fn log_level(self, level: u32) -> Self

bsdkrun’s global --log-level for this call (default 0 — quiet).

pub fn stdout(self, writer: impl Write + Send + 'static) -> Self

Stream stdout to writer while retaining it in the returned result.

pub fn stderr(self, writer: impl Write + Send + 'static) -> Self

Stream stderr to writer while retaining it in the returned result.

pub fn run(self) -> Result<ExecResult>

Run the command to completion and capture the result.

A non-zero exit is data, not an error — chain ExecResult::ok_or_err when it should be one.