Struct Cmd

pub struct Cmd<'a> { /* private fields */ }

A builder object for constructing a subprocess.

A Cmd is usually created with the cmd! macro. The command exists within a context of a Shell and uses its working directory and environment.

Example

use xshell::{Shell, cmd};

let sh = Shell::new()?;

let branch = "main";
let cmd = cmd!(sh, "git switch {branch}").quiet().run()?;

Implementations

impl<'a> Cmd<'a>

pub fn arg<P>(self, arg: P) -> Cmd<'a>

where P: AsRef<OsStr>,

Adds an argument to this commands.

pub fn args<I>(self, args: I) -> Cmd<'a>

where I: IntoIterator, <I as IntoIterator>::Item: AsRef<OsStr>,

Adds all of the arguments to this command.

pub fn env<K, V>(self, key: K, val: V) -> Cmd<'a>

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

Overrides the value of the environmental variable for this command.

pub fn envs<I, K, V>(self, vars: I) -> Cmd<'a>

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

Overrides the values of specified environmental variables for this command.

pub fn env_remove<K>(self, key: K) -> Cmd<'a>

where K: AsRef<OsStr>,

Removes the environment variable from this command.

pub fn env_clear(self) -> Cmd<'a>

Removes all of the environment variables from this command.

pub fn ignore_status(self) -> Cmd<'a>

Don’t return an error if command the command exits with non-zero status.

By default, non-zero exit status is considered an error.

pub fn set_ignore_status(&mut self, yes: bool)

Controls whether non-zero exit status is considered an error.

pub fn quiet(self) -> Cmd<'a>

Don’t echo the command itself to stderr.

By default, the command itself will be printed to stderr when executed via Cmd::run.

pub fn set_quiet(&mut self, yes: bool)

Controls whether the command itself is printed to stderr.

pub fn secret(self) -> Cmd<'a>

Marks the command as secret.

If a command is secret, it echoes <secret> instead of the program and its arguments, even in error messages.

pub fn set_secret(&mut self, yes: bool)

Controls whether the command is secret.

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

Pass the given slice to the standard input of the spawned process.

pub fn ignore_stdout(self) -> Cmd<'a>

Ignores the standard output stream of the process.

This is equivalent to redirecting stdout to /dev/null. By default, the stdout is inherited or captured.

pub fn set_ignore_stdout(&mut self, yes: bool)

Controls whether the standard output is ignored.

pub fn ignore_stderr(self) -> Cmd<'a>

Ignores the standard output stream of the process.

This is equivalent redirecting stderr to /dev/null. By default, the stderr is inherited or captured.

pub fn set_ignore_stderr(&mut self, yes: bool)

Controls whether the standard error is ignored.

pub fn run(&self) -> Result<(), Error>

Runs the command.

By default the command itself is echoed to stderr, its standard streams are inherited, and non-zero return code is considered an error. These behaviors can be overridden by using various builder methods of the Cmd.

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

Run the command and return its stdout as a string. Any trailing newline or carriage return will be trimmed.

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

Run the command and return its stderr as a string. Any trailing newline or carriage return will be trimmed.

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

Run the command and return its output.

Trait Implementations

impl<'a> Debug for Cmd<'a>

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

Formats the value using the given formatter.

impl Display for Cmd<'_>

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

Formats the value using the given formatter.

impl From<Cmd<'_>> for Command

fn from(cmd: Cmd<'_>) -> Command

Converts to this type from the input type.