8 releases
0.1.11 | Dec 10, 2022 |
---|---|
0.1.10 | Dec 10, 2022 |
#31 in #clap-parser
532 downloads per month
Used in 2 crates
47KB
706 lines
Macros for clap argument value_parse
Macros to add duration value parsers for clap arguments, where the fields are compile-time checked
1. duration_range_value_parse
To be used as the value_parse value on a clap arg
2. assign_duration_range_validator
Create a constant to be used on multiple arguments of a clap arg
3. duration_range_validator
Create a DurationHumanValidator with compile-time checking
Macro duration_range_value_parse
use clap::Parser;
use clap_duration::duration_range_value_parse;
use duration_human::{DurationHuman, DurationHumanValidator};
#[derive(Parser)]
struct SampleOptions {
#[arg(
long, default_value="666000ms",
value_parser = duration_range_value_parse!(min: 10min, max: 1h)
)]
interval: DurationHuman,
}
let opts = SampleOptions::parse();
assert_eq!(format!("{:#}",opts.interval), format!("11min 6s"));
assert_eq!(opts.interval.to_string(), "666s".to_string())
Macro: assign_duration_range_validator
use clap::Parser;
use clap_duration::duration_range_value_parse;
use duration_human::{DurationHuman, DurationHumanValidator};
assign_duration_range_validator!( LIFETIME_RANGE = {default: 2h, min: 333s, max: 60day});
#[derive(Parser)]
struct ServerOptions {
#[arg(
long,
help = format!("What lifetime will it have, between {}", LIFETIME_RANGE),
default_value = LIFETIME_RANGE.default,
value_parser = {|lifetime: &str|LIFETIME_RANGE.parse_and_validate(lifetime)}
)]
lifetime: DurationHuman,
}
let opts = ServerOptions::parse();
assert_eq!(format!("{:#}",opts.lifetime), format!("11min 6s"));
assert_eq!(opts.lifetime.to_string(), "666s".to_string());
Dependencies
~4.5–5.5MB
~107K SLoC