Skip to main content

inplace_init_macros/
lib.rs

1use proc_macro::TokenStream;
2use syn::{DeriveInput, Error, parse_macro_input};
3
4mod derive;
5mod initializer;
6mod support;
7
8/// 为结构体生成类型状态构造器;字段可用 `#[init(default)]` 或
9/// `#[init(default = 初始化器)]` 声明默认初始化方式。
10/// Generate a typestate builder for a struct; fields may declare defaults with `#[init(default)]`
11/// or `#[init(default = initializer)]`.
12#[proc_macro_derive(Init, attributes(init, pin))]
13pub fn derive_init(input: TokenStream) -> TokenStream {
14    let input = parse_macro_input!(input as DeriveInput);
15    derive::DeriveMacro::expand(input)
16        .unwrap_or_else(Error::into_compile_error)
17        .into()
18}
19
20/// 为结构体创建原地初始化器;`Type { .. }` 会在目标槽位调用 `InitDefault`。
21/// Create an in-place initializer for a struct; `Type { .. }` calls `InitDefault` in its target slot.
22#[proc_macro]
23pub fn init(input: TokenStream) -> TokenStream {
24    initializer::InitializerMacro::expand(input, false)
25}
26
27/// 为结构体创建固定地址初始化器;字段可用 `default` 在字段槽位中构造默认值。
28/// Create a pinned initializer for a struct; fields can use `default` to construct in their slots.
29#[proc_macro]
30pub fn pin_init(input: TokenStream) -> TokenStream {
31    initializer::InitializerMacro::expand(input, true)
32}
33
34/// 在当前作用域创建固定存储;返回的凭证在存储之前析构。
35/// Create pinned storage in the current scope; its receipt is dropped before the storage.
36#[proc_macro]
37pub fn pin_init_local(input: TokenStream) -> TokenStream {
38    initializer::InitializerMacro::expand_pin_local(input)
39}