bon 3.9.1

Next-gen compile-time-checked builder generator, named function's arguments, and more!
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

mod smoke {
    use crate::prelude::*;
    use core::fmt;

    #[test]
    fn test_struct() {
        #[derive(Debug, Builder)]
        #[allow(dead_code)]
        struct Sut {
            #[builder(overwritable)]
            a: u32,

            #[builder(overwritable)]
            b: Option<u32>,

            #[builder(overwritable, default)]
            c: u32,
        }

        assert_debug_eq(
            Sut::builder().a(1).a(2).b(3).b(4).c(5).c(6).build(),
            expect!["Sut { a: 2, b: Some(4), c: 6 }"],
        );
    }

    #[test]
    fn test_function() {
        #[builder]
        fn sut(
            #[builder(overwritable)] a: u32,
            #[builder(overwritable)] b: Option<u32>,
            #[builder(overwritable, default)] c: u32,
        ) -> impl fmt::Debug {
            (a, b, c)
        }

        assert_debug_eq(
            sut().a(1).a(2).b(3).b(4).c(5).c(6).call(),
            expect!["(2, Some(4), 6)"],
        );
    }

    #[test]
    fn test_method() {
        struct Sut;

        #[bon]
        impl Sut {
            #[builder]
            fn sut(
                #[builder(overwritable)] a: u32,
                #[builder(overwritable)] b: Option<u32>,
                #[builder(overwritable, default)] c: u32,
            ) -> impl fmt::Debug {
                (a, b, c)
            }

            #[builder]
            fn with_self(
                &self,
                #[builder(overwritable)] a: u32,
                #[builder(overwritable)] b: Option<u32>,
                #[builder(overwritable, default)] c: u32,
            ) -> impl fmt::Debug {
                let _ = self;
                (a, b, c)
            }
        }

        assert_debug_eq(
            Sut::sut().a(1).a(2).b(3).b(4).c(5).c(6).call(),
            expect!["(2, Some(4), 6)"],
        );

        assert_debug_eq(
            Sut.with_self().a(1).a(2).b(3).b(4).c(5).c(6).call(),
            expect!["(2, Some(4), 6)"],
        );
    }
}

mod on {
    use crate::prelude::*;

    #[test]
    fn test_struct() {
        #[derive(Debug, Builder)]
        #[allow(dead_code)]
        #[builder(on(u32, overwritable))]
        struct Sut {
            a: u32,
            b: Option<u32>,

            #[builder(default)]
            c: u32,

            #[builder(getter)]
            d: u32,

            #[builder(getter)]
            e: Option<u32>,
        }

        let builder = Sut::builder().a(1).a(2).b(3).b(4).c(5).c(6).d(7).e(8);

        assert_debug_eq(builder.get_d(), expect!["7"]);
        assert_debug_eq(builder.get_e(), expect!["Some(8)"]);

        let value = builder.build();

        assert_debug_eq(
            value,
            expect!["Sut { a: 2, b: Some(4), c: 6, d: 7, e: Some(8) }"],
        );
    }
}