1 unstable release

0.1.0 Feb 5, 2019

#14 in #from-str

Download history 4/week @ 2024-01-15 10/week @ 2024-02-12 13/week @ 2024-02-19 49/week @ 2024-02-26 67/week @ 2024-03-04 7/week @ 2024-03-11 23/week @ 2024-03-18

147 downloads per month
Used in 2 crates

MIT license

4KB

enum-from-str-rs

Allow derive FromStr for enums

Overview

This library adds the #[derive(FromStr)] attribute for enums, thus allowing parsing strings into enum variants. Even though there are other libraries that allows this, like enum_derive, it only allows you to parse from strings with the exact name of a variant. This library allows you to define a custom string for each enum variant.

Basic usage

use enum_from_str::ParseEnumVariantError;
use enum_from_str_derive::FromStr;

#[derive(FromStr)]
enum SomeEnum {
    #[from_str="foo"]
    Foo,
    Bar, // equals to #[from_str="Bar"]
}

fn example() {
    "foo".parse::<SomeEnum>().unwrap();
    "Bar".parse::<SomeEnum>().unwrap();
}

Known issues

Currently, proc-macro crates doesn't allow exporting anything other than the proc-macro function. That's why ParseEnumVariantError is in a different crate. When Rust allows it, it should be moved into a single crate.

Dependencies

~2MB
~45K SLoC