Struct Cmd

pub struct Cmd { /* private fields */ }

Clone-able variant of std::process::Command with some build specific helper methods

Cloning allows configuring commands with some common arguments and then invoking it with additional arguments/env vars at different places inside the script.

Method of this type are mirroring those of std::process::Command with addition of run and run_result commands for easier use inside of build sript.

Implementations

impl Cmd

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

Constructs a new Cmd for launching the executable at path program

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

Adds an argument to the list of execution arguments

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

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

Adds multiple arguments to the list of execution arguments

pub fn env<K: AsRef<OsStr>, V: AsRef<OsStr>>(self, env: K, val: V) -> Self

Sets an environment variable

pub fn output(&self) -> Output

Run the command and return it’s output.

This is convienece method for calling std::process::Command::output() method on command instance retrieved by command method

pub fn run(&self)

Run the command and exit the build with informative panic message if execution fails.

This is convienece method for calling std::process::Command::status() method on command instance retrieved by command method

pub fn run_result(&self) -> Result<ExitStatus>

Run the command and return it’s status.

This is convienece method for calling std::process::Command::status() method on command instance retrieved by command method

pub fn command(&self) -> Command

Build the std::process::Command with args and environment variables set up by methods on this Cmd instance.

Trait Implementations

impl Clone for Cmd

fn clone(&self) -> Cmd

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cmd

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

Formats the value using the given formatter.