#enums #value #from-str #u8 #repr #enum-utils

enum-utils-from-str

Code generation for mapping from strings to arbitrary values

2 releases

0.1.2 Oct 14, 2019
0.1.0 May 7, 2019

#2769 in Rust patterns

Download history 4477/week @ 2024-12-17 2265/week @ 2024-12-24 2329/week @ 2024-12-31 4469/week @ 2025-01-07 4006/week @ 2025-01-14 3670/week @ 2025-01-21 3716/week @ 2025-01-28 4513/week @ 2025-02-04 3745/week @ 2025-02-11 3140/week @ 2025-02-18 4630/week @ 2025-02-25 4085/week @ 2025-03-04 5203/week @ 2025-03-11 5104/week @ 2025-03-18 4663/week @ 2025-03-25 4760/week @ 2025-04-01

20,392 downloads per month
Used in 22 crates (via enum-utils)

MIT license

13KB
286 lines

enum-utils

crates.io docs.rs Build Status

A set of procedural macros for deriving useful functionality on enums.

See the API docs for more information.

FromStr

An efficient, configurable FromStr implementation for C-like enums.

#[derive(Debug, PartialEq, enum_utils::FromStr)]
enum Test {
    Alpha,
    Beta,
}

assert_eq!("Alpha".parse(), Ok(Test::Alpha));
assert_eq!("Beta".parse(), Ok(Test::Beta));

IterVariants

A static method returning an iterator over the variants of an enum.

#[derive(Debug, PartialEq, Eq, enum_utils::IterVariants)]
#[repr(u8)]
pub enum Direction {
    North = 1,
    East,
    South,
    West,
}

use Direction::*;
assert_eq!(Direction::iter().collect::<Vec<_>>(), vec![North, East, South, West]);

TryFromRepr and ReprFrom

Conversion to and from the discriminant of a C-like enum.

use std::convert::TryInto;

#[derive(Debug, Clone, Copy, PartialEq, Eq, enum_utils::ReprFrom, enum_utils::TryFromRepr)]
#[repr(u8)]
pub enum Direction {
    North = 1,
    East,
    South,
    West
}

use Direction::*;
assert_eq!(1u8, North.into());
assert_eq!(4u8, West.into());
assert_eq!(North, 1u8.try_into().unwrap());
assert_eq!(West,  4u8.try_into().unwrap());

Dependencies

~74KB