service_builder_macro/
lib.rs

1//! Procedural macros for the service-builder crate.
2//!
3//! This crate provides the implementation of the `builder` attribute macro,
4//! which generates builder pattern code along with optional getters and setters.
5
6use proc_macro::TokenStream;
7use syn::{parse_macro_input, DeriveInput};
8
9mod builder;
10mod field_attributes;
11
12/// Implements the builder pattern for a struct, with optional getter and setter methods.
13///
14/// # Field Attributes
15///
16/// - `#[builder(getter)]`: Generates a getter method for the field
17/// - `#[builder(setter)]`: Generates a setter method for the field
18/// - `#[builder(getter, setter)]`: Generates both getter and setter methods
19/// - `#[builder(default)]`: Field uses `Default::default()` if not provided
20/// - `#[builder(default = "expression")]`: Field uses custom default expression
21/// - `#[builder(optional)]`: For `Option<T>` fields, defaults to `None`
22///
23/// # Example
24///
25/// ```rust,ignore
26/// use service_builder::builder;
27///
28/// #[builder]
29/// struct Service {
30///     #[builder(getter)]
31///     name: String,
32///     #[builder(setter)]
33///     count: i32,
34///     #[builder(getter, setter)]
35///     enabled: bool,
36/// }
37///
38/// let mut service = Service::builder()
39///     .name("test".to_string())
40///     .count(42)
41///     .enabled(true)
42///     .build()
43///     .unwrap();
44///
45/// // Use generated getter
46/// assert_eq!(service.get_name(), &"test".to_string());
47///
48/// // Use generated setter
49/// service.set_count(100);
50/// service.set_enabled(false);
51/// ```
52#[proc_macro_attribute]
53pub fn builder(_attr: TokenStream, item: TokenStream) -> TokenStream {
54    let input = parse_macro_input!(item as DeriveInput);
55    match builder::expand_builder(input) {
56        Ok(expanded) => expanded.into(),
57        Err(err) => err.to_compile_error().into(),
58    }
59}
service_builder_macro/lib.rs

service_builder_macro/
lib.rs
