enum_builder 0.1.6

Simple macros that allow building enum types from variants that can be defined in multiple dispersed files in the crate.
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

# enum_builder
Simple macros that allow building enum types from variants that can be defined in multiple dispersed files in the crate.

[![Crates.io](https://img.shields.io/crates/v/enum_builder)](https://crates.io/crates/enum_builder)
[![Documentation](https://img.shields.io/docsrs/enum_builder)](https://docs.rs/enum_builder/latest/enum_builder/)
[![License](https://img.shields.io/github/license/garfunkel/enum_builder)](https://github.com/garfunkel/enum_builder/blob/master/LICENSE)
[![GitHub](https://img.shields.io/github/stars/garfunkel/enum_builder)](https://github.com/garfunkel/enum_builder)

## Example
#### main.rs
```rust
mod animals;

use animals::*;

#[enum_builder]
enum Animal {}

// expanded result
// enum Animal {
//     Dog(Dog),
//     Cow(Cow),
//     Fish(Fish),
// }
```

#### animals.rs
```rust
#[enum_builder_variant(Animal)]
struct Dog {}

#[enum_builder_variant(Animal)]
struct Cow {}

#[enum_builder_variant(Animal)]
struct Fish {}
```

## Tips
It can be very useful to combine this crate with the
[enum_dispatch](https://docs.rs/enum_dispatch/latest/enum_dispatch) crate, to allow for a simple
"plugin" architecture without the overhead of dynamic dispatch. When doing this, take care to note
that the order of macros is important, as [enum_builder](https://docs.rs/enum_builder/latest/enum_builder/attr.enum_builder.html) must be used before
[enum_dispatch](https://docs.rs/enum_dispatch/latest/enum_dispatch/attr.enum_dispatch.html).

#### Example
```rust
#[enum_builder]
#[enum_dispatch]
enum Animal {}
```