Struct command_run::Command

pub struct Command {
    pub program: PathBuf,
    pub args: Vec<OsString>,
    pub dir: Option<PathBuf>,
    pub log_command: bool,
    pub print_command: bool,
    pub check: bool,
    pub capture: bool,
    pub clear_env: bool,
    pub env: HashMap<OsString, OsString>,
}

A command to run in a subprocess and options for how it is run.

Fields

program: PathBuf

Program path.

The path can be just a file name, in which case the $PATH is searched.

args: Vec<OsString>

Arguments passed to the program.

dir: Option<PathBuf>

Directory from which to run the program.

If not set (the default), the current working directory is used.

log_command: bool

If true, log the command before running it. The default is false. This does nothing if the "logging" feature is not enabled.

print_command: bool

If true (the default), print the command to stdout before running it.

check: bool

If true (the default), check if the command exited successfully and return an error if not.

capture: bool

If true (the default), capture the stdout and stderr of the command.

clear_env: bool

If false (the default), inherit environment variables from the current process.

env: HashMap<OsString, OsString>

Add or update environment variables in the child process.

Implementations

impl Command

pub fn new<S: AsRef<OsStr>>(program: S) -> Command

Make a new Command with the given program.

All other fields are set to the defaults.

pub fn with_args<I, S1, S2>(program: S1, args: I) -> Command where
    S1: AsRef<OsStr>,
    S2: AsRef<OsStr>,
    I: IntoIterator<Item = S2>, 

Make a new Command with the given program and args.

All other fields are set to the defaults.

pub fn add_arg<S: AsRef<OsStr>>(&mut self, arg: S) -> &mut Self

Append a single argument.

pub fn add_args<I, S>(&mut self, args: I) -> &mut Self where
    S: AsRef<OsStr>,
    I: IntoIterator<Item = S>, 

Append multiple arguments.

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

Run the command.

If capture is true, the command's output (stdout and stderr) is returned along with the status. If not, the stdout and stderr are empty.

If the command fails to start an error is returned. If check is set, an error is also returned if the command exits non-zero or due to a signal.

If log_command and/or print_command is true then the command line is logged and/or printed before running it. If the command fails the error is not logged or printed, but the resulting error type implements Display and can be used for this purpose.

pub fn command_line(&self) -> OsString

Format as a space-separated command line.

pub fn command_line_lossy(&self) -> String

Format as a space-separated command line.

The program path and the arguments are converted to strings with String::from_utf8_lossy.

If any component contains characters that are not ASCII alphanumeric, the component is quoted with ' (single quotes). This is both too aggressive (unnecessarily quoting things that don't need to be quoted) and incorrect (e.g. a single quote will itself be quoted with a single quote). This method is mostly intended for logging though, and it should work reasonably well for that.

Trait Implementations

impl Clone for Command

fn clone(&self) -> Command

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Command

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

Formats the value using the given formatter.

impl Default for Command

fn default() -> Self

Returns the "default value" for a type.

impl Eq for Command

impl<'_> From<&'_ Command> for Command

fn from(cmd: &Command) -> Self

Performs the conversion.

impl PartialEq<Command> for Command

fn eq(&self, other: &Command) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Command) -> bool

This method tests for !=.

impl StructuralEq for Command

impl StructuralPartialEq for Command