seamless_macros 0.12.0

Macros to complement the 'seamless' library
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


pub struct Props {
    pub docs: String,
    pub tag: Option<String>,
    pub flatten: bool
}

pub static NAME: &'static str = "api_body";

pub fn parse(attrs: &[syn::Attribute]) -> syn::Result<Props> {

    let mut props = Props {
        docs: String::new(),
        tag: None,
        flatten: false
    };

    for attr in attrs {
        // If the attr is serde based, error! not allowed
        if attr.path.is_ident("serde") {
            return Err(syn::Error::new_spanned(attr, "serde attributes not allowed; ApiBody macro handles that"))
        }

        // Process doc strings:
        if let Some(doc) = extract_doc_string(attr) {
            if props.docs.len() > 0 { props.docs.push('\n'); }
            props.docs.push_str(&doc);
        }

        // Ignore attrs we don't care about and copy them for output
        if !attr.path.is_ident(NAME) {
            continue
        }

        // We should have a list of meta attributes inside the attr path
        let meta_list = match attr.parse_meta()? {
            syn::Meta::List(list) => list,
            bad => return Err(syn::Error::new_spanned(bad, "unrecognized attribute"))
        };

        for item in meta_list.nested {
            // Each list item should be a meta item:
            let meta = match item {
                syn::NestedMeta::Meta(meta) => meta,
                bad => return Err(syn::Error::new_spanned(bad, "unrecognized attribute"))
            };

            match meta {
                // Handle eg #[typescript(tag = "foo")]
                syn::Meta::NameValue(name_value) => {
                    if name_value.path.is_ident("tag") {
                        props.tag = Some(lit_string(name_value.lit)?);
                    } else {
                        return Err(syn::Error::new_spanned(name_value, "unrecognized attribute"))
                    }
                },
                // Handle eg #[typescript(flatten)]
                syn::Meta::Path(path) => {
                    if path.is_ident("flatten") {
                        props.flatten = true;
                    } else {
                        return Err(syn::Error::new_spanned(path, "unrecognized attribute"))
                    }
                },
                bad => return Err(syn::Error::new_spanned(bad, "unrecognized attribute"))
            }
        }
    }

    Ok(props)
}

fn extract_doc_string(attr: &syn::Attribute) -> Option<String> {
    match attr.parse_meta().ok()? {
        syn::Meta::NameValue(nv) => {
            if nv.path.is_ident("doc") {
                let doc_string = lit_string(nv.lit).ok()?.trim_start().to_owned();
                Some(doc_string)
            } else {
                None
            }
        },
        _ => None
    }
}

fn lit_string(lit: syn::Lit) -> syn::Result<String> {
    match lit {
        syn::Lit::Str(s) => Ok(s.value()),
        bad => Err(syn::Error::new_spanned(bad, "string literal required here"))
    }
}