Struct Builder 

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

A catalog under construction.

Implementations

impl<'a> Builder<'a>

pub fn root(self, spec: Spec) -> Self

Attach a supplied plugin spec beneath the static root.

pub fn under(self, parent: impl Into<String>, spec: Spec) -> Self

Attach a supplied plugin spec beneath a static command path.

Components may use visible or hidden static aliases; construction stores the canonical path. The parent must declare an external-subcommand catch-all.

pub const fn completions(self, overlays: &'a [CompletionOverlay<'a>]) -> Self

Register the host’s own completion callbacks, as usage_argv::complete::App::completions would.

Words before a runtime command are the host’s, and the host’s engine answers for them — so whatever it was given, it keeps.

pub const fn project(self, command_path: &'a str) -> Self

Answer as though this command path came after argv0, for a multicall binary.

The same projection usage_argv::complete::App::project applies, applied once, before anything asks where the words are.

pub fn build(self) -> Result<Catalog<'a>, Error>

Validate every parent and name, and finish the catalog.

What is checked here is what the static tables can answer on their own: that the parent exists, that it invited runtime commands, and that no name collides. Assembling the merged tree is left to Catalog::app — dispatching a plugin command never needs it.

Trait Implementations

impl<'a> Debug for Builder<'a>

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

Formats the value using the given formatter.