Struct App 

pub struct App<C> { /* private fields */ }

One ctl process: short-circuits, help, parsing, execution, and presentation.

Implementations

impl<C> App<C>

pub fn new(bin: impl Into<String>) -> Self

Build a CLI with pretty automatic-color output.

pub fn view(self, select: impl Fn(&C) -> View + 'static) -> Self

Select output, color, and quiet policy from the parsed CLI.

pub fn automatic_width_buffer(self, columns: u16) -> Self

Override the automatic-width buffer for help, errors, and command output. Zero disables buffering; explicit view widths remain exact.

pub fn automatic_width_buffer_envs(self, names: &'static [&'static str]) -> Self

Replace the ordered environment names for every automatic-width render. An empty slice disables environment lookup.

pub fn minimum_automatic_width(self, columns: u16) -> Self

Set the floor for automatically detected effective widths.

pub fn fallback_width(self, width: Option<u16>) -> Self

Lay out to width when no width is detected; None disables it.

pub fn styles(self, styles: RenderOptions) -> Self

Take record style, list style, and row separation from styles for help, errors, and command output.

pub fn json_layout(self, layout: JsonLayout) -> Self

Lay out JSON output as layout.

pub fn before_parse( self, hook: impl Fn(&[OsString]) -> Option<ExitCode> + 'static, ) -> Self

Add an ordered pre-parse short-circuit, such as dynamic completion.

pub fn mounted_as(self, task: impl Into<String>) -> Self

Expose a mise Usage spec under a mounted task name.

pub fn usage_spec( self, render: impl Fn(Command, &str) -> String + 'static, ) -> Self

Customize the mounted Usage document while keeping App’s short-circuit and stream ownership. The callback receives the declared Clap graph and the requested mounted binary name.

impl<C> App<C>

where C: Parser + CommandFactory,

pub fn run<T>(self, execute: impl FnOnce(C) -> Result<T>) -> ExitCode

where T: Present,

Run against process argv.

pub fn run_from<T>( self, args: impl IntoIterator<Item = impl Into<OsString>>, execute: impl FnOnce(C) -> Result<T>, ) -> ExitCode

where T: Present,

Run against explicit argv. The first item is the binary name.