Struct Resolver 

pub struct Resolver<'a> { /* private fields */ }

Resolves a string token to a Command in a slice, supporting aliases, spellings, and unambiguous prefix matching.

Create a resolver by passing a slice of commands to Resolver::new, then call Resolver::resolve with a raw string token. The returned reference borrows from the original command slice (lifetime 'a).

Examples

let cmds = vec![
    Command::builder("deploy").alias("d").build().unwrap(),
    Command::builder("delete").build().unwrap(),
];
let resolver = Resolver::new(&cmds);

// Exact match via alias
assert_eq!(resolver.resolve("d").unwrap().canonical, "deploy");
// Prefix "del" is unambiguous
assert_eq!(resolver.resolve("del").unwrap().canonical, "delete");

Implementations

impl<'a> Resolver<'a>

pub fn new(commands: &'a [Command]) -> Self

Create a new Resolver over the given command slice.

Arguments

• commands — The slice of commands to resolve against. The lifetime 'a is propagated to the references returned by Resolver::resolve.

pub fn resolve(&self, input: &str) -> Result<&'a Command, ResolveError>

Resolve input against the registered commands.

Resolution order:

1. Normalize: trim + lowercase.
2. Exact match across canonical/aliases/spellings → return immediately.
3. Prefix match → return if exactly one command matches; else Ambiguous.
4. No match → Unknown.

Arguments

• input — The raw string to resolve (trimming and lowercasing are applied internally).

Errors

• ResolveError::Unknown — no command matched input exactly or as a prefix. The suggestions field contains up to three canonical names whose edit distance from input is ≤ 2, or which contain input as a substring. May be empty if no close matches exist.
• ResolveError::Ambiguous — input is a prefix of more than one command; the candidates field lists their canonical names.

Examples

let cmds = vec![Command::builder("get").build().unwrap()];
let resolver = Resolver::new(&cmds);

assert_eq!(resolver.resolve("get").unwrap().canonical, "get");
assert_eq!(resolver.resolve("GET").unwrap().canonical, "get"); // case-insensitive
assert!(matches!(resolver.resolve("xyz"), Err(ResolveError::Unknown { .. })));