macon/

lib.rs

//! Another builder macro-based generator with its own idioms.
//!
//! "[Maçon](https://fr.wiktionary.org/wiki/ma%C3%A7on#Nom_commun_2)" is French translation for "[builder](https://www.wordreference.com/enfr/builder)"
//!
//! ### Usage
//!
//! ```
//! #[macro_use] extern crate macon;
//!
//! #[derive(Builder)]
//! struct MyType {
//!   integer: i32,
//!   string: String,
//!   optional: Option<String>,
//! }
//!
//! let _mytype: MyType = MyType::builder()
//!     .integer(42)
//!     .string("foobar")
//!     .build();
//! ```
//!
//! * adds a builder struct (`<TargetStruct>Builder`)
//! * build struct implements [`Default`]
//! * adds a `builder()` function to target struct to initialize a new builder
//! * each target struct field can be set with function of same name and parameter of same type
//! * use `build()` function to create new target struct instance
//! * any unset field will make `build()` call not compile (default)
//! * setter argument is generic over [`Into`]
//! * [`Option`] fields are not mandatory. And setters use wrapped type.
//!
//! ### Settings
//!
//! Settings are set using `#[builder()]` attribute.
//!
//! #### struct
//!
//! * **`mode=<value>`** <br/>
//! Change builder and associated `build()` function behavior. Supported values: [`Typestate`](#typestate-pattern-default) (_default_), [`Panic`](#panic-on-build) or [`Result`](#result-on-build).
//!
//! * **`Default=!`** <br/>
//! Disable automatic [`Default`] derive detection for **struct**. See ["`Default` struct"](#default-struct).
//!
//! * **`Default`** <br/>
//! Enforce [`Default`] support for **struct**. See ["`Default` struct"](#default-struct).
//!
//! * **`Option=!`** (_deprecated. Use `fields(Option=!)` instead._)
//!
//! * **`Into=!`** (_deprecated. Use `fields(Into=!)` instead._)
//!
//! * **`fields(Option=!)`** <br/>
//! Disable automatic [`Option`] detection for **fields**. See ["`Option` fields"](#option-fields).
//!
//! * **`fields(Default=!)`** <br/>
//! Disable automatic [`Default`] detection for **fields**. See ["`Default` fields"](#default-fields).
//!
//! * **`fields(Into=!)`** <br/>
//! Disable [`Into`] for **fields**. See ["`Into` argument"](#into-argument).
//!
//! #### field
//!
//! * **`Option=!`** <br/>
//! Disable automatic [`Option`] detection for given field. Generated setter will rely on declared field type. See ["`Option` fields"](#option-fields).
//!
//! * **`Option=WrappedType`** <br/>
//! Enforce [`Option`] support for given field. Generated setter will rely on `WrappedType`. See ["`Option` fields"](#option-fields).
//!
//! * **`Default=!`** <br/>
//! Disable automatic [`Default`] detection for given field. See ["`Default` fields"](#default-fields).
//!
//! * **`Default`** <br/>
//! Enforce [`Default`] support for given field. See ["`Default` fields"](#default-fields).
//!
//! * **`Into=!`** <br/>
//! Disable [`Into`] for setter. See ["`Into` argument"](#into-argument).
//!
//! ### Features
//!
//! For any feature, you can find blueprints in [`./tests` directory][tests] showing code generated by macro.
//!
//! #### Typestate pattern (default)
//!
//! Blueprints:
//! * [`blueprint_typestate_named.rs`][blueprint_typestate_named.rs]
//! * [`blueprint_typestate_tuple.rs`][blueprint_typestate_tuple.rs]
//! * [`blueprint_typestate_option.rs`][blueprint_typestate_option.rs]
//! * [`blueprint_typestate_default_field.rs`][blueprint_typestate_default_field.rs]
//! * [`blueprint_typestate_default_struct.rs`][blueprint_typestate_default_struct.rs]
//!
//! By default, builder rely on typestate pattern. It means state is encoded in type (using generics). Applicable functions are implemented
//! (callable) only when state (type) matches:
//!
//! * Build function `build()` when all properties has been set
//! * Each property setter function as long as property haven't been set
//!
//! Optionally, you can set it explictly:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! #[builder(mode=Typestate)]
//! struct MyType {
//!   integer: i32,
//!   string: String,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn integer(self, value: i32) -> Self
//! # { unimplemented!(); }
//!   fn string(self, value: String) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> MyType
//! # { unimplemented!();  }
//! }
//! ```
//!
//! #### Panic on `build()`
//!
//! Blueprints:
//! * [`blueprint_panic_named.rs`][blueprint_panic_named.rs]
//! * [`blueprint_panic_tuple.rs`][blueprint_panic_tuple.rs]
//! * [`blueprint_panic_option.rs`][blueprint_panic_option.rs]
//! * [`blueprint_panic_default_field.rs`][blueprint_panic_default_field.rs]
//! * [`blueprint_panic_default_struct.rs`][blueprint_panic_default_struct.rs]
//!
//! By default, builder rely on typestate pattern to avoid misconfiguration by adding compilation constraint. You can switch to a builder
//! that just panic when misconfigured:
//!
//! ```should_panic
//! # #[macro_use] extern crate macon;
//! # use std::path::PathBuf;
//! #[derive(Builder)]
//! #[builder(mode=Panic)]
//! struct MyType {
//!   integer: i32,
//!   path: PathBuf,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn integer(self, value: i32) -> Self
//! # { unimplemented!(); }
//!   fn path(self, value: PathBuf) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> MyType
//! # { unimplemented!(); }
//! }
//!
//! let _mytype: MyType = MyType::builder()
//!     .integer(42)
//!     .build();
//! ```
//!
//! #### Result on `build()`
//!
//! Blueprints:
//! * [`blueprint_result_named.rs`][blueprint_result_named.rs]
//! * [`blueprint_result_tuple.rs`][blueprint_result_tuple.rs]
//! * [`blueprint_result_option.rs`][blueprint_result_option.rs]
//! * [`blueprint_result_default_field.rs`][blueprint_result_default_field.rs]
//! * [`blueprint_result_default_struct.rs`][blueprint_result_default_struct.rs]
//!
//! By default, builder rely on typestate pattern to avoid misconfiguration by adding compilation constraint. You can switch to a builder
//! that returns a [`Result`]:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! # use std::path::PathBuf;
//! #[derive(Builder)]
//! #[builder(mode=Result)]
//! struct MyType {
//!   integer: i32,
//!   path: PathBuf,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn integer(self, value: i32) -> Self
//! # { unimplemented!(); }
//!   fn path(self, value: PathBuf) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> Result<MyType, String>
//! # { unimplemented!(); }
//! }
//!
//! let myTypeResult: Result<MyType,String> = MyType::builder()
//!     .integer(42)
//!     .build();
//!
//! assert_eq!(
//!     Err(String::from("Field path is missing")),
//!     myTypeResult.map(|_| ())
//! );
//! ```
//!
//! #### Tuple
//!
//! Blueprints:
//! * [`blueprint_typestate_tuple.rs`][blueprint_typestate_tuple.rs]
//! * [`blueprint_panic_tuple.rs`][blueprint_panic_tuple.rs]
//! * [`blueprint_result_tuple.rs`][blueprint_result_tuple.rs]
//!
//! A tuple is a struct with unamed fields. Then `set<ordinal>()` is used as setter:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! struct MyTuple(
//!   i32,
//!   Option<String>,
//!   String,
//! );
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn set0(self, value: i32) -> Self
//! # { unimplemented!(); }
//!   fn set1(self, value: String) -> Self
//! # { unimplemented!(); }
//!   fn set2(self, value: String) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> MyTuple
//! # { unimplemented!(); }
//! }
//!
//! let _mytuple: MyTuple = MyTuple::builder()
//!     .set0(42)
//!     .set2(String::from("foobar"))
//!     .build();
//! ```
//!
//! Only for [`Typestate` mode](#typestate-pattern-default), you can chain `set()`, [`none()`](#option-fields), [`keep()`](#default-struct) and [`default()`](#default-fields) calls to assign values in order:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! # #[derive(Builder)]
//! # struct MyTuple(
//! #   i32,
//! #   Option<String>,
//! #   String,
//! # );
//!
//! // Builder signature
//! # struct Builder0;
//! impl Builder0 {
//!   fn set(self, value: i32) -> Builder1
//! # { unimplemented!(); }
//! }
//! # struct Builder1;
//! impl Builder1 {
//!   fn set(self, value: String) -> Builder2
//! # { unimplemented!(); }
//!   fn none(self) -> Builder2
//! # { unimplemented!(); }
//! }
//! # struct Builder2;
//! impl Builder2 {
//!   fn set(self, value: String) -> Builder
//! # { unimplemented!(); }
//! }
//! # struct Builder;
//! impl Builder {
//!   fn build(self) -> MyTuple
//! # { unimplemented!(); }
//! }
//!
//! let _mytuple: MyTuple = MyTuple::builder()
//!     .set(42)
//!     .none()
//!     .set(String::from("foobar"))
//!     .build();
//! ```
//!
//! #### `Into` argument
//!
//! Blueprints:
//! * [`blueprint_typestate_named.rs`][blueprint_typestate_named.rs]
//! * [`blueprint_panic_named.rs`][blueprint_panic_named.rs]
//! * [`blueprint_result_named.rs`][blueprint_result_named.rs]
//!
//! Setter function argument is generic over [`Into`] to ease conversion (especially for `&str`):
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! struct MyTuple(
//!   String,
//! );
//!
//! // Builder signature
//! # struct Builder0;
//! # struct Builder;
//! impl Builder0 {
//!   fn set<V: Into<String>>(self, value: V) -> Builder
//! # { unimplemented!(); }
//! }
//! impl Builder {
//!   fn build(self) -> MyTuple
//! # { unimplemented!(); }
//! }
//!
//! let _mytuple: MyTuple = MyTuple::builder()
//!     .set("foobar")
//!     .build();
//! ```
//!
//! You can disable [`Into`] support by using `#[builder(Into=!)]` at struct or field level:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! #[builder(Into=!)]     // Disable for all fields
//! struct IntoSettings {
//!   #[builder(Into=!)]   // Disable for specific field
//!   no_into: String,
//!   #[builder(Into)]     // Enable (only when disabled at struct level) for specific field
//!   with_into: String,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn no_into(value: String) -> Self
//! # { unimplemented!(); }
//!   fn with_into<V: Into<String>>(value: V) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> IntoSettings
//! # { unimplemented!(); }
//! }
//!
//! let built = IntoSettings::builder()
//!   .no_into(String::from("no value conversion"))
//!   .with_into("value conversion")
//!   .build();
//!
//! assert_eq!(String::from("no value conversion"), built.no_into);
//! assert_eq!(String::from("value conversion"), built.with_into);
//! ```
//!
//! This feature is required to use with [`dyn` trait](https://doc.rust-lang.org/book/ch19-04-advanced-types.html#dynamically-sized-types-and-the-sized-trait):
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! struct DynTrait {
//!   #[builder(Into=!)]
//!   function: Box<dyn Fn(usize) -> usize>,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn function(self, value: Box<dyn Fn(usize) -> usize>) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> DynTrait
//! # { unimplemented!(); }
//! }
//!
//! DynTrait::builder()
//!   .function(Box::new(|x| x + 1))
//!   .build();
//! ```
//!
//! #### Implement `Into`
//!
//! Blueprints:
//! * [`blueprint_typestate_named.rs`][blueprint_typestate_named.rs]
//! * [`blueprint_panic_named.rs`][blueprint_panic_named.rs]
//! * [`blueprint_result_named.rs`][blueprint_result_named.rs]
//!
//! Builders implement [`Into`] for target type (and reverse [`From`] also). Except for `Result` mode which uses [`TryInto`] / [`TryFrom`].
//!
//! ```
//! # #[macro_use] extern crate macon;
//! # #[derive(Builder)]
//! # struct MyStruct {
//! #   value: String,
//! # };
//! let _mytuple: MyStruct = MyStruct::builder()
//!     .value("foobar")
//!     .into();
//! ```
//!
//! #### `Option` fields
//!
//! Blueprints:
//! * [`blueprint_typestate_option.rs`][blueprint_typestate_option.rs]
//! * [`blueprint_panic_option.rs`][blueprint_panic_option.rs]
//! * [`blueprint_result_option.rs`][blueprint_result_option.rs]
//!
//! As their name suggests, [`Option`] fields are facultative: you can build instance without setting them explicitly.
//!
//! Setter argument are still generic over [`Into`] but for wrapped type. No need to wrap into an [`Option`]:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! struct WithOptional {
//!   mandatory: String,
//!   discretionary: Option<String>,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn mandatory(self, value: String) -> Self
//! # { unimplemented!(); }
//!   fn discretionary(self, value: String) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> WithOptional
//! # { unimplemented!(); }
//! }
//!
//! let built = WithOptional::builder()
//!   .discretionary("optional value")
//!   .mandatory("some value")
//!   .build();
//!
//! assert_eq!(Some(String::from("optional value")), built.discretionary);
//! ```
//!
//! You can set them explicitly to [`None`](https://doc.rust-lang.org/core/option/enum.Option.html#variant.None) with `<field>_none()` or `none()` for ordered setter:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! pub struct WithOptional {
//!   mandatory: String,
//!   discretionary: Option<String>,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn mandatory<V: Into<String>>(self, value: V) -> Self
//! # { unimplemented!(); }
//!   fn discretionary_none(self) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> WithOptional
//! # { unimplemented!(); }
//! }
//!
//! let built = WithOptional::builder()
//!   .discretionary_none()
//!   .mandatory("some value")
//!   .build();
//!
//! assert_eq!(None, built.discretionary);
//! ```
//!
//! <div class="warning">
//!
//! Note: In order to detect optional fields, field type **name** must match:
//!
//! * `core::option::Option`
//! * `::core::option::Option`
//! * `std::option::Option`
//! * `::std::option::Option`
//! * `Option`
//!
//! </div>
//!
//! You can disable [`Option`] support by using `#[builder(Option=!)]` at struct or field level:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! #[builder(Option=!)]
//! struct DisableOptionStruct {
//!   discretionary: Option<String>,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn discretionary(self, value: Option<String>) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> DisableOptionStruct
//! # { unimplemented!(); }
//! }
//!
//! let built = DisableOptionStruct::builder()
//!   .discretionary(Some(String::from("mandatory value")))
//!   .build();
//!
//! assert_eq!(Some(String::from("mandatory value")), built.discretionary);
//! ```
//!
//! If you use an alias, use `#[builder(Option=<WrappedType>)]` at field level to enable [`Option`] support:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! type OptString = Option<String>;
//! #[derive(Builder)]
//! struct AliasedOptionStruct {
//!   #[builder(Option=String)]
//!   discretionary: OptString,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn discretionary(self, value: String) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> AliasedOptionStruct
//! # { unimplemented!(); }
//! }
//!
//! let built = AliasedOptionStruct::builder()
//!   .discretionary("aliased value")
//!   .build();
//!
//! assert_eq!(Some(String::from("aliased value")), built.discretionary);
//! ```
//!
//! If you are already dealing with [`Option`], use `<field>_optional` or `optional` for ordered setter:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! struct WithOptional {
//!   discretionary: Option<String>,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn discretionary_optional(self, value: Option<String>) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> Self
//! # { unimplemented!(); }
//! }
//!
//! let discretionary = Some("any");
//! let built = WithOptional::builder()
//!   .discretionary_optional(discretionary)
//!   .build();
//!
//! assert_eq!(Some(String::from("any")), built.discretionary);
//! ```
//!
//! #### `Default` struct
//!
//! Blueprints:
//! * [`blueprint_typestate_default_struct.rs`][blueprint_typestate_default_struct.rs]
//! * [`blueprint_panic_default_struct.rs`][blueprint_panic_default_struct.rs]
//! * [`blueprint_result_default_struct.rs`][blueprint_result_default_struct.rs]
//!
//! If struct derives [`Default`], all fields are then optional and values are kept from default instance:
//!
//! <div class="warning">
//!
//! Note: In order to detect [`Default`] derive, `Builder` derive attribute must be placed before other derive attributes.
//!
//! </div>
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder,)]
//! #[derive(Default,PartialEq,Debug,)]
//! struct DeriveDefaultStruct {
//!   integer: usize,
//!   string: String,
//!   optional: Option<String>,
//! }
//!
//! let built = DeriveDefaultStruct::builder()
//!   .build();
//!
//! assert_eq!(
//!   DeriveDefaultStruct {
//!     integer: 0,
//!     string: String::from(""),
//!     optional: None,
//!   },
//!   built,
//! );
//! ```
//!
//! In case [`Default`] derive detection is undesired, you can disable it with `#[builder(Default=!)]`.
//!
//! On the other hand, if have your own [`Default`] implementation, you can add `#[builder(Default)]` to enable support.
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder,)]
//! #[derive(PartialEq,Debug,)]
//! #[builder(Default,)]
//! struct CustomDefaultStruct {
//!   integer: usize,
//!   string: String,
//!   optional: Option<String>,
//! }
//!
//! impl Default for CustomDefaultStruct {
//!     fn default() -> Self {
//!         CustomDefaultStruct {
//!             integer: 42,
//!             string: String::from("plop!"),
//!             optional: Some(String::from("some")),
//!         }
//!     }
//! }
//!
//! let built = CustomDefaultStruct::builder()
//!   .build();
//!
//! assert_eq!(
//!   CustomDefaultStruct {
//!     integer: 42,
//!     string: String::from("plop!"),
//!     optional: Some(String::from("some")),
//!   },
//!   built,
//! );
//! ```
//!
//! You can keep default value (from default built instance) explicitly with `<field>_keep()` or `keep()` for ordered setter:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! # #[derive(Builder,)]
//! # #[derive(PartialEq,Debug,)]
//! # #[builder(Default,)]
//! # struct CustomDefaultStruct {
//! #  integer: usize,
//! #  string: String,
//! #  optional: Option<String>,
//! # }
//! #
//! # impl Default for CustomDefaultStruct {
//! #     fn default() -> Self {
//! #         CustomDefaultStruct {
//! #             integer: 42,
//! #             string: String::from("plop!"),
//! #             optional: Some(String::from("some")),
//! #         }
//! #     }
//! # }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn integer<V: Into<usize>>(self, value: V) -> Self
//! # { unimplemented!(); }
//!   fn integer_keep(self) -> Self
//! # { unimplemented!(); }
//!   fn string<V: Into<String>>(self, value: V) -> Self
//! # { unimplemented!(); }
//!   fn string_keep(self) -> Self
//! # { unimplemented!(); }
//!   fn optional<V: Into<String>>(self, value: V) -> Self
//! # { unimplemented!(); }
//!   fn optional_none(self) -> Self
//! # { unimplemented!(); }
//!   fn optional_keep(self) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> CustomDefaultStruct
//! # { unimplemented!(); }
//! }
//!
//! let built = CustomDefaultStruct::builder()
//!   .integer_keep()
//!   .string("overriden")
//!   .optional_none()
//!   .build();
//!
//! assert_eq!(
//!   CustomDefaultStruct {
//!     integer: 42,
//!     string: String::from("overriden"),
//!     optional: None,
//!   },
//!   built,
//! );
//! ```
//!
//! #### `Default` fields
//!
//! Blueprints:
//! * [`blueprint_typestate_default_field.rs`][blueprint_typestate_default_field.rs]
//! * [`blueprint_panic_default_field.rs`][blueprint_panic_default_field.rs]
//! * [`blueprint_result_default_field.rs`][blueprint_result_default_field.rs]
//!
//! If field implements [`Default`], it is then optional and value is:
//!
//! 1. kept from default instance if [struct derives `Default`](#default-struct),
//! 1. or, initialized with default value.
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! #[derive(Debug,PartialEq,)]
//! struct WithDefaultFields {
//!   integer: usize,
//!   string: String,
//!   optional: Option<String>,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn integer<V: Into<usize>>(self, value: V) -> Self
//! # { unimplemented!(); }
//!   fn integer_default(self) -> Self
//! # { unimplemented!(); }
//!   fn string<V: Into<String>>(self, value: V) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> WithDefaultFields
//! # { unimplemented!(); }
//! }
//!
//! let built = WithDefaultFields::builder()
//!   .build();
//!
//! assert_eq!(
//!   WithDefaultFields {
//!     integer: 0,
//!     string: String::from(""),
//!     optional: None,
//!   },
//!   built,
//! );
//! ```
//!
//! You can set them explicitly to default with `<field>_default()` or `default()` for ordered setter (e.g. [override default instance value](#default-struct)):
//!
//! ```
//! # #[macro_use] extern crate macon;
//! # #[derive(Builder)]
//! # #[derive(Debug,PartialEq,)]
//! # struct WithDefaultFields {
//! #   integer: usize,
//! #   string: String,
//! #   optional: Option<String>,
//! # }
//! #
//! let built = WithDefaultFields::builder()
//!   .integer_default()
//!   .string_default()
//!   .optional_default()
//!   .build();
//!
//! assert_eq!(
//!   WithDefaultFields {
//!     integer: 0,
//!     string: String::from(""),
//!     optional: None,
//!   },
//!   built,
//! );
//! ```
//!
//! <div class="warning">
//!
//! In order to detect default fields, field type **name** must match (leading `::` and module path are optionals):
//!
//! * `bool`
//! * `char`
//! * `f32`
//! * `f64`
//! * `i8`
//! * `i16`
//! * `i32`
//! * `i64`
//! * `i128`
//! * `isize`
//! * `str`
//! * `u8`
//! * `u16`
//! * `u32`
//! * `u64`
//! * `u128`
//! * `usize`
//! * `std::string::String`
//! * `core::option::Option`
//! * `std::option::Option`
//! * `std::vec::Vec`
//! * `alloc::vec::Vec`
//! * `std::collections::HashMap`
//! * `std::collections::hash_map::HashMap`
//! * `std::collections::HashSet`
//! * `std::collections::hash_set::HashSet`
//!
//! </div>
//!
//! If you use an alias or unsupported type, use `#[builder(Default)]` at field level to enable [`Default`] support:
//!
//! ```
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! #[derive(Debug,PartialEq,)]
//! struct ExplicitDefaultOnField {
//!   #[builder(Default)]
//!   boxed: Box<usize>,
//! }
//!
//! // Builder signature
//! # struct Builder;
//! impl Builder {
//!   fn boxed<V: Into<Box<usize>>>(self, value: V) -> Self
//! # { unimplemented!(); }
//!   fn boxed_default(self) -> Self
//! # { unimplemented!(); }
//!   fn build(self) -> ExplicitDefaultOnField
//! # { unimplemented!(); }
//! }
//!
//! let built = ExplicitDefaultOnField::builder()
//!     .build();
//!
//! assert_eq!(
//!   ExplicitDefaultOnField {
//!     boxed: Box::from(0),
//!   },
//!   built,
//! );
//! ```
//!
//! You can disable [`Default`] support by using `#[builder(Default=!)]` at field level:
//!
//! ```compile_fail
//! # #[macro_use] extern crate macon;
//! #[derive(Builder)]
//! struct DisableDefaultOnField {
//!   #[builder(Default=!)]
//!   integer: usize,
//! }
//!
//! DisableDefaultOnField::builder()
//!   .integer_default()
//!   .build();
//! ```
//!
//!
//! [tests]: https://github.com/loganmzz/macon-rs/tree/1.3.0/tests
//! [blueprint_panic_default_field.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_panic_default_field.rs
//! [blueprint_panic_default_struct.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_panic_default_struct.rs
//! [blueprint_panic_named.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_panic_named.rs
//! [blueprint_panic_option.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_panic_option.rs
//! [blueprint_panic_tuple.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_panic_tuple.rs
//! [blueprint_result_default_field.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_result_default_field.rs
//! [blueprint_result_default_struct.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_result_default_struct.rs
//! [blueprint_result_named.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_result_named.rs
//! [blueprint_result_option.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_result_option.rs
//! [blueprint_result_tuple.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_result_tuple.rs
//! [blueprint_typestate_default_field.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_typestate_default_field.rs
//! [blueprint_typestate_default_struct.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_typestate_default_struct.rs
//! [blueprint_typestate_named.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_typestate_named.rs
//! [blueprint_typestate_option.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_typestate_option.rs
//! [blueprint_typestate_tuple.rs]: https://github.com/loganmzz/macon-rs/blob/1.3.0/tests/blueprint_typestate_tuple.rs
//!

pub use ::macon_derive::*;
pub use ::macon_api::*;