useless_setter_maker 0.1.0

Macro for generating setter methods.
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

use proc_macro::TokenStream;
use syn::{
    ItemStruct,
    parse_macro_input,
};

mod implementation;
use implementation::do_make_setters;

/// Generates builder-style setter methods for struct fields, enabling
/// a fluent, chainable API for struct initialization. Each setter
/// follows the pattern `<prefix>_<suffix>` (default: `with_<field_name>`),
/// accepts any type implementing `Into<T>` (where `T` is the field type),
/// and returns a modified instance.
///
/// Apply this macro to a struct with named fields using `#[make_setters]`.
/// The original struct remains unchanged, and setters provide a
/// convenient way to set field values in a chainable manner.
///
/// ### Customization Options
/// - `#[disable_setter]`: Skip setter generation for a specific field.
/// - `#[setter_prefix = "prefix"]`: Override the default `with` prefix.
/// - `#[setter_suffix = "suffix"]`: Customize the suffix
///    (defaults to field name).
/// - `#[setter_name = "name"]`: Set a custom method name, overriding
///    prefix/suffix.
/// - `#[setter_visibility = "<vis>"]`: Control method visibility:
///   - `pub`: Public access (default).
///   - `pub(crate)`: Crate-only access.
///   - `private`: Private access.
///
/// # Example
/// ```rust
/// use useless_setter_maker::make_setters;
///
/// #[make_setters]
/// #[derive(Debug, PartialEq, Default)]
/// struct Foo {
///     bar: u16,
///
///     #[setter_prefix = "set"]
///     #[setter_visibility = "pub"]
///     baz: String,
///
///     #[disable_setter]
///     foobar: bool,
///
///     #[setter_suffix = "fb"]
///     #[setter_visibility = "pub(crate)"]
///     foobaz: bool,
///
///     #[setter_prefix = "provide"]
///     #[setter_suffix = "bb"]
///     barbaz: String,
///
///     #[setter_name = "install_bazfoo"]
///     #[setter_visibility = "private"]
///     bazfoo: String,
/// }
///
/// let foo = Foo::default()
///     .with_bar(100 as u16)       // Public
///     .set_baz("some_text")       // Public
///     .with_fb(true)              // Pub(crate)
///     .provide_bb("other_text")   // Public
///     .install_bazfoo("bazfoo");  // Private
///
/// let expected = Foo {
///     bar: 100,
///     baz: String::from("some_text"),
///     foobar: false,
///     foobaz: true,
///     barbaz: String::from("other_text"),
///     bazfoo: String::from("bazfoo"),
/// };
/// assert_eq!(foo, expected);
/// ```
#[proc_macro_attribute]
pub fn make_setters(_: TokenStream, input: TokenStream) -> TokenStream {
    let input = parse_macro_input!(input as ItemStruct);
    do_make_setters(input)
}