Struct Cmd

pub struct Cmd<'a, T: for<'enc> Utf8Encoding<'enc>> { /* private fields */ }

A command builder.

Implementations

impl<'a, T: for<'enc> Utf8Encoding<'enc>> Cmd<'a, T>

pub fn arg<P: AsRef<str>>(self, arg: P) -> Self

Adds an argument to the command.

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

where I: IntoIterator, I::Item: AsRef<str>,

Adds multiple arguments to the command.

pub fn env(self, key: impl AsRef<str>, val: impl AsRef<str>) -> Self

Sets an environment variable for the command.

pub fn envs<I, K, V>(self, vars: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: AsRef<str>, V: AsRef<str>,

Sets multiple environment variables for the command.

pub fn env_remove(self, key: impl AsRef<str>) -> Self

Removes an environment variable for the command.

pub fn env_clear(self) -> Self

Clears the environment for the command.

pub fn ignore_status(self) -> Self

Ignores the status of the command.

By default, the command will fail if the exit code is non-zero.

pub fn ignore_stdout(self) -> Self

Ignores the stdout of the command.

By default, the command’s stdout will be captured or printed to stdout.

pub fn ignore_stderr(self) -> Self

Ignores the stderr of the command.

By default, the command’s stderr will be captured or printed to stderr.

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

Sets contents to be written to the command’s stdin.

pub async fn run(&self) -> Result<()>

Runs the command and waits for it to complete.

By default, this will fail if the command’s exit code is non-zero.

By default, the command’s stdout and stderr will be captured and traced.

pub async fn read(&self) -> Result<String>

Runs the command and waits for it to complete, returning the stdout.

By default, this will fail if the command’s exit code is non-zero.

By default, the command’s stderr will be captured and traced.

pub async fn read_stderr(&self) -> Result<String>

Runs the command and waits for it to complete, returning the stderr.

By default, this will fail if the command’s exit code is non-zero.

By default, the command’s stdout will be captured and traced.

pub async fn output(&self) -> Result<Output>

Runs the command and waits for it to complete, returning the stdout and stderr.

By default, this will fail if the command’s exit code is non-zero.