Buildstructor
Derive a builder from a constructor!
Use this if you want a derived builder but with less annotation magic.
Installation:
Add the dependency to your Cargo.toml
[]
= "*"
Usage / Example:
- Import the
builder
macro. - Annotate your
impl
containing anew
function. - Use your automatically derived builder.
use builder;
Motivation
The difference between this and other builder crates is that constructors are used to derive builders rather than structs. This results in a more natural fit with regular Rust code, and no annotation magic to define behavior.
Advantages:
- You can specify fields in your constructor that do not appear in your struct.
- No magic to default values, just use an
Option
param in your constructor and default as normal. async
constructors derivesasync
builders.- Fallible constructors (
Result
) derives fallible builders. - Special
Vec
,HashMap
,HashSet
,BTreeMap
,BTreeSet
support. Add single or multiple items.
This crate is heavily inspired by the excellent typed-builder crate. It is a good alternative to this crate and well worth considering.
Recipes
All of these recipes and more can be found in the examples directory
Just write your rust code as usual and annotate the constructor impl with [builder]
Optional field
Fields that are optional will also be optional in the builder. You should do defaulting in your constructor.
Into field
You can use generics as usual in your constructor.
Async
To create an async
builder just make your constructor async
.
async
Fallible
To create a fallible builder just make your constructor fallible using Result
.
Collections
Vec
, HashMap
, HashSet
, BTreeMap
, BTreeSet
parameters are treated specially. Use the plural form in your constructor argument and buildstructor
will automatically try to figure out the singular form for individual entry.
In the case that a singular form cannot be derived automatically the suffix _entry
will be used.
There had to be some magic somewhere.
TODO
- Transfer docs from the constructor to the generated builder methods.
- Better error messages.
- More testing.
PRs welcome!
License
Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.