Struct slaps::Slaps

pub struct Slaps<'a, 'b> { /* fields omitted */ }

Interactive shell mode using a clap/structopt configuration.

Implementations

impl<'a, 'b> Slaps<'a, 'b>

#[must_use]pub fn with_name(name: &str) -> Self

Creates a new interactive app using the default configuration.

Examples

use slaps::Slaps;

let slaps = Slaps::with_name("slaps");

#[must_use]pub fn with_name_and_config(name: &str, config: Config<'b>) -> Slaps<'a, 'b>

Creates a new interactive app with the given Config.

Examples

use slaps::{Config, ColorMode, Slaps};

let slaps = Slaps::with_name_and_config("slaps", Config::default()
    .color_mode(ColorMode::Disabled));

#[must_use]pub fn subcommand<T: 'b>(self, command: App<'a, 'b>, handler: T) -> Self where
    T: Fn(&ArgMatches) -> Result<(), ExecutionError> + Send + Sync, 

Registers a Clap subcommand configuration with Slaps.

Examples

use clap::App;
use slaps::Slaps;

let slaps = Slaps::with_name("slaps")
    .subcommand(App::new("slap"), |matches| {println!("{:?}", matches); Ok(())} );

pub fn prompt_line(&self, prompt: Option<&str>) -> Result<String, ReadlineError>

Prompts the user for a String using the default prompt.

If prompt is None, uses the default from the Config.

Errors

May return a ReadlineError from the internal readline implementation.

pub fn prompt_password(
    &self,
    prompt: Option<&str>
) -> Result<String, ReadlineError>

Prompts the user for a password.

If prompt is None, uses the default from the Config.

Errors

May return a ReadlineError from the internal readline implementation.

pub fn get_matches<T: AsRef<str>>(
    &mut self,
    input: T
) -> Result<ArgMatches, Error>

Parses a string directly into a clap::ArgMatches object.

Errors

• MismatchedQuote parsing failed due to mismatched quotation marks within the input.

Examples

use clap::{App, Arg};
use slaps::Slaps;

let command = App::new("slaps").arg(Arg::with_name("that").long("that").takes_value(true));
let mut slaps = Slaps::with_name("slaps").subcommand(command, |args| Ok(()));
let matches = slaps.get_matches("slaps --that arg").unwrap();

assert_eq!(matches.subcommand_name(), Some("slaps"));
assert_eq!(matches.subcommand_matches("slaps").unwrap().value_of("that"), Some("arg"));

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

Starts the main interactive loop, prompting the user for input repeatedly.

Errors

Will return an error when it fails to read more input.

Trait Implementations

impl<'a, 'b> Debug for Slaps<'a, 'b>

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

Formats the value using the given formatter.