icydb-model-macros 0.216.2

Procedural macros for IcyDB application models
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

//! Module: helper
//! Responsibility: application helper derive support.
//! Does not own: runtime schema semantics.
//! Boundary: macro input to generated tokens.

use proc_macro2::TokenStream;
use quote::{ToTokens, quote};

/// ----------------------
/// Quoting helpers
/// ----------------------

/// Quote a single value after transforming it into tokens.
pub fn quote_one<T, F>(t: &T, transform: F) -> TokenStream
where
    F: FnOnce(&T) -> TokenStream,
{
    let transformed = transform(t);
    quote!(#transformed)
}

/// Quote an `Option`, applying the transform to the inner value when present.
pub fn quote_option<T, F>(opt: Option<&T>, transform: F) -> TokenStream
where
    F: FnOnce(&T) -> TokenStream,
{
    if let Some(v) = opt {
        let transformed = transform(v);
        quote!(Some(#transformed))
    } else {
        quote!(None)
    }
}

/// Quote a slice by transforming each element and returning a token array.
pub fn quote_slice<T, F>(vec: &[T], transform: F) -> TokenStream
where
    F: Fn(&T) -> TokenStream,
{
    let items: Vec<TokenStream> = vec
        .iter()
        .map(transform)
        .filter(|ts| !ts.is_empty())
        .collect();

    quote! {
        &[#(#items),*]
    }
}

/// ----------------------
/// Transform helpers
/// ----------------------

/// Convert a tokenizable value into a string literal token.
pub fn to_str_lit<T: ToTokens>(t: &T) -> TokenStream {
    let s = quote!(#t).to_string();

    quote!(#s)
}

/// Resolve a `Path` implementor to its associated `PATH` constant.
pub fn to_path<T: ToTokens>(t: &T) -> TokenStream {
    quote! { <#t as ::icydb_model::Path>::PATH }
}