#read-line #interactive #toolkit #building #command-line #own #input

yanked promptio

A toolkit for building your own interactive command-line tools

0.1.0 May 1, 2022

#62 in #read-line

MIT license

67KB
1.5K SLoC

promptio

.github/workflows/promptio.yml

A toolkit for building your own interactive command-line tools in Rust, utilizing crossterm.

Getting Started

Put the package in your Cargo.toml.

[dependencies]
promptio = "0.1.0"

Features

  • Readline
    • Provide the lines to receive and display user inputs
    • Masking, switch insert/overwrite modes, and suggestions
  • Select
    • Provides the selectbox to choose the items from
  • Customization
    • Enable to define your own command-line applications.
    • See examples/advanced for more concrete examples.

Examples

Readline:

use promptio::{build::Builder, readline, Result};

fn main() -> Result<()> {
    let mut p = readline::Builder::default().build()?;
    loop {
        let (line, exit_code) = p.run()?;
        if exit_code == 0 {
            println!("result: {:?}", line);
        } else {
            return Ok(());
        }
    }
}

Select:

use crossterm::style;
use promptio::{
    build::Builder,
    edit::{Register, SelectBox},
    select, Result,
};

fn main() -> Result<()> {
    let mut selectbox = Box::new(SelectBox::default());
    selectbox.register_all((0..100).map(|v| v.to_string()).collect::<Vec<String>>());
    let mut p = select::Builder::default()
        .title("Q: What number do you like?")
        .title_color(style::Color::DarkGreen)
        .selectbox(selectbox)
        .build()?;
    let (line, exit_code) = p.run()?;
    if exit_code == 0 {
        println!("result: {:?}", line)
    }
    Ok(())
}

Dependencies

~2–12MB
~77K SLoC