// arg_util.rs
// *************************************************************************
// * Copyright (C) 2019-2020 Daniel Mueller (deso@posteo.net) *
// * *
// * This program is free software: you can redistribute it and/or modify *
// * it under the terms of the GNU General Public License as published by *
// * the Free Software Foundation, either version 3 of the License, or *
// * (at your option) any later version. *
// * *
// * This program is distributed in the hope that it will be useful, *
// * but WITHOUT ANY WARRANTY; without even the implied warranty of *
// * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
// * GNU General Public License for more details. *
// * *
// * You should have received a copy of the GNU General Public License *
// * along with this program. If not, see . *
// *************************************************************************
macro_rules! count {
($head:ident) => { 1 };
($head:ident, $($tail:ident),*) => {
1 + count!($($tail),*)
}
}
macro_rules! Command {
( $name:ident, [ $( $var:ident($inner:ident) => ($str:expr, $exec:expr), ) *] ) => {
#[derive(Debug, PartialEq, structopt::StructOpt)]
pub enum $name {
$(
$var($inner),
)*
}
impl ::std::convert::AsRef for $name {
fn as_ref(&self) -> &'static str {
match *self {
$(
$name::$var(_) => $str,
)*
}
}
}
impl ::std::fmt::Display for $name {
fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
write!(f, "{}", self.as_ref())
}
}
impl ::std::str::FromStr for $name {
type Err = &'static str;
fn from_str(s: &str) -> ::std::result::Result {
match s {
$(
$str => Ok($name::$var(::std::default::Default::default())),
)*
_ => Err("[error]"),
}
}
}
#[allow(unused_qualifications)]
impl $name {
fn execute(
self,
ctx: &mut crate::args::ExecCtx<'_>,
args: ::std::vec::Vec<::std::string::String>,
) -> crate::Result<()> {
match self {
$(
$name::$var(_) => $exec(ctx, args),
)*
}
}
}
impl_default!($name => $( $name::$var(::std::default::Default::default()) , )*);
};
( $name:ident, [ $( $var:ident => ($str:expr, $exec:expr), ) *] ) => {
#[derive(Debug, PartialEq)]
pub enum $name {
$(
$var,
)*
}
impl ::std::convert::AsRef for $name {
fn as_ref(&self) -> &'static str {
match *self {
$(
$name::$var => $str,
)*
}
}
}
impl ::std::fmt::Display for $name {
fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
write!(f, "{}", self.as_ref())
}
}
impl ::std::str::FromStr for $name {
type Err = &'static str;
fn from_str(s: &str) -> ::std::result::Result {
match s {
$(
$str => Ok($name::$var),
)*
_ => Err("[error]"),
}
}
}
#[allow(unused_qualifications)]
impl $name {
fn execute(
self,
ctx: &mut crate::args::ExecCtx<'_>,
args: ::std::vec::Vec<::std::string::String>,
) -> crate::Result<()> {
match self {
$(
$name::$var => $exec(ctx, args),
)*
}
}
}
impl_default!($name => $( $name::$var , )*);
};
}
/// A macro for generating an enum with a set of simple (i.e., no
/// parameters) variants and their textual representations.
// TODO: Right now we hard code the derives we create. We may want to
// make this set configurable.
macro_rules! Enum {
( $name:ident, [ $( $var:ident => $str:expr, ) *] ) => {
#[derive(Clone, Copy, Debug, PartialEq)]
pub enum $name {
$(
$var,
)*
}
enum_int! {$name, [
$( $var => $str, )*
]}
};
}
macro_rules! enum_int {
( $name:ident, [ $( $var:ident => $str:expr, ) *] ) => {
impl $name {
#[allow(unused)]
pub fn all(&self) -> [$name; count!($($var),*) ] {
$name::all_variants()
}
pub fn all_variants() -> [$name; count!($($var),*) ] {
[
$(
$name::$var,
)*
]
}
}
impl ::std::convert::AsRef for $name {
fn as_ref(&self) -> &'static str {
match *self {
$(
$name::$var => $str,
)*
}
}
}
impl ::std::fmt::Display for $name {
fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
write!(f, "{}", self.as_ref())
}
}
impl ::std::str::FromStr for $name {
type Err = ::std::string::String;
fn from_str(s: &str) -> ::std::result::Result {
match s {
$(
$str => Ok($name::$var),
)*
_ => Err(
format!(
"expected one of {}",
$name::all_variants()
.iter()
.map(::std::convert::AsRef::as_ref)
.collect::<::std::vec::Vec<_>>()
.join(", "),
)
)
}
}
}
impl_default!($name => $( $name::$var , )*);
};
}
macro_rules! impl_default {
( $name:ident => $def:expr , $( $other:expr , ) *) => {
impl ::std::default::Default for $name {
fn default() -> Self {
$def
}
}
};
}
/// A macro for formatting the variants of an enum (as created by the
/// Enum!{} macro) ready to be used in a help text. The supplied `fmt`
/// needs to contain the named parameter `{variants}`, which will be
/// replaced with a generated version of the enum's variants.
macro_rules! fmt_enum {
( $enm:ident ) => {{
fmt_enum!($enm.all())
}};
( $all:expr ) => {{
$all
.iter()
.map(::std::convert::AsRef::as_ref)
.collect::<::std::vec::Vec<_>>()
.join("|")
}};
}
#[cfg(test)]
mod tests {
Enum! {Command, [
Var1 => "var1",
Var2 => "2",
Var3 => "crazy",
]}
#[test]
fn all_variants() {
assert_eq!(
Command::all_variants(),
[Command::Var1, Command::Var2, Command::Var3]
)
}
#[test]
fn text_representations() {
assert_eq!(Command::Var1.as_ref(), "var1");
assert_eq!(Command::Var2.as_ref(), "2");
assert_eq!(Command::Var3.as_ref(), "crazy");
}
}