rustfoundry-macros 4.2.0

Procedural macros used by rustfoundry.
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

use darling::ast::NestedMeta;
use quote::ToTokens as _;
use syn::parse::{Parse, ParseStream, Parser};
use syn::punctuated::Punctuated;
use syn::spanned::Spanned;
use syn::{Attribute, Ident, Token};

pub(crate) type Result<T> = std::result::Result<T, syn::Error>;

pub(crate) fn error<T>(spanned: &impl Spanned, msg: &'static str) -> Result<T> {
    Err(syn::Error::new(spanned.span(), msg))
}

pub(crate) fn parse_meta_list(input: &ParseStream) -> syn::Result<Vec<NestedMeta>> {
    let list = Punctuated::<NestedMeta, Token![,]>::parse_terminated(input)?
        .into_iter()
        .collect();

    Ok(list)
}

pub(crate) fn parse_optional_trailing_meta_list(
    input: &ParseStream,
) -> syn::Result<Vec<NestedMeta>> {
    if input.peek(Token![,]) {
        input.parse::<Token![,]>()?;

        parse_meta_list(input)
    } else {
        Ok(Default::default())
    }
}

pub(crate) fn parse_attr_value<T>(attr: Attribute) -> Result<T>
where
    T: Parse,
{
    let parser = |input: ParseStream| {
        let _name = input.parse::<Ident>()?;
        let _equal_token = input.parse::<Token![=]>()?;
        input.parse::<T>()
    };

    parser.parse2(attr.meta.to_token_stream())
}

#[cfg(test)]
pub(crate) mod test_utils {
    macro_rules! code_str {
        ($($t:tt)*) => {{
            // NOTE: parse-compile to discard formating
            let parsed: proc_macro2::TokenStream = parse_quote!{ $($t)* };

            parsed.to_string()
        }};
    }

    macro_rules! parse_attr {
        ( $($t:tt)* ) => {{
            let attr: syn::Attribute = parse_quote! { $($t)* };
            let args_tokens: proc_macro2::TokenStream = attr.parse_args().unwrap_or_default();

            syn::parse2(args_tokens.into()).unwrap()
        }};
    }

    pub(crate) use code_str;
    pub(crate) use parse_attr;
}