#enums #variant #impl #ident #impl-block #inline #inliner

macro enum_inliner

Define custom code that's inlined for every variant of an enum

1 unstable release

0.0.1 Jan 21, 2025
0.0.1-alpha.1 Jan 16, 2025

#27 in #ident

Download history 112/week @ 2025-01-14 148/week @ 2025-01-21

260 downloads per month

MIT license

10KB
171 lines

enum_inliner

crates.io docs.rs

Takes this:

mod strategy_impl { ... }

enum_inliner::enum_inline!(
    #[derive(Copy, Clone)]
    enum Strategy {
        A,
        B,
        C,
    }

    impl<const __VARIANT__: ident> Strategy {
        fn dbg_s(self) -> String {
            format!("{:?}", strategy_impl::__VARIANT__)
        }
    }
);

And expands each function inside the provided impl block by "copying" its body — the template — into the match arms generated for the corresponding enum. One would get this:

mod strategy_impl { ... }

#[derive(Copy, Clone)]
enum Strategy {
    A,
    B,
    C,
}

impl Strategy {
    fn dbg_s(self) -> String {
        match self {
            Self::A => format!("{:?}", strategy_impl::A),
            Self::B => format!("{:?}", strategy_impl::B),
            Self::C => format!("{:?}", strategy_impl::C),
        }
    }
}

See the complete code in this simple example test.

Use cases

Use cases aren't vast; but sometimes this may come in handy.

One of such use cases is when working with traits that aren't object-safe/dyn-safe (cannot be used with dyn), but still require dynamic dispatch at runtime. In these situations, one can create an enum with variants representing each trait implementation, which is used to perform the dispatch based on the enum "tags", which can pass through runtime.

Why a proc macro?

Even though this kind of functionality can be implemented using a declarative macro, the macro_rules! implementation becomes extremely convoluted. User-level error messages also get degraded.

License

MIT license.

Dependencies

~220–660KB
~16K SLoC