#macro-derive #macro-helpers #proc-macro #macro #helper #inclusive #generics

derive-elves

Writing inclusive derive macros is tedious, this creates provides helper functions that make it easier

3 releases

0.1.2 Mar 26, 2024
0.1.1 Mar 23, 2023
0.1.0 Mar 3, 2023

#314 in Procedural macros

Download history 147/week @ 2024-07-25 72/week @ 2024-08-01 60/week @ 2024-08-08 54/week @ 2024-08-15 79/week @ 2024-08-22 157/week @ 2024-08-29 168/week @ 2024-09-05 129/week @ 2024-09-12 138/week @ 2024-09-19 101/week @ 2024-09-26 79/week @ 2024-10-03 59/week @ 2024-10-10 150/week @ 2024-10-17 73/week @ 2024-10-24 114/week @ 2024-10-31 31/week @ 2024-11-07

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

MIT license

8KB
81 lines

derive-elves

Writing inclusive derive macros is tedious, this creates provides helper functions that make it easier.

type aware impl

The type_aware_impl function makes it easy to write derive macros that take the generics of the underlying type into consideration.

Example

Considering this simple derive macro.

#[proc_macro_derive(Append)]
pub fn push(input_stream: TokenStream) -> TokenStream {
    let input_type = parse_macro_input!(input_stream as DeriveInput);

    let ident = &input_type.ident;

    type_aware_impl(
        quote! {
            impl<T: Append<T>> Append<T> for #ident {
                fn append(&self, l: T) {
                    todo!()
                }
            }
        },
        &input_type,
    )
}

The the following anotated struct,

#[derive(Append)]
struct Foo<S: ToString> {
    bar: S
}

would expand to this:

struct Foo<S: ToString> {
    bar: S
}

impl<T: Append<T>, S: ToString> Append<T> for Foo<S> {
    fn append(&self, l: T) {
        todo!()
    }
}

The above also works for more complex patterns, like the following:

impl Trait for & #ident
impl Trait for &mut #ident
impl Trait for [#ident]
impl Trait for (#ident, A, B, C)

License: MIT

Dependencies

~240–690KB
~16K SLoC