inquire 0.2.0

inquire is a library for building interactive prompts on terminals
Documentation

inquire is a library for building interactive prompts on terminals.

It provides several different prompts in order to interactively ask the user for information via the CLI. With inquire, you can use:

  • Text to get text input from the user, with built-in auto-completion support;
  • Editor* to get longer text inputs by opening a text editor for the user;
  • DateSelect* to get a date input from the user, selected via an interactive calendar;
  • Select to ask the user to select one option from a given list;
  • MultiSelect to ask the user to select an arbitrary number of options from a given list;
  • Confirm for simple yes/no confirmation prompts;
  • CustomType for text prompts that you would like to parse to a custom type, such as numbers or UUIDs;
  • Password for secretive text prompts.

Check out the GitHub repository to see demos of what you can do with inquire.

Features

  • Cross-platform, supporting UNIX and Windows terminals (thanks to crossterm);
  • Several kinds of prompts to suit your needs;
  • Standardized error handling (thanks to thiserror);
  • Support for fine-grained configuration for each prompt type, allowing you to customize:
  • Default values;
  • Input validators and formatters;
  • Help messages;
  • Auto-completion for Text prompts;
  • Custom list filters for Select and MultiSelect prompts;
  • Custom parsers for Confirm and CustomType prompts;
  • Custom extensions for files created by Editor prompts;
  • and many others!

* Date-related features are available by enabling the date feature.

Simple Example

use inquire::{Text, validator::StringValidator};

fn main() {
let validator: StringValidator = &|input| if input.chars().count() > 140 {
Err(String::from("You're only allowed 140 characters."))
} else {
Ok(())
};

let status = Text::new("What are you thinking about?")
.with_validator(validator)
.prompt();

match status {
Ok(status) => println!("Your status is being published..."),
Err(err) => println!("Error while publishing your status: {}", err),
}
}