#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

#848 in Procedural macros

Download history 126/week @ 2024-10-30 59/week @ 2024-11-06 104/week @ 2024-11-13 75/week @ 2024-11-20 114/week @ 2024-11-27 144/week @ 2024-12-04 149/week @ 2024-12-11 113/week @ 2024-12-18 57/week @ 2024-12-25 152/week @ 2025-01-01 74/week @ 2025-01-08 106/week @ 2025-01-15 66/week @ 2025-01-22 192/week @ 2025-01-29 142/week @ 2025-02-05 74/week @ 2025-02-12

515 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

~220–660KB
~16K SLoC