#builder-pattern #derive-builder #builder #design-pattern #macro-derive #macro #derive

auto-builder

A derive macro to implement the builder pattern for any struct

2 unstable releases

0.2.0 Jan 21, 2024
0.1.0 Jan 20, 2024

#2777 in Rust patterns

MIT license

3KB

auto-builder

This crate provides a derive macro that implements the builder pattern for any struct.

#[derive(Builder)]
struct Foo {           
    a: i32,
    b: Option<i32>,
 }

let foo = FooBuilder::new().a(1).b(Some(2)).build();
assert!(foo.is_ok());


lib.rs:

This crate provides a derive macro to implement the builder pattern for any struct.

Deriving the Builder macro for a struct named Foo will generate a builder struct named FooBuilder with methods to set each field of Foo and a build method to create a Foo from the builder. The build method will fail if any fields have not been set. It returns a Result<Foo, String> where the String is an error message indicating which fields have not been set.

Example

use auto_builder::Builder;

#[derive(Builder)]
struct Foo {
  bar: i32,
  baz: String,
}

let complete_foo = FooBuilder::new().bar(42).baz("hello".to_string()).build()
let incomplete_foo = FooBuilder::new().bar(42).build();

assert!(complete_foo.is_ok());
assert!(incomplete_foo.is_err());

Dependencies

~245–690KB
~17K SLoC