Struct ParsedCommand 

pub struct ParsedCommand {
    pub command: Word,
    pub args: Vec<CommandArg>,
}

Structurally decomposed command with arguments in source order.

Schema-free parse: flags are identified syntactically (tokens starting with -). Without a command’s flag definitions, --flag value is ambiguous — the value appears as a separate positional. Schema-aware consumers walk args to associate values with flags they know about.

Fields

command: Word

Base command name (path stripped, env vars skipped).

args: Vec<CommandArg>

Arguments in source order — flags and positionals interleaved.

Implementations

impl ParsedCommand

pub fn from_words(words: &[Word]) -> Self

Construct a ParsedCommand directly from a word slice, avoiding a string round-trip through shlex.

• First word that is not an env assignment becomes the command (with path prefix stripped).
• Remaining words are classified as CommandArg::Flag or CommandArg::Positional using the same schema-free rules as parse_command.

pub fn subcommand(&self) -> Option<&str>

First positional argument (often a subcommand).

pub fn flags(&self) -> impl Iterator<Item = &ParsedFlag>

Iterate over all flags.

pub fn positional(&self) -> impl Iterator<Item = &str>

Iterate over all positional arguments.

pub fn has_flag(&self, name: &str) -> bool

Check if a flag is present by name (e.g., --force or -f).

pub fn to_words(&self) -> Vec<Word>

Reconstruct a flat word list.

Trait Implementations

impl Clone for ParsedCommand

fn clone(&self) -> ParsedCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedCommand

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

Formats the value using the given formatter.

impl Eq for ParsedCommand

impl PartialEq for ParsedCommand

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ParsedCommand