pyro-macro 0.2.0

Derive macros for Pyroduct
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

use proc_macro2::TokenStream;
use quote::quote;
use syn::{ItemStruct, Path, parse_quote};

use crate::format::BridgeableArgs;

/// Attribute macro that adds rkyv serialization, the `Bridgeable` trait, and
/// optionally the `Documented` trait for generating a JSON type spec.
///
/// # Usage
///
/// ```text
/// #[bridgeable]                                     // bare minimum
/// #[bridgeable(Document)]                           // + Documented impl
/// #[bridgeable(derive(Debug, PartialEq))]           // + archived derives
/// #[bridgeable(derive(Debug, PartialEq), Document)] // all of the above
/// ```
pub fn bridgeable(
    args: &BridgeableArgs,
    item: &mut ItemStruct,
    import_location: &Path,
) -> syn::Result<TokenStream> {
    let BridgeableArgs {
        derives_to_pass,
        compares_to_add,
        ..
    } = args;

    let mut rkyv_pass = Vec::with_capacity(5);
    rkyv_pass.push(quote!(crate = #import_location::format::rkyv_8::rkyv));
    if !derives_to_pass.is_empty() {
        rkyv_pass.push(quote! { attr(derive(#(#derives_to_pass),*)) });
    };

    if !compares_to_add.is_empty() {
        rkyv_pass.push(quote! { compare(#(#compares_to_add),*) });
    };

    item.attrs.push(parse_quote!(#[derive(#import_location::format::rkyv_8::rkyv::Archive, #import_location::format::rkyv_8::rkyv::Serialize, #import_location::format::rkyv_8::rkyv::Deserialize)]));
    item.attrs.push(parse_quote!(#[rkyv(#(#rkyv_pass),*)]));

    let (name, impl_generics, ty_generics, where_clause) = (
        &item.ident,
        item.generics.split_for_impl().0,
        item.generics.split_for_impl().1,
        &item.generics.where_clause,
    );

    // 3. Generate UserHeaderValues + Bridgeable impls (matching common.rs)
    let bridgeable_block = quote! {
        impl #impl_generics #import_location::format::Bridgeable for #name #ty_generics #where_clause {
            type Format = #import_location::format::rkyv_8::Rkyv<#name #ty_generics>;
        }
    };

    // 5. Output
    Ok(quote! {
        #item
        #bridgeable_block
    })
}