Struct CliApp 

pub struct CliApp { /* private fields */ }

Built CLI/REPL application

Created by CliBuilder::build(). Provides methods to run the application in different modes:

• run() - Auto-detect CLI vs REPL based on arguments
• run_cli() - Force CLI mode with specific arguments
• run_repl() - Force REPL mode

Example

use dynamic_cli::prelude::*;

let app = CliBuilder::new()
    .config_file("commands.yaml")
    .context(Box::new(MyContext::default()))
    .register_sync_handler("handler", Box::new(MyHandler))
    .build()?;

// Auto-detect mode (CLI if args provided, REPL otherwise)
app.run()

Implementations

impl CliApp

pub fn run_cli(self, args: Vec<String>) -> Result<()>

Run in CLI mode with provided arguments

Executes a single command and exits.

Arguments

• args - Command-line arguments (typically from env::args().skip(1))

Returns

• Ok(()) on successful execution
• Err(...) on parse, validation, or execution errors

Example

// Run with specific arguments
app.run_cli(vec!["command".to_string(), "arg1".to_string()])

pub fn run_repl(self) -> Result<()>

Run in REPL mode

Enters an interactive loop that continues until the user exits.

Returns

• Ok(()) when user exits normally
• Err(...) on critical errors (e.g., rustyline initialization failure)

Example

// Start interactive REPL
app.run_repl()

pub fn run(self) -> Result<()>

Run with automatic mode detection

Decides between CLI and REPL based on command-line arguments:

• If arguments provided → CLI mode
• If no arguments → REPL mode

This is the recommended method for most applications.

Returns

• Ok(()) on successful execution
• Err(...) on errors

Example

// Auto-detect: CLI if args, REPL if no args
app.run()

Trait Implementations

impl Debug for CliApp

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

Formats the value using the given formatter.