Struct CommandSpec 

pub struct CommandSpec {
    pub program: OsString,
    pub args: Vec<OsString>,
    pub cwd: Option<PathBuf>,
}

One command waiting to be executed, pure data – a plugin only describes “what to run” and the actual spawn is done by the host, so stdio, environment, and exit-code handling have exactly one implementation. Construction is a consuming chain (self -> Self), so it can produce a value directly:

let spec = CommandSpec::new("cargo").arg("add").args(args.iter()).cwd("/somewhere");

Fields

program: OsString

Executable. It may be a bare name (resolved on PATH), an absolute path, or a path relative to this spec’s cwd – which is the project root when the spec does not name one. On Windows a bare name resolves through PATHEXT, so pnpm finds pnpm.cmd, and the host starts a batch file the way the platform requires.

args: Vec<OsString>

Arguments, in order.

cwd: Option<PathBuf>

Working-directory override. None = use the project root given by the host.

Implementations

impl CommandSpec

pub fn new(program: impl Into<OsString>) -> Self

Specify the executable.

pub fn arg(self, arg: impl Into<OsString>) -> Self

Append one argument.

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

where I: IntoIterator<Item = S>, S: Into<OsString>,

Append a batch of arguments; args.iter() can be passed straight in and stays lossless (&OsString: Into<OsString>), unlike String, which would corrupt non-UTF-8 arguments on Unix.

pub fn cwd(self, dir: impl Into<PathBuf>) -> Self

Override the working directory.

Trait Implementations

impl Clone for CommandSpec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandSpec

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

Formats the value using the given formatter.

impl Eq for CommandSpec

impl PartialEq for CommandSpec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CommandSpec