Struct CommandSpec 

pub struct CommandSpec {
    pub program: String,
    pub args: Vec<String>,
}

What: A ready-to-run command as program plus argument vector.

Inputs:

• Produced by the install module command builders.

Output:

• Can be spawned directly (to_command()) or rendered for display (to_shell_string()).

Details:

• Argv-style representation avoids shell interpretation entirely when spawned directly, eliminating quoting bugs.
• arch-toolkit never executes commands itself; callers decide whether to run, display (dry run), or embed the command.

Fields

program: String

The program to execute (e.g., pacman, paru, sudo).

args: Vec<String>

Arguments passed to the program, unquoted (argv semantics).

Implementations

impl CommandSpec

pub fn new( program: impl Into<String>, args: impl IntoIterator<Item = impl Into<String>>, ) -> Self

What: Create a new command spec from a program and arguments.

Inputs:

• program: Program name or path.
• args: Argument list (unquoted).

Output: CommandSpec instance.

Details: Convenience constructor accepting anything convertible to String.

pub fn to_shell_string(&self) -> String

What: Render this command as a properly quoted POSIX shell string.

Inputs: None.

Output: Shell-safe string like sudo pacman -S --needed --noconfirm 'ripgrep'.

Details:

• Arguments containing anything outside [A-Za-z0-9@%^_+=:,./-] are single-quoted with embedded quotes escaped.
• Intended for display (dry runs) and for passing to bash -c in terminal-spawning callers.

pub fn to_command(&self) -> Command

What: Convert this spec into a std::process::Command ready to spawn.

Inputs: None.

Output: Configured std::process::Command (not yet spawned).

Details:

• No shell is involved; arguments are passed verbatim to the OS.
• Callers remain responsible for spawning and privilege context.

Trait Implementations

impl Clone for CommandSpec

fn clone(&self) -> CommandSpec

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<'de> Deserialize<'de> for CommandSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display 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: &CommandSpec) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CommandSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CommandSpec