#enums #macro-derive #deriving #proc-macro

macro enum-kinds

Generate enums with matching variants but without any of the associated data

6 releases

0.5.1 Aug 17, 2021
0.5.0 May 13, 2020
0.4.1 Aug 22, 2018
0.4.0 Mar 10, 2018
0.3.1 Mar 7, 2018

#326 in Procedural macros

Download history 6038/week @ 2023-11-21 7577/week @ 2023-11-28 5927/week @ 2023-12-05 6967/week @ 2023-12-12 5006/week @ 2023-12-19 3027/week @ 2023-12-26 5756/week @ 2024-01-02 7347/week @ 2024-01-09 7868/week @ 2024-01-16 6903/week @ 2024-01-23 7340/week @ 2024-01-30 7546/week @ 2024-02-06 7523/week @ 2024-02-13 7563/week @ 2024-02-20 7777/week @ 2024-02-27 6101/week @ 2024-03-05

29,982 downloads per month
Used in 32 crates (12 directly)

MIT license

11KB
167 lines

enum-kinds

Build Status Latest Version Rust Documentation

Custom derive for generating enums with matching variants but without any of the data.

In other words, enum-kinds automatically generates enums that have the same set of variants as the original enum, but with all the embedded data stripped away (that is, all the variants of the newly-generated enum are unit variants). Additionally, enum-kinds implements From trait for going from the original enum to the unit variant version.

The crate is compatible with stable Rust releases. This crate replaces earlier enum_kinds_macros and enum_kinds_traits crates.

Example

#[macro_use]
extern crate enum_kinds;

#[derive(EnumKind)]
#[enum_kind(SomeEnumKind)]
enum SomeEnum {
    First(String, u32),
    Second(char),
    Third
}

#[test]
fn test_enum_kind() {
    let first = SomeEnum::First("Example".to_owned(), 32);
    assert_eq!(SomeEnumKind::from(&first), SomeEnumKind::First);
}

The #[derive(EnumKind)] attribute automatically creates another enum named SomeEnumKind that contains matching unit variant for each of the variants in SomeEnum.

Additional Attributes for Generated Enums

By default, derived kind enums implement Debug, Clone, Copy, PartialEq and Eq traits. Additional attributes can be attached to the generated enum by including them to the enum_kind attribute: #[enum_kind(NAME, derive(SomeTrait), derive(AnotherTrait))]. For example, to implement Serde's Serialize and Deserialize traits:

#[macro_use]
extern crate enum_kinds;

#[macro_use]
extern crate serde_derive;
extern crate serde;

#[derive(EnumKind)]
#[enum_kind(AdditionalDerivesKind, derive(Serialize, Deserialize))]
enum AdditionalDerives {
    Variant(String, u32),
    Another(String)
}

no_std support

enum-kinds can be used without the standard library by enabling no-stdlib feature.

Issues

If you encounter any problems using the crate, please report them at the issue tracker.

License

The crate is available under the terms of MIT license.

Dependencies

~1.5MB
~33K SLoC