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

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

#2297 in Rust patterns

Download history 34/week @ 2024-11-13 34/week @ 2024-11-20 36/week @ 2024-11-27 50/week @ 2024-12-04 48/week @ 2024-12-11 16/week @ 2024-12-18 28/week @ 2025-01-08 15/week @ 2025-01-15 27/week @ 2025-01-22 10/week @ 2025-01-29 16/week @ 2025-02-05 27/week @ 2025-02-12 23/week @ 2025-02-19 14/week @ 2025-02-26

82 downloads per month
Used in 4 crates (2 directly)

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
~39K SLoC