Struct Choice 

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

Builder for a multiple-choice prompt.

Wraps Terminal::choice with a chainable configuration API. Call Choice::ask to display the prompt and block until the user selects a valid option.

Example

use vecli::Choice;

let env = Choice::new("Select environment:", &["dev", "staging", "prod"])
    .default("dev")
    .ask();

Implementations

impl<'a> Choice<'a>

pub fn new(prompt: &'a str, choices: &'a [&'a str]) -> Self

Creates a new Choice with the given question text and choice list.

choices must not be empty. Both the default indicator and the inline choice list are shown by default.

Examples found in repository

examples/taskr.rs (line 63)

fn add(ctx: &CommandContext) {
    // Demonstrates: positionals, per-command flags, strict flags, Choice prompt
    let task = ctx
        .positionals
        .first()
        .map(String::as_str)
        .unwrap_or("<unnamed>");

    let priority = if let Some(p) = ctx.flags.get("priority") {
        p.clone()
    } else {
        // If --priority not passed, ask interactively
        Choice::new("Priority:", &["low", "medium", "high"])
            .default("medium")
            .ask()
    };

    if ctx.flags.contains_key("verbose") {
        println!(
            "[verbose] add called with task='{}', priority='{}'",
            task, priority
        );
    }

    println!("Added task '{}' with priority {}.", task, priority);
}

pub fn default(self, default: &'a str) -> Self

Sets the default choice returned when the user presses Enter with no input.

Must be a value present in choices; validated at prompt time by Terminal::choice.

Examples found in repository

examples/taskr.rs (line 64)

fn add(ctx: &CommandContext) {
    // Demonstrates: positionals, per-command flags, strict flags, Choice prompt
    let task = ctx
        .positionals
        .first()
        .map(String::as_str)
        .unwrap_or("<unnamed>");

    let priority = if let Some(p) = ctx.flags.get("priority") {
        p.clone()
    } else {
        // If --priority not passed, ask interactively
        Choice::new("Priority:", &["low", "medium", "high"])
            .default("medium")
            .ask()
    };

    if ctx.flags.contains_key("verbose") {
        println!(
            "[verbose] add called with task='{}', priority='{}'",
            task, priority
        );
    }

    println!("Added task '{}' with priority {}.", task, priority);
}

pub fn show_default(self, show: bool) -> Self

Controls whether the default choice is marked with * in the suffix list.

pub fn show_choices(self, show: bool) -> Self

Controls whether the full choice list is appended to the prompt as [a/b/c].

pub fn ask(self) -> String

Displays the prompt and returns the user’s selection as a lowercase string.

Examples found in repository

examples/taskr.rs (line 65)

fn add(ctx: &CommandContext) {
    // Demonstrates: positionals, per-command flags, strict flags, Choice prompt
    let task = ctx
        .positionals
        .first()
        .map(String::as_str)
        .unwrap_or("<unnamed>");

    let priority = if let Some(p) = ctx.flags.get("priority") {
        p.clone()
    } else {
        // If --priority not passed, ask interactively
        Choice::new("Priority:", &["low", "medium", "high"])
            .default("medium")
            .ask()
    };

    if ctx.flags.contains_key("verbose") {
        println!(
            "[verbose] add called with task='{}', priority='{}'",
            task, priority
        );
    }

    println!("Added task '{}' with priority {}.", task, priority);
}