Struct pretty_exec::clap::builder::EnumValueParser

pub struct EnumValueParser<E>(_)
where
    E: 'static + ValueEnum + Clone + Send + Sync;

Parse an ValueEnum value.

See also:

• PossibleValuesParser

Example

#[derive(Copy, Clone, Debug, PartialEq, Eq)]
enum ColorChoice {
    Always,
    Auto,
    Never,
}

impl clap::ValueEnum for ColorChoice {
    fn value_variants<'a>() -> &'a [Self] {
        &[Self::Always, Self::Auto, Self::Never]
    }

    fn to_possible_value<'a>(&self) -> Option<clap::builder::PossibleValue> {
        match self {
            Self::Always => Some(clap::builder::PossibleValue::new("always")),
            Self::Auto => Some(clap::builder::PossibleValue::new("auto")),
            Self::Never => Some(clap::builder::PossibleValue::new("never")),
        }
    }
}

// Usage
let mut cmd = clap::Command::new("raw")
    .arg(
        clap::Arg::new("color")
            .value_parser(clap::builder::EnumValueParser::<ColorChoice>::new())
            .required(true)
    );

let m = cmd.try_get_matches_from_mut(["cmd", "always"]).unwrap();
let port: ColorChoice = *m.get_one("color")
    .expect("required");
assert_eq!(port, ColorChoice::Always);

// Semantics
let value_parser = clap::builder::EnumValueParser::<ColorChoice>::new();
// or
let value_parser = clap::value_parser!(ColorChoice);
assert!(value_parser.parse_ref(&cmd, arg, OsStr::new("random")).is_err());
assert!(value_parser.parse_ref(&cmd, arg, OsStr::new("")).is_err());
assert_eq!(value_parser.parse_ref(&cmd, arg, OsStr::new("always")).unwrap(), ColorChoice::Always);
assert_eq!(value_parser.parse_ref(&cmd, arg, OsStr::new("auto")).unwrap(), ColorChoice::Auto);
assert_eq!(value_parser.parse_ref(&cmd, arg, OsStr::new("never")).unwrap(), ColorChoice::Never);

Implementations

impl<E> EnumValueParser<E>where
    E: 'static + ValueEnum + Clone + Send + Sync,

pub fn new() -> EnumValueParser<E>

Parse an ValueEnum

Trait Implementations

impl<E> Clone for EnumValueParser<E>where
    E: 'static + Clone + ValueEnum + Send + Sync,

fn clone(&self) -> EnumValueParser<E>

Returns a copy of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<E> Debug for EnumValueParser<E>where
    E: 'static + Debug + ValueEnum + Clone + Send + Sync,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<E> Default for EnumValueParser<E>where
    E: 'static + ValueEnum + Clone + Send + Sync,

fn default() -> EnumValueParser<E>

Returns the “default value” for a type.

impl<E> TypedValueParser for EnumValueParser<E>where
    E: 'static + ValueEnum + Clone + Send + Sync,

type Value = E

Argument’s value type

fn parse_ref(
    &self,
    cmd: &Command,
    arg: Option<&Arg>,
    value: &OsStr
) -> Result<<EnumValueParser<E> as TypedValueParser>::Value, Error<RichFormatter>>

Parse the argument value

fn possible_values(
    &self
) -> Option<Box<dyn Iterator<Item = PossibleValue>, Global>>

Reflect on enumerated value properties

fn parse(
    &self,
    cmd: &Command,
    arg: Option<&Arg>,
    value: OsString
) -> Result<Self::Value, Error<RichFormatter>>

Parse the argument value

fn map<T, F>(self, func: F) -> MapValueParser<Self, F>where
    T: Send + Sync + Clone,
    F: Fn(Self::Value) -> T + Clone,

Adapt a TypedValueParser from one value to another

fn try_map<T, E, F>(self, func: F) -> TryMapValueParser<Self, F>where
    F: 'static + Fn(Self::Value) -> Result<T, E> + Clone + Send + Sync,
    T: Send + Sync + Clone,
    E: Into<Box<dyn Error + Send + Sync + 'static, Global>>,

Adapt a TypedValueParser from one value to another