doku-derive 0.21.2

A framework for building documentation (internal macro)
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

use super::*;

pub fn expand_struct(
    input: &syn::DeriveInput,
    data: &syn::DataStruct,
) -> Result<TokenStream2> {
    let syn::DeriveInput { ident, .. } = input;
    let doku = attrs::DokuContainer::from_ast(&input.attrs)?;
    let serde = attrs::SerdeContainer::from_ast(&input.attrs)?;

    let ty = {
        let rename_fields =
            doku.rename_all.or(serde.rename_all).unwrap_or_default();
        let fields = expand_fields(&data.fields, rename_fields)?;

        let transparent = {
            let transparent =
                doku.transparent.or(serde.transparent).unwrap_or(false);
            quote! { #transparent }
        };

        quote! {
            ::doku::Type::from(::doku::TypeKind::Struct {
                fields: #fields,
                transparent: #transparent,
            })
        }
    };

    let generics = new_generics_with_where_clause(&input.generics)?;
    let (impl_generics, ty_generics, where_clause) = generics.split_for_impl();

    Ok(quote! {
        impl #impl_generics ::doku::Document for #ident #ty_generics #where_clause {
            fn ty() -> ::doku::Type {
                #ty
            }
        }
    })
}