enser 0.1.1

Enum serialization with tag
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

# ✒️ enser

[![Crates.io](https://img.shields.io/crates/v/enser.svg)](https://crates.io/crates/enser)
[![docs.rs](https://img.shields.io/docsrs/enser)](https://docs.rs/enser)
[![CI](https://github.com/azriel91/enser/workflows/CI/badge.svg)](https://github.com/azriel91/enser/actions/workflows/ci.yml)
[![Coverage Status](https://codecov.io/gh/azriel91/enser/branch/main/graph/badge.svg)](https://codecov.io/gh/azriel91/enser)

Enum Serialization with Tag


## Usage

Add the following to `Cargo.toml`

```toml
enser = "0.1.1"
```

```diff
  #[derive(Debug, Deserialize, Serialize)]
+ #[enser::enser]
  enum MyEnum {
      Tbd,
      None,
      Some(u32),
      Named { value: u32 },
  }
```


## Rationale

Given the following enum:

```rust
#[derive(Debug, Deserialize, Serialize)]
enum MyEnum {
    Tbd,
    None,
    Some(u32),
    Named { value: u32 },
}
```

When serializing `Vec<MyEnum>`, the output is:

```yaml
# serde_yaml
my_enums:
- Tbd
- None
- !Some 123
- !Named
  value: 456

# serde_json
{
  "without_tuple": [
    "Tbd",
    "None",
    { "Some": 123 }
    { "Named": { "value": 456 } }
  ]
}
```

When the `#[enser::enser]` attribute is added:

```diff
  #[derive(Debug, Deserialize, Serialize)]
+ #[enser::enser]
  enum MyEnum { .. }
```

The output is:

```yaml
# serde_yaml -- a !Tag is used for each variant
my_enums:
- !Tbd null
- !None null
- !Some 123
- !Named
  value: 456

# serde_json -- every variant is an object
{
  "my_enums": [
    { "Tbd": null },
    { "None": null },
    { "Some": 123 },
    { "Named": { "value": 456 } }
  ]
}
```

## License

Licensed under either of

* Apache License, Version 2.0, ([LICENSE-APACHE] or <https://www.apache.org/licenses/LICENSE-2.0>)
* MIT license ([LICENSE-MIT] or <https://opensource.org/licenses/MIT>)

at your option.

### 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 dual licensed as above, without any additional terms or conditions.

[LICENSE-APACHE]: LICENSE-APACHE
[LICENSE-MIT]: LICENSE-MIT