Skip to content

Commit

Permalink
feat(macros): add ability to create enums pub or priv with derives
Browse files Browse the repository at this point in the history
Err type of FromStr trait changed from &'a str->String in order
to allow showing valid values on failed parse

Breaking Change
  • Loading branch information
kbknapp committed Apr 17, 2015
1 parent 424f296 commit 2c499f8
Show file tree
Hide file tree
Showing 2 changed files with 170 additions and 22 deletions.
51 changes: 36 additions & 15 deletions examples/13a_EnumValuesAutomatic.rs
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
// You can use clap's value_t! macro with a custom enum by implementing the std::str::FromStr
// trait which is very straight forward. There are two ways to do this, for simple enums you
// can use clap's simple_enum! macro, but if you require additional functionality you can
// create and implement the trait manually.
// trait which is very straight forward. There are three ways to do this, for simple enums
// meaning those that don't require 'pub' or any '#[derive()]' directives you can use clas's
// simple_enum! macro. For those that require 'pub' or any '#[derive()]'s you can use clap's
// arg_enum! macro. The third way is to implement std::str::FromStr manually.
//
// In the following example we will create an enum with 4 values, assign a positional argument
// that accepts only one of those values, and use clap to parse the argument.
// In most circumstances using either simple_enum! or arg_enum! is fine.
//
// Start with bringing the trait into scope.
// In the following example we will create two enums using macros, assign a positional argument
// that accepts only one of those values, and use clap to parse the argument.

// Add clap like normal
#[macro_use]
Expand All @@ -16,24 +17,44 @@ use clap::{App, Arg};

// Define your enum, the simple_num! macro takes a enum name followed by => and each value
// separated by a ','
simple_enum!{ Vals => Foo, Bar, Baz, Qux }
simple_enum!{ Foo => Bar, Baz, Qux }

// Using arg_enum! is more like traditional enum declarations
//
// **NOTE:** Only bare variants are supported
arg_enum!{
#[derive(Debug)]
pub enum Oof {
Rab,
Zab,
Xuq
}
}

fn main() {
// Create the application like normal
let m = App::new("myapp")
// Use a single positional argument that is required
.arg(Arg::from_usage("<type> 'The type to use'")
// Define the list of possible values
.possible_values(vec!["Foo", "Bar", "Baz", "Qux"]))
.arg(Arg::from_usage("<type> 'The Foo to use'")
// You can define a list of possible values if you want the values to be
// displayed in the help information. Whether you use possible_values() or
// not, the valid values will ALWAYS be displayed on a failed parse.
.possible_values(vec!["Bar", "Baz", "Qux"]))
// For the second positional, lets not use possible_values() just to show the difference
.arg_from_usage("<type2> 'The Oof to use'")
.get_matches();

let t = value_t_or_exit!(m.value_of("type"), Vals);
let t = value_t_or_exit!(m.value_of("type"), Foo);
let t2 = value_t_or_exit!(m.value_of("type2"), Oof);


// Now we can use our enum like normal.
match t {
Vals::Foo => println!("Found a Foo"),
Vals::Bar => println!("Found a Bar"),
Vals::Baz => println!("Found a Baz"),
Vals::Qux => println!("Found a Qux")
Foo::Bar => println!("Found a Bar"),
Foo::Baz => println!("Found a Baz"),
Foo::Qux => println!("Found a Qux")
}

// Since our Oof derives Debug, we can do this:
println!("Oof: {:?}", t2);
}
141 changes: 134 additions & 7 deletions src/macros.rs
Original file line number Diff line number Diff line change
Expand Up @@ -101,8 +101,8 @@ macro_rules! value_t {
for pv in v {
match pv.parse::<$t>() {
Ok(rv) => tmp.push(rv),
Err(_) => {
err = Some(format!("{} isn't a valid {}",pv,stringify!($t)));
Err(e) => {
err = Some(format!("{} isn't a valid {}\n{}",pv,stringify!($t),e));
break
}
}
Expand Down Expand Up @@ -169,10 +169,11 @@ macro_rules! value_t_or_exit {
Some(v) => {
match v.parse::<$t>() {
Ok(val) => val,
Err(_) => {
println!("{} isn't a valid {}\n{}\nPlease re-run with --help for more information",
Err(e) => {
println!("{} isn't a valid {}\n{}\n{}\nPlease re-run with --help for more information",
v,
stringify!($t),
e,
$m.usage());
::std::process::exit(1);
}
Expand Down Expand Up @@ -243,13 +244,139 @@ macro_rules! simple_enum {
$($v),+
}

impl<'a> std::str::FromStr for $e {
type Err = &'a str;
impl std::str::FromStr for $e {
type Err = String;

fn from_str(s: &str) -> Result<Self,<Self as std::str::FromStr>::Err> {
match s {
$(stringify!($v) => Ok($e::$v),)+
_ => Err("no match")
_ => Err({
let v = vec![
$(stringify!($v),)+
];
format!("valid:{}", v.iter().fold(String::new(),|a, i| a + &format!(" {}", i)[..]))
})
}
}
}
};
}

/// Convenience macro to generate more complete enums with variants to be used as a type when parsing
/// arguments.
///
/// These enums support pub (or not) and use of the #[derive()] traits
///
///
/// # Example
///
/// ```no_run
/// # #[macro_use]
/// # extern crate clap;
/// # use clap::{App, Arg};
/// arg_enum!{
/// #[derive(Debug)]
/// pub enum Foo {
/// Bar,
/// Baz,
/// Qux
/// }
/// }
/// // Foo enum can now be used via Foo::Bar, or Foo::Baz, etc
/// // and implements std::str::FromStr to use with the value_t! macros
/// fn main() {
/// let m = App::new("app")
/// .arg_from_usage("<foo> 'the foo'")
/// .get_matches();
/// let f = value_t_or_exit!(m.value_of("foo"), Foo);
///
/// // Use f like any other Foo variant...
/// }
/// ```
#[macro_export]
macro_rules! arg_enum {
(enum $e:ident { $($v:ident),+ } ) => {
enum $e {
$($v),+
}

impl std::str::FromStr for $e {
type Err = String;

fn from_str(s: &str) -> Result<Self,<Self as std::str::FromStr>::Err> {
match s {
$(stringify!($v) => Ok($e::$v),)+
_ => Err({
let v = vec![
$(stringify!($v),)+
];
format!("valid:{}", v.iter().fold(String::new(),|a, i| a + &format!(" {}", i)[..]))
})
}
}
}
};
(pub enum $e:ident { $($v:ident),+ } ) => {
pub enum $e {
$($v),+
}

impl std::str::FromStr for $e {
type Err = String;

fn from_str(s: &str) -> Result<Self,<Self as std::str::FromStr>::Err> {
match s {
$(stringify!($v) => Ok($e::$v),)+
_ => Err({
let v = vec![
$(stringify!($v),)+
];
format!("valid:{}", v.iter().fold(String::new(),|a, i| a + &format!(" {}", i)[..]))
})
}
}
}
};
(#[derive($($d:ident),+)] enum $e:ident { $($v:ident),+ } ) => {
#[derive($($d,)+)]
enum $e {
$($v),+
}

impl std::str::FromStr for $e {
type Err = String;

fn from_str(s: &str) -> Result<Self,<Self as std::str::FromStr>::Err> {
match s {
$(stringify!($v) => Ok($e::$v),)+
_ => Err({
let v = vec![
$(stringify!($v),)+
];
format!("valid:{}", v.iter().fold(String::new(),|a, i| a + &format!(" {}", i)[..]))
})
}
}
}
};
(#[derive($($d:ident),+)] pub enum $e:ident { $($v:ident),+ } ) => {
#[derive($($d,)+)]
pub enum $e {
$($v),+
}

impl std::str::FromStr for $e {
type Err = String;

fn from_str(s: &str) -> Result<Self,<Self as std::str::FromStr>::Err> {
match s {
$(stringify!($v) => Ok($e::$v),)+
_ => Err({
let v = vec![
$(stringify!($v),)+
];
format!("valid:{}", v.iter().fold(String::new(),|a, i| a + &format!(" {}", i)[..]))
})
}
}
}
Expand Down

0 comments on commit 2c499f8

Please sign in to comment.