Struct HandlerCli 

pub struct HandlerCli { /* private fields */ }

A registry-based Cli implementation that dispatches command lines to registered Handlers keyed by their verb.

Implementations

impl HandlerCli

pub fn new() -> Self

Creates a new, empty handler registry.

pub fn collect(&self) -> Vec<Arc<dyn Handler>>

Returns all currently registered handlers.

pub fn get(&self, name: &str) -> Option<Arc<dyn Handler>>

Returns the handler registered under the given verb, if any.

pub fn register<T, H>(&self, ctx: &Arc<T>, handler: H)

where T: Context + Sized, H: Handler + Send + Sync + 'static,

Registers a handler by value under its verb, if its condition is met in the given context.

pub fn register_arc<T, H>(&self, ctx: &Arc<T>, handler: &Arc<H>)

where T: Context + Sized, H: Handler + Send + Sync + 'static,

Registers an already-Arc-wrapped handler under its verb, if its condition is met in the given context.

pub fn unregister(&self, name: &str) -> Option<Arc<dyn Handler>>

Removes and returns the handler registered under the given verb, if any.

pub fn clear(&self) -> Result<()>

Removes all registered handlers.

pub async fn start<T>(&self, ctx: &Arc<T>) -> Result<()>

where T: Context + Sized,

Invokes Handler::start on every registered handler.

pub async fn stop<T>(&self, ctx: &Arc<T>) -> Result<()>

where T: Context + Sized,

Invokes the stop lifecycle on every registered handler.

pub async fn execute<T>(&self, ctx: &Arc<T>, cmd: &str) -> Result<()>

where T: Context + Sized,

Parses the command line and dispatches it to the matching handler, returning Error::CommandNotFound if no handler matches the verb.

pub async fn complete<T>( &self, ctx: &Arc<T>, cmd: &str, ) -> Result<Option<Vec<String>>>

where T: Context + Sized,

Returns completion candidates for the command line by delegating to the matching handler, or Error::CommandNotFound if no handler matches.

Trait Implementations

impl Default for HandlerCli

fn default() -> HandlerCli

Returns the “default value” for a type.