#enums #inner #proc-macro #access #field #deriving #accessor

macro enum-as-inner

A proc-macro for deriving inner field accessor functions on enums

13 releases

0.6.1 Sep 9, 2024
0.6.0 May 30, 2023
0.5.2 May 27, 2023
0.5.1 Aug 6, 2022
0.2.1 Dec 9, 2018

#29 in Procedural macros

Download history 424178/week @ 2024-07-28 425083/week @ 2024-08-04 486512/week @ 2024-08-11 452290/week @ 2024-08-18 485582/week @ 2024-08-25 464392/week @ 2024-09-01 495806/week @ 2024-09-08 441435/week @ 2024-09-15 510436/week @ 2024-09-22 526347/week @ 2024-09-29 555606/week @ 2024-10-06 566560/week @ 2024-10-13 586831/week @ 2024-10-20 624171/week @ 2024-10-27 697614/week @ 2024-11-03 721516/week @ 2024-11-10

2,655,440 downloads per month
Used in 1,639 crates (95 directly)

MIT/Apache

17KB
265 lines

enum-as-inner

A deriving proc-macro for generating functions to automatically give access to the inner members of enum.

Basic unnamed field case

The basic case is meant for single item enums, like:

use enum_as_inner::EnumAsInner;

#[derive(Debug, EnumAsInner)]
enum OneEnum {
    One(u32),
}

where the inner item can be retrieved with the as_*()/as_*_mut() or with the into_*() functions:

let one = OneEnum::One(1);

assert_eq!(*one.as_one().unwrap(), 1);
assert_eq!(one.into_one().unwrap(), 1);

let mut one = OneEnum::One(2);

assert_eq!(*one.as_one().unwrap(), 1);
assert_eq!(*one.as_one_mut().unwrap(), 1);
assert_eq!(one.into_one().unwrap(), 1);

where the result is either a reference for inner items or a tuple containing the inner items.

Unit case

This will return true if enum's variant matches the expected type

use enum_as_inner::EnumAsInner;

#[derive(EnumAsInner)]
enum UnitVariants {
    Zero,
    One,
    Two,
}

let unit = UnitVariants::Two;

assert!(unit.is_two());

Mutliple, unnamed field case

This will return a tuple of the inner types:

use enum_as_inner::EnumAsInner;

#[derive(Debug, EnumAsInner)]
enum ManyVariants {
    One(u32),
    Two(u32, i32),
    Three(bool, u32, i64),
}

And can be accessed like:

let mut many = ManyVariants::Three(true, 1, 2);

assert_eq!(many.as_three().unwrap(), (&true, &1_u32, &2_i64));
assert_eq!(many.as_three_mut().unwrap(), (&mut true, &mut 1_u32, &mut 2_i64));
assert_eq!(many.into_three().unwrap(), (true, 1_u32, 2_i64));

Multiple, named field case

This will return a tuple of the inner types, like the unnamed option:

use enum_as_inner::EnumAsInner;

#[derive(Debug, EnumAsInner)]
enum ManyVariants {
    One{ one: u32 },
    Two{ one: u32, two: i32 },
    Three{ one: bool, two: u32, three: i64 },
}

And can be accessed like:

let mut many = ManyVariants::Three{ one: true, two: 1, three: 2 };

assert_eq!(many.as_three().unwrap(), (&true, &1_u32, &2_i64));
assert_eq!(many.as_three_mut().unwrap(), (&mut true, &mut 1_u32, &mut 2_i64));
assert_eq!(many.into_three().unwrap(), (true, 1_u32, 2_i64));

Dependencies

~250–700KB
~16K SLoC