#enums #variant #macro-derive #companion #generate #fields #specifying

enum-tags

A Derive-Macro library that generates a companion tag-enum for any enum so that variants can be referred to without specifying fields

1 unstable release

0.1.0 Feb 23, 2022

#2828 in Rust patterns

Download history 1/week @ 2023-12-18 7/week @ 2023-12-25 39/week @ 2024-01-15 37/week @ 2024-01-22 41/week @ 2024-01-29 33/week @ 2024-02-05 130/week @ 2024-02-12 35/week @ 2024-02-19 60/week @ 2024-02-26 32/week @ 2024-03-04 17/week @ 2024-03-11 8/week @ 2024-03-18 17/week @ 2024-03-25

77 downloads per month
Used in rested

MIT license

5KB

enum-tags

A Derive-Macro library that generates a companion tag-enum for any enum so that variants can be referred to without specifying fields.

Usage

Add this to your Cargo.toml:

[dependencies]
enum-tags = "0.1.0"

Then derive [Tag] for any enum you want to generate a companion tag-enum for.

#[derive(Tag)]
enum MyEnum {
	A,
	B = 1024,
	C(char),
	D { x: i32, y: i32 },
}

The generated enum will look like this:

#[derive(Clone, Copy, Debug, PartialEq, Eq)]
enum MyEnumTag {
	A,
	B = 1024,
	C,
	D,
}

An impl for the TaggedEnum trait will also be generated to allow conversion from your enum type to the tag-enum. The generated impl will look like this:

impl ::enum_tags_traits::TaggedEnum for MyEnum {
	type Tag = MyEnumTag;
	fn tag(&self) -> Self::Tag {
		match *self {
			Self::A => Self::Tag::A,
			Self::B => Self::Tag::B,
			Self::C(_) => Self::Tag::C,
			Self::D { x: _, y: _ } => Self::Tag::D,
		}
	}
}

lib.rs:

Struct Test

use enum_tags::Tag;
#[derive(Tag)]
struct Bad {}

Union Test

use enum_tags::Tag;
#[derive(Tag)]
union Bad {}

Dependencies

~1.5MB
~33K SLoC