Struct ParsedArgs 

pub struct ParsedArgs(/* private fields */);

Parsed command arguments, passed to crate::executor::CommandHandler::execute and crate::executor::AsyncCommandHandler::execute

Wraps the output of CliParser::parse_typed, exposing typed accessors so handlers never need to match on ParsedValue directly. Introduced in v0.6.0 (#39) to replace &HashMap<String, String>, which could not represent repeatable options.

Lives directly in parser rather than nested under cli_parser: it is the shared type consumed by every handler regardless of dispatch path (CLI via CliParser::parse_typed_segment, or REPL via ParsedArgs::from_scalars) — not a CLI-specific detail.

Example

use dynamic_cli::parser::ParsedArgs;

let args = ParsedArgs::from_scalars(
    [("name".to_string(), "World".to_string())].into_iter().collect(),
);
assert_eq!(args.get_scalar("name"), Some("World"));
assert_eq!(args.get_scalar("missing"), None);

Implementations

impl ParsedArgs

pub fn new(values: HashMap<String, ParsedValue>) -> Self

Wrap an already-typed result, as produced by CliParser::parse_typed

pub fn from_scalars(values: HashMap<String, String>) -> Self

Build a scalar-only ParsedArgs from a plain HashMap<String, String>

Every entry becomes a ParsedValue::Scalar; there is no way to represent ParsedValue::Repeated through this constructor.

Used by the REPL dispatch path (interface/repl.rs), which relies on crate::parser::repl_parser::ReplParser::parse_line, which only produces scalar values: repeatable options have no use case at the interactive prompt so far, so that path was left scalar-only when they were introduced. Scripts run with CliInterface::run_script go through the CLI dispatch path and keep repeatable options; the REPL :load directive replays its lines through this scalar path.

pub fn get_scalar(&self, name: &str) -> Option<&str>

Get a scalar argument or option value by name

Returns None both when the name is absent and when it is present but holds a ParsedValue::Repeated value — mirroring HashMap::get’s silent-on-absence semantics rather than distinguishing “wrong kind” from “missing”.

pub fn get_repeated(&self, name: &str) -> Option<&[OptionOccurrence]>

Get every occurrence of a repeatable option by name

Returns None both when the name is absent and when it is present but holds a ParsedValue::Scalar value — same silent-on-absence contract as Self::get_scalar.

pub fn to_scalar_map(&self) -> HashMap<String, String>

Collapse back down to a scalar-only HashMap<String, String>

Every ParsedValue::Scalar entry is kept as-is; any ParsedValue::Repeated entry is silently dropped, for the same reason as Self::from_scalars: nothing on the scalar side consumes repeatable options yet. Used at the boundary of subsystems that predate repeatable options (v0.6.0) and have not been extended to understand repeatable options, e.g. the WASM plugin ABI (WasmHandler, in plugin::wasm), which serializes arguments as flat HashMap<String, String> to the guest.

Trait Implementations

impl Clone for ParsedArgs

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 ParsedArgs

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

Formats the value using the given formatter.

impl Default for ParsedArgs

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for ParsedArgs

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ParsedArgs