veilid-core 0.5.7

Core library used to create a Veilid node and operate it as part of an application
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

//! Parameterized attribute macros for exported API types.
//! One `#[apply(api_data_struct!)]` or `#[apply(api_data_enum!)]` per item, with an
//! optional `#[api(...)]` parameter list immediately after it (consumed, never expanded).
//! Base attrs are always emitted: Clone/Debug/Serialize/Deserialize, camelCase rename
//! under `json-camel-case` (structs only), JsonSchema under `schemars`, `#[must_use]`.
//! Params: `eq`, `copy`, `ord`, `hash`, `default`, `get_size`, `ts` (bare Tsify on wasm),
//! `ts(<args>)` (Tsify + `tsify(<args>)` verbatim). Extra one-off derives still work as
//! a separate `#[derive(...)]` line after `#[api(...)]`.

macro_rules! api_data_struct {
    ( @munch [] [$($acc:tt)*] $($item:tt)* ) => { $($acc)* $($item)* };
    ( @munch [eq $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)* #[derive(PartialEq, Eq)]] $($item)* }
    };
    ( @munch [copy $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)* #[derive(Copy)]] $($item)* }
    };
    ( @munch [ord $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)* #[derive(PartialOrd, Ord)]] $($item)* }
    };
    ( @munch [hash $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)* #[derive(Hash)]] $($item)* }
    };
    ( @munch [default $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)* #[derive(Default)]] $($item)* }
    };
    ( @munch [get_size $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)* #[derive(::get_size2::GetSize)]] $($item)* }
    };
    ( @munch [ts($($tsargs:tt)*) $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)*
            #[cfg_attr(
                all(target_arch = "wasm32", target_os = "unknown"),
                derive(::tsify::Tsify),
                tsify($($tsargs)*)
            )]
        ] $($item)* }
    };
    ( @munch [ts $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($($rest)*)?] [$($acc)*
            #[cfg_attr(
                all(target_arch = "wasm32", target_os = "unknown"),
                derive(::tsify::Tsify)
            )]
        ] $($item)* }
    };
    ( @munch [$other:tt $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        compile_error!(concat!("api_data_struct: unknown parameter `", stringify!($other), "`"));
    };

    ( @seed [$($params:tt)*] [$($peeled:tt)*] $($item:tt)* ) => {
        api_data_struct! { @munch [$($params)*] [
            $($peeled)*
            #[derive(Clone, Debug, ::serde::Serialize, ::serde::Deserialize)]
            #[cfg_attr(feature = "json-camel-case", serde(rename_all = "camelCase"))]
            #[cfg_attr(feature = "schemars", derive(::schemars::JsonSchema))]
            #[must_use]
        ] $($item)* }
    };
    // peel forwarded attrs (docs etc.) one at a time until #[api(...)] or the item
    ( @peel [$($peeled:tt)*] #[api($($params:tt)*)] $($item:tt)* ) => {
        api_data_struct! { @seed [$($params)*] [$($peeled)*] $($item)* }
    };
    ( @peel [$($peeled:tt)*] #[$next:meta] $($item:tt)* ) => {
        api_data_struct! { @peel [$($peeled)* #[$next]] $($item)* }
    };
    ( @peel [$($peeled:tt)*] $($item:tt)* ) => {
        api_data_struct! { @seed [] [$($peeled)*] $($item)* }
    };

    ( #[api($($params:tt)*)] $($item:tt)* ) => {
        api_data_struct! { @seed [$($params)*] [] $($item)* }
    };
    ( #[$first:meta] $($item:tt)* ) => {
        api_data_struct! { @peel [#[$first]] $($item)* }
    };
    ( $($item:tt)* ) => {
        api_data_struct! { @seed [] [] $($item)* }
    };
}
pub(crate) use api_data_struct;

macro_rules! api_data_enum {
    ( @munch [] [$($acc:tt)*] $($item:tt)* ) => { $($acc)* $($item)* };
    ( @munch [eq $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)* #[derive(PartialEq, Eq)]] $($item)* }
    };
    ( @munch [copy $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)* #[derive(Copy)]] $($item)* }
    };
    ( @munch [ord $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)* #[derive(PartialOrd, Ord)]] $($item)* }
    };
    ( @munch [hash $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)* #[derive(Hash)]] $($item)* }
    };
    ( @munch [default $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)* #[derive(Default)]] $($item)* }
    };
    ( @munch [get_size $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)* #[derive(::get_size2::GetSize)]] $($item)* }
    };
    ( @munch [ts($($tsargs:tt)*) $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)*
            #[cfg_attr(
                all(target_arch = "wasm32", target_os = "unknown"),
                derive(::tsify::Tsify),
                tsify($($tsargs)*)
            )]
        ] $($item)* }
    };
    ( @munch [ts $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($($rest)*)?] [$($acc)*
            #[cfg_attr(
                all(target_arch = "wasm32", target_os = "unknown"),
                derive(::tsify::Tsify)
            )]
        ] $($item)* }
    };
    ( @munch [$other:tt $(, $($rest:tt)*)?] [$($acc:tt)*] $($item:tt)* ) => {
        compile_error!(concat!("api_data_enum: unknown parameter `", stringify!($other), "`"));
    };

    ( @seed [$($params:tt)*] [$($peeled:tt)*] $($item:tt)* ) => {
        api_data_enum! { @munch [$($params)*] [
            $($peeled)*
            #[derive(Clone, Debug, ::serde::Serialize, ::serde::Deserialize)]
            #[cfg_attr(feature = "schemars", derive(::schemars::JsonSchema))]
            #[must_use]
        ] $($item)* }
    };
    // peel forwarded attrs (docs etc.) one at a time until #[api(...)] or the item
    ( @peel [$($peeled:tt)*] #[api($($params:tt)*)] $($item:tt)* ) => {
        api_data_enum! { @seed [$($params)*] [$($peeled)*] $($item)* }
    };
    ( @peel [$($peeled:tt)*] #[$next:meta] $($item:tt)* ) => {
        api_data_enum! { @peel [$($peeled)* #[$next]] $($item)* }
    };
    ( @peel [$($peeled:tt)*] $($item:tt)* ) => {
        api_data_enum! { @seed [] [$($peeled)*] $($item)* }
    };

    ( #[api($($params:tt)*)] $($item:tt)* ) => {
        api_data_enum! { @seed [$($params)*] [] $($item)* }
    };
    ( #[$first:meta] $($item:tt)* ) => {
        api_data_enum! { @peel [#[$first]] $($item)* }
    };
    ( $($item:tt)* ) => {
        api_data_enum! { @seed [] [] $($item)* }
    };
}
pub(crate) use api_data_enum;