#macro-derive #macro #create #inclusive #helper #function

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

#130 in Procedural macros

Download history 7/week @ 2024-02-12 29/week @ 2024-02-19 16/week @ 2024-02-26 4/week @ 2024-03-04 7/week @ 2024-03-11 7/week @ 2024-03-18 385/week @ 2024-03-25 105/week @ 2024-04-01 11/week @ 2024-04-08

508 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

~305–750KB
~18K SLoC