cli-prompt-helper

Dependency-free helpers to ask questions on stdin/stdout for small CLIs.

What you get:

• prompt_str: print a prompt and read a single line (no trailing newline)
• prompt_default: show a default and return it on empty input
• prompt_parse: parse once using FromStr (e.g. u32)
• prompt_yes_no: accept y/yes or n/no (case-insensitive), with a default

All functions block on stdin and use UTF-8. No unsafe code.

Examples

use cli_prompt_helper::{prompt_str, prompt_parse, prompt_default, prompt_yes_no};

fn main() -> Result<(), Box<dyn std::error::Error>> {
	let name = prompt_str("name: ")?;
	let age: u32 = prompt_parse("age: ")?;
	let city = prompt_default("city", "London")?;
	let proceed = prompt_yes_no("continue?", true)?;

	println!("{name} ({age}) from {city}; proceed={proceed}");
	Ok(())
}

Or run the included example:

cargo run --example basic

Why

//reduce boilerplate for tiny CLIs //avoid external dependencies for basic stdin/stdout prompts

Safety

//no unsafe code //simple, explicit control flow

License

Licensed under either of:

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.