embedded-command-macros 0.5.0

Macros for the embedded command crate family.
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

use proc_macro::TokenStream;

mod dispatch_bundle;
mod serac;

/// Transform attached enum into a "bundle".
///
/// *What is a bundle?*
///
/// Bundles are used to accomplish dynamic dispatch in resource constrained systems (no_std).
/// A bundle can hold a finite number of types that implement a common trait.
/// The size of the bundle is known at compile time and equal to the size of the largest type in the bundle.
/// Bundles are useful for type-erasure when transporting multiple types pseudo-heterogeneously.
#[proc_macro_attribute]
pub fn bundle(attr: TokenStream, item: TokenStream) -> TokenStream {
    dispatch_bundle::bundle(attr, item)
}

/// Generates the implementation block for conforming to `SerializeIter` of the "vanilla" flavor.
///
/// # Note
///
/// Requires `serac` to be in scope with that name.
#[proc_macro_derive(SerializeIter)]
pub fn impl_serialize_iter_vanilla(item: TokenStream) -> TokenStream {
    serac::vanilla::serialize_iter(item)
}

/// Generates the implementation block for conforming to `Size` of the "vanilla" flavor.
///
/// # Note
///
/// Requires `serac` to be in scope with that name.
#[proc_macro_derive(Size)]
pub fn impl_size_vanilla(item: TokenStream) -> TokenStream {
    serac::vanilla::impl_size(item)
}

/// Generates the implementation block for conforming to `SerializeBuf`.
///
/// As of now, generic types *cannot* implement `SerializeBuf` on stable.
///
/// # Note
///
/// Requires `serac` to be in scope with that name.
#[proc_macro_derive(SerializeBuf)]
pub fn impl_serialize_buf(item: TokenStream) -> TokenStream {
    serac::impl_serialize_buf(item)
}

/// Generates the implementation block for conforming to `SerializeBuf` for a type
/// alias. This is used for implementing `SerializeBuf` for concretely specified
/// generic types.
///
/// # Note
///
/// Requires `serac` to be in scope with that name.
#[proc_macro_attribute]
pub fn impl_serialize_buf_alias(attrs: TokenStream, item: TokenStream) -> TokenStream {
    serac::impl_serialize_buf_alias(attrs, item)
}