token-parser-derive 0.4.0

Derive macros to make structs parsable into tokens
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

#![deny(missing_docs)]

/*!
Derive macros to automatically implement the `Parsable` trait from `token-parser` for tuple structs (unnamed fields).

Supports sequential parsing via `parse_list` (`Parsable` derive) or symbol parsing via `FromStr` (`SymbolParsable` derive).
*/

use quote::quote;
use syn::{
    Data, DeriveInput, Fields, GenericParam, Generics, TypeParamBound, parse_macro_input,
    parse_quote,
};

/// Derive the `Parsable` trait by parsing all unnamed fields in order using the `Parsable` trait.
///
/// # Panics
///
/// Panics if the input is not a struct with unnamed fields.
#[proc_macro_derive(Parsable)]
pub fn derive_default_parsable(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
    derive_parsable(input, false)
}

/// Derive the `Parsable` trait by parsing unnamed fields using the `FromStr` trait.
///
/// Parses the entire `name` string into each field.
///
/// # Panics
///
/// Panics if the input is not a struct with unnamed fields.
#[proc_macro_derive(SymbolParsable)]
pub fn derive_symbol_parsable(input: proc_macro::TokenStream) -> proc_macro::TokenStream {
    derive_parsable(input, true)
}

fn add_trait_bounds(mut generics: Generics, bound: TypeParamBound) -> Generics {
    for param in &mut generics.params {
        if let GenericParam::Type(ref mut type_param) = *param {
            type_param.bounds.push(bound.clone());
        }
    }
    generics
}

fn derive_parsable(input: proc_macro::TokenStream, symbol: bool) -> proc_macro::TokenStream {
    let input = parse_macro_input!(input as DeriveInput);
    let name = input.ident;

    let trait_bound = if symbol {
        parse_quote!(std::str::FromStr)
    } else {
        parse_quote!(token_parser::Parsable)
    };

    let generics = add_trait_bounds(input.generics.clone(), trait_bound);
    let (_, ty_generics, where_clause) = generics.split_for_impl();

    let mut generics = input.generics;
    generics.params.push(parse_quote!(C: token_parser::Context));
    let (impl_generics, _, _) = generics.split_for_impl();

    let Data::Struct(data) = input.data else {
        panic!("Deriving parser is only available for structs");
    };

    match data.fields {
        Fields::Unnamed(fields) => {
            let expression = if symbol {
                quote! {
                    name.parse()
                        .map_err(|_| token_parser::ErrorKind::StringParsing)?
                }
            } else {
                quote!(parser.parse_next(context)?)
            };

            let expressions = fields.unnamed.into_iter().map(|_| &expression);

            let method = if symbol {
                quote! {
                    fn parse_symbol(name: Box<str>, _span: token_parser::Span, context: &C) -> token_parser::Result<Self>
                }
            } else {
                quote! {
                    fn parse_list(parser: &mut token_parser::Parser, context: &C) -> token_parser::Result<Self>
                }
            };

            let expanded = quote! {
                impl #impl_generics token_parser::Parsable<C> for #name #ty_generics #where_clause {
                    #method
                    {
                        Ok(#name(#( #expressions, )*))
                    }
                }
            };

            proc_macro::TokenStream::from(expanded)
        }
        _ => panic!("Deriving parser is only available for tuple structs"),
    }
}