#macro #enums #flat #flat-target #into-flat

flat_enum

Expand nested enum into flattened enum

2 releases

0.1.1 Apr 2, 2025
0.1.0 Jan 22, 2024

#731 in Data structures

Download history 135/week @ 2025-03-31 18/week @ 2025-04-07

153 downloads per month

MIT license

10KB
100 lines

flat_enum crate Latest Version Documentation GitHub Actions

This crate expands nesting enums. See the example:

# use flat_enum::{flat, into_flat, FlatTarget};
#[derive(FlatTarget)]
pub enum Enum1<A> {
    E1(A),
    E2(),
    E3(String),
}

#[into_flat(Enum2Flat<A>)]
pub enum Enum2<A> {
    #[flatten]
    Enum1(Enum1<A>),
    E4,
}

#[flat(Enum2<A>)]
pub enum Enum2Flat<A> {}

In macro invocation, the Enum2Flat expands into something like:

pub enum Enum2Flat<A> {
    E1(A),
    E2(),
    E3(String),
    E4,
}

In this example, Enum1 and Enum2 are not required to be defined in the same crate. But Enum2 and Enum2Flat should be defined in the same context (module).

Motivation

Memory compaction

In Rust's enum representation on memory, we have std::mem::Disctiminant value in addition to the field values of each variants. If two enums are nesting, it should have two discriminants on memory. The compiler's optimization algorithm does not do such work.

This crate gives a way to generate flattened enum automatically to deal with the problem.

Syntax sugar

When using a value of nested enum types in match-like expression, the matchers are easily to become complex. The flattened enum solves that.

Dependencies

~1.5MB
~39K SLoC