Struct CommandSet 

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

The registered commands, collected once.

Collecting is not free and it is not idempotent-looking: it runs every plugin’s commands() constructor, builds a clap::Command per command (help prose and all), and PRINTS the built-in-shadow warning. Doing that two or three times per invocation — once for the readiness check, once to dispatch, once more for the help catalog — meant a user with a shadowing command saw the same scary warning twice, which reads like two problems.

So: collect once, then ask it questions.

Implementations

impl<'a> CommandSet<'a>

pub fn collect( app_commands: &'a [Box<dyn PluginCommand>], plugins: &'a [Box<dyn Plugin>], reserved: &[&str], ) -> Self

Collect the app’s own commands followed by every plugin’s, dropping any that shadow a framework built-in named in reserved.

pub fn is_empty(&self) -> bool

Nothing registered — the caller handles everything itself.

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

Does the command named name need a live app? None if nothing registered that name (the caller’s own built-in rules then decide).

pub fn catalog(&self) -> Vec<(String, Option<String>)>

(name, about) for every registered command — the listing half of umbral help. Shares this collection with dispatch, so the help can never advertise a command that would not actually run.

pub async fn dispatch<I, T>(&self, args: I) -> Result<DispatchOutcome, CliError>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Route args to the matching command.