Struct CommandBuilder

pub struct CommandBuilder {
    pub program: PathBuf,
    pub args: Vec<OsString>,
    pub out_dir_flag: Option<OsString>,
    pub input_file_flag: Option<OsString>,
    pub envs: Vec<(OsString, Option<OsString>)>,
    pub cfg_flag: Option<OsString>,
}

A command, its args and its environment. Used for the main command, the dependency builder and the cfg-reader.

Fields

program: PathBuf

Path to the binary.

args: Vec<OsString>

Arguments to the binary.

out_dir_flag: Option<OsString>

A flag to prefix before the path to where output files should be written.

input_file_flag: Option<OsString>

A flag to set as the last flag in the command, so the build caller can append the filename themselves.

envs: Vec<(OsString, Option<OsString>)>

Environment variables passed to the binary that is executed. The environment variable is removed if the second tuple field is None

cfg_flag: Option<OsString>

A flag to add in order to make the command print the cfgs it supports

Implementations

impl CommandBuilder

pub fn cargo() -> Self

Uses the CARGO env var or just a program named cargo and the argument build.

pub fn rustc() -> Self

Uses the RUSTC env var or just a program named rustc and the argument --error-format=json.

Take care to only append unless you actually meant to overwrite the defaults. Overwriting the defaults may make //~ ERROR style comments stop working.

pub fn cmd(cmd: impl Into<PathBuf>) -> Self

Build a CommandBuilder for a command without any argumemnts. You can still add arguments later.

pub fn display(&self) -> impl Display + '_

Render the command like you’d use it on a command line.

pub fn build(&self, out_dir: &Path) -> Command

Create a command with the given settings.

Trait Implementations

impl Clone for CommandBuilder

fn clone(&self) -> CommandBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CommandBuilder

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

Formats the value using the given formatter.