Rust 类型化构建器

创建一个编译时验证的构建器

use typed_builder::TypedBuilder;

#[derive(TypedBuilder)]
struct Foo {
    // Mandatory Field:
    x: i32,

    // #[builder(default)] without parameter - use the type's default
    // #[builder(setter(strip_option))] - wrap the setter argument with `Some(...)`
    #[builder(default, setter(strip_option))]
    y: Option<i32>,

    // Or you can set the default
    #[builder(default=20)]
    z: i32,
}

以任何顺序构建

Foo::builder().x(1).y(2).z(3).build();
Foo::builder().z(1).x(2).y(3).build();

省略可选字段（用 #[default] 标记的）

Foo::builder().x(1).build()

但不能省略非可选参数 - 否则无法编译

Foo::builder().build(); // missing x
Foo::builder().x(1).y(2).y(3); // y is specified twice

功能

• 用于生成构建器模式的自定义派生。
• 能够使用 #[builder(setter(into)) 注释字段，使它们的设置器接受 Into 值。
• 在调用 .build() 之前，对所有字段进行编译时验证，以确保所有字段都已设置。
• 编译时验证没有字段被设置两次以上。
• 能够使用 #[builder(default)] 注释字段，使它们可选，并在用户未设置它们时指定默认值。
• 为 .builder() 方法生成简单的文档。
• 自定义 .build() 方法的名称和可见性。