Struct CargoCommandBuilder 

pub struct CargoCommandBuilder {

    pub target_name: String,
    pub manifest_path: PathBuf,
    pub args: Vec<String>,
    pub subcommand: String,
    pub pid: Option<u32>,
    pub alternate_cmd: Option<String>,
    pub execution_dir: Option<PathBuf>,
    pub suppressed_flags: HashSet<String>,
    pub stdout_dispatcher: Option<Arc<EventDispatcher>>,
    pub stderr_dispatcher: Option<Arc<EventDispatcher>>,
    pub progress_dispatcher: Option<Arc<EventDispatcher>>,
    pub stage_dispatcher: Option<Arc<EventDispatcher>>,
    pub terminal_error_flag: Arc<Mutex<bool>>,
    pub sender: Option<Arc<Mutex<Sender<TerminalError>>>>,
    pub diagnostics: Arc<Mutex<Vec<CargoDiagnostic>>>,
    pub is_filter: bool,
    pub use_cache: bool,
    pub default_binary_is_runner: bool,
    pub be_silent: bool,
    pub detached: bool,
    pub time_limit: Option<u32>,
    pub detached_hold: Option<u32>,
    pub detached_delay: Option<u32>,
    pub cwd_wsr: bool,
}

A builder that constructs a Cargo command for a given target.

Fields

target_name: String

manifest_path: PathBuf

args: Vec<String>

subcommand: String

pid: Option<u32>

alternate_cmd: Option<String>

execution_dir: Option<PathBuf>

suppressed_flags: HashSet<String>

stdout_dispatcher: Option<Arc<EventDispatcher>>

stderr_dispatcher: Option<Arc<EventDispatcher>>

progress_dispatcher: Option<Arc<EventDispatcher>>

stage_dispatcher: Option<Arc<EventDispatcher>>

terminal_error_flag: Arc<Mutex<bool>>

sender: Option<Arc<Mutex<Sender<TerminalError>>>>

diagnostics: Arc<Mutex<Vec<CargoDiagnostic>>>

is_filter: bool

use_cache: bool

default_binary_is_runner: bool

be_silent: bool

detached: bool

time_limit: Option<u32>

detached_hold: Option<u32>

detached_delay: Option<u32>

cwd_wsr: bool

Implementations

impl CargoCommandBuilder

pub fn new( target_name: &str, manifest: &PathBuf, subcommand: &str, is_filter: bool, use_cache: bool, default_binary_is_runner: bool, be_silent: bool, detached: bool, cwd_wsr: bool, ) -> Self

Creates a new, empty builder.

pub fn run<F>(self: Arc<Self>, on_spawn: F) -> Result<u32>

where F: FnOnce(u32, Arc<Mutex<CargoProcessHandle>>),

pub fn wait(self: Arc<Self>, pid: Option<u32>) -> Result<CargoProcessResult>

pub fn with_target(self, target: &CargoTarget) -> Self

Configure the command based on the target kind.

pub fn with_cli(self, cli: &Cli) -> Self

Configure the command using CLI options.

pub fn with_required_features( self, manifest: &PathBuf, target: &CargoTarget, ) -> Self

Append required features based on the manifest, target kind, and name. This method queries your manifest helper function and, if features are found, appends “–features” and the feature list.

pub fn with_extra_args(self, extra: &[String]) -> Self

Appends extra arguments to the command.

pub fn build(self) -> Vec<String>

Builds the final vector of command-line arguments.

pub fn is_compiler_target(&self) -> bool

pub fn injected_args(&self) -> (String, Vec<String>)

pub fn print_command(&self)

pub fn build_command(&self) -> Command

builds a std::process::Command.

pub fn capture_output(&self) -> Result<String>

Runs the command and returns everything it printed (stdout + stderr), regardless of exit status.

Trait Implementations

impl Clone for CargoCommandBuilder

fn clone(&self) -> CargoCommandBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CargoCommandBuilder

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

Formats the value using the given formatter.

impl Default for CargoCommandBuilder

fn default() -> Self

Returns the “default value” for a type.

impl Display for CargoCommandBuilder

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

Formats the value using the given formatter.