Struct demand::Input

pub struct Input<'a> {
    pub title: String,
    pub description: String,
    pub prompt: String,
    pub placeholder: String,
    pub suggestions: Vec<&'a str>,
    pub inline: bool,
    pub password: bool,
    pub input: String,
    pub theme: &'a Theme,
    pub validation: fn(_: &str) -> Result<(), &str>,
    /* private fields */
}

Single line text input

Example

use demand::Input;

let input = Input::new("What's your name?")
  .description("We'll use this to personalize your experience.")
  .placeholder("Enter your name");
let name = input.run().expect("error running input");

Fields

title: String

The title of the input

description: String

A description to display after the title

prompt: String

A prompt to display after the description

placeholder: String

A placeholder to display in the input

suggestions: Vec<&'a str>

A list of suggestions to autocomplete from

inline: bool

Show the input inline

password: bool

Whether to mask the input

input: String

Input entered by the user

theme: &'a Theme

Colors/style of the input

validation: fn(_: &str) -> Result<(), &str>

Validation function

Implementations

impl<'a> Input<'a>

pub fn new<S: Into<String>>(title: S) -> Self

Creates a new input with the given title.

pub fn description(self, description: &str) -> Self

Sets the description of the input.

If the input is inline, it is displayed to the right of the title. Otherwise, it is displayed below the title.

pub fn inline(self, inline: bool) -> Self

Sets the inline flag of the input.

If true, the input is displayed inline with the title

pub fn password(self, password: bool) -> Self

Sets the password flag of the input.

If true, the input is masked with asterisks

pub fn placeholder(self, placeholder: &str) -> Self

Sets the placeholder of the input.

The placeholder is displayed in the input before the user enters any text

pub fn suggestions(self, suggestions: Vec<&'static str>) -> Self

Sets the suggestions of the input

pub fn prompt(self, prompt: &str) -> Self

Sets the prompt of the input.

The prompt is displayed after the title and description. If empty, the default prompt > is displayed.

pub fn theme(self, theme: &'a Theme) -> Self

Sets the theme of the input

pub fn validation(self, validation: fn(_: &str) -> Result<(), &str>) -> Self

Sets the validation for the input.

If the input is valid, the Result is Ok(()). Otherwise, the Result is Err(&str).

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

Displays the input to the user and returns the response