5 releases
0.2.5 | Oct 23, 2024 |
---|---|
0.2.3 | Oct 23, 2024 |
0.2.2 | Oct 23, 2024 |
0.2.1 | Oct 23, 2024 |
0.2.0 | Oct 23, 2024 |
#68 in Parser tooling
383 downloads per month
11KB
206 lines
CInputs
CInputs is a Rust library designed for easy input parsing with built-in constraints. It provides functionality for reading user input and applying various constraints to ensure the validity of that input.
This is the successor to constrained_inputs crate
Features
- Simple Input Parsing: Easily read user input as different types (e.g., integers, strings).
- Constraint Application: Apply constraints to inputs, such as minimum and maximum values for numbers, or required characters in strings.
- Custom Error Handling: Use detailed error messages to handle validation failures gracefully.
Example Usage
Here is a quick example of using input() and cinput().
use cinputs::prelude::*;
fn main() {
println!("What is your favorite integer?");
let favorite_integer: isize = input().unwrap();
println!("Great Choice! {}", favorite_integer);
println!("What is your age?");
let num_constraint = NumberConstraint {
min_value: 0.0,
max_value: 120.0,
};
match cinput::<u8, _>(num_constraint) {
Ok(age) => println!("You really don't look {}.", age),
Err(err) => match err.kind {
error::ErrorKind::ValidationError => println!("Thats not possible."),
_ => eprintln!("{}", err),
},
}
println!("What is the best name that contains a J?");
let string_constraint = StringConstraint {
exclude_char: Vec::new(),
include_char: vec!['J'],
max_len: usize::MAX,
min_len: usize::MIN,
};
match cinput::<String, _>(string_constraint) {
Ok(name) => print!("Great choice of name, {} is very nice!", name),
Err(err) => match err.kind {
error::ErrorKind::ValidationError => {
println!("How did you fail to think of a name containing J!?!?")
}
_ => eprintln!("{}", err),
},
}
}
Other Features
- Input Parsing Using a BufReader Reading input through a more general buffer reader
- Constraint Trait Implement custom traits on your types
- Input Parsing Using String Directly parse strings and apply constraint to them
Dependencies
~10KB