typed-builder-macro

Fixed

• Clippy warnings for using &Option<&T> instead of Option<&T>.

Fixed

• Clippy warnings for using &Option<&T> instead of Option<&T>.

Fixed

• Clippy warnings for unused variables in the new default implementation.

Fixed

• Clippy warnings for unused variables in the new default implementation.

Changed

• Upgrae Rust edition to 2024.
• [BREAKING] When default is an expression that uses previous fields,
  it'll receive them as reference.

Added

• default_where option to add generic bounds on default.
• builder_type(attributes(...)) for adding attributes to the builder type
  (mainly for derive)

Removed

• [BREAKING] The Optional trait. This is an internal implementation
  detail, but some users may have relied on it for customized flows.

Changed

• Upgrae Rust edition to 2024.
• [BREAKING] When default is an expression that uses previous fields, it'll receive them as reference.

Added

• default_where option to add generic bounds on default.
• builder_type(attributes(...)) for adding attributes to the builder type (mainly for derive)

Removed

• [BREAKING] The Optional trait. This is an internal implementation detail, but some users may have relied on it for customized flows.

Added

• New optional alternate transform syntax using a full fn, to allow support for custom lifetimes, generics and a where clause to custom builder method.

Example:

#[derive(TypedBuilder)]
struct Foo {
    #[builder(
        setter(
            fn transform<'a, M>(value: impl IntoValue<'a, String, M>) -> String
            where
              M: std::fmt::Display
            {
                value.into_value()
            },
        )
    )]
    s: String,
}

Added

• New optional alternate transform syntax using a full fn, to allow support for custom lifetimes, generics and a where clause to custom builder method.

Example:

#[derive(TypedBuilder)]
struct Foo {
    #[builder(
        setter(
            fn transform<'a, M>(value: impl IntoValue<'a, String, M>) -> String
            where
              M: std::fmt::Display
            {
                value.into_value()
            },
        )
    )]
    s: String,
}

Fixed

• Recognize TypeGroup when checking for Option.

Fixed

• Recognize TypeGroup when checking for Option.

Fixed

• Strip raw ident prefix from base method name before assembling prefixed/suffixed fallback method names

Fixed

• Strip raw ident prefix from base method name before assembling prefixed/suffixed fallback method names

Added

• Added ignore_invalid option to strip_option to skip stripping for non-Option fields
• Added fallback_prefix and fallback_suffix options to strip_option for customizing fallback method names
• Added support for field defaults with strip_option and its fallback options

Changed

• Improved handling of strip_option to work better with field defaults
• Made strip_option more flexible with non-Option fields when ignore_invalid is set

Added

• Added ignore_invalid option to strip_option to skip stripping for non-Option fields
• Added fallback_prefix and fallback_suffix options to strip_option for customizing fallback method names
• Added support for field defaults with strip_option and its fallback options

Changed

• Improved handling of strip_option to work better with field defaults
• Made strip_option more flexible with non-Option fields when ignore_invalid is set

Fixed

• Fix mutator with type parameter using associated type (see issue #157)

Fixed

• Fix mutator with type parameter using associated type (see issue #157)

Added

• Add #[builder(setter(strip_option(fallback = field_opt)))] to add a fallback unstripped method to the builder struct.
• Add #[builder(setter(strip_bool(fallback = field_bool)))] to add a fallback setter that takes the bool value to the builder struct.

Added

• Add #[builder(setter(strip_option(fallback = field_opt)))] to add a fallback unstripped method to the builder struct.
• Add #[builder(setter(strip_bool(fallback = field_bool)))] to add a fallback setter that takes the bool value to the builder struct.

Fixed

• Fix mutators for generic fields (see issue #149)

Fixed

• Fix mutators for generic fields (see issue #149)

Added

• Use fields' doc comments for the setters.

Fixed

• Also add the licenses to the macro crate.

Fixed

• Add #[allow(clippy::no_effect_underscore_binding)] to generated methods that need to destructure intermediate builder state.
• Use a proper OR syntax for the dual license.

Fixed

• ?Sized generic parameters are now supported.

Changed

• Internal refactor of attribute parsing - results in better error messages and easier proces for adding new settings.

Added

• #[builder(mutators(...))] to generate functions on builder to mutate fields
• #[builder(via_mutator)] on fields to allow defining fields initialized during ::builder() for use with mutators
• mutable_during_default_resolution to allow default expression mutate previous fields.

Fixed

• Add support for paths with angle brackets (see PR #122 )

Fixed

• Use generics with the constructor in build method (see issue #118)

Fixed

• Add #[allow(clippy::exhaustive_enums)] to generated empty enums used for error "reporting" (see issue #112)
• Add #[automatically_derived] to generated impls (see issue #114)
• Add #[allow(clippy::used_underscore_binding)] to build method and setter methods (see issue #113)

Added

• #[builder(crate_module_path = ...)] for overcoming cases where the derive macro is used in another crate's macro (see issue #109)

Fixed

• Fix const generics generating "empty" entries in some lists, resulting in consecutive commas (see issue #106)

Fixed

• no-std build.

Changed

• [BREAKING] Split the derive macro out to a separate procmacro crate. This is considered a breaking change because reexporting and/or renmaing the crate can now prevent the generated code from finding the types it needs (see issue #101)

Fixed

• Marking a field as #[deprecated] now behaves properly - TypedBuilder generated code itself does trigger the deprecation warning, and instead the setter for that field now does.
• The "fake" build method when required fields are not provided now returns the never type ("!"). Refer to PR #97 for more thorough explanation.

Added

• Support for setter method prefixes and suffixes #[builder(field_defaults(setter(prefix = "...", suffix = "...")))]. This either prepends or appends the provided string to the setter method. This allows method names like: set_x(), with_y(), or set_z_value().