#miniserde #enum

macro miniserde-enum

Derive macros for miniserde on enums

4 releases

0.1.3 Nov 19, 2019
0.1.2 Nov 18, 2019
0.1.1 Nov 18, 2019
0.1.0 Nov 18, 2019

#1782 in Parser implementations

36 downloads per month

MIT/Apache

41KB
927 lines

miniserde-enum

Build

This crate exposes derive macros for miniserde's Serialize and Deserialize traits on enums.

The goal of this crate is to provide enum support like that of Serde for miniserde (see Serde's list of enum representations).

Examples

Deserializing an externally tagged enum

use miniserde::{Deserialize, json};
use miniserde_enum::Deserialize_enum;

#[derive(Deserialize_enum, Debug, PartialEq)]
enum External {
    A(i32),
    #[serde(rename = "renamedB")]
    B(i32, String),
    C {
        x: i32,
    },
    D,
}
use External::*;

let example = r#"[{"A":21},{"renamedB":[42,"everything"]},{"C":{"x":2}},"D"]"#;
let actual: Vec<External> = json::from_str(example).unwrap();
let expected = [A(21), B(42, "everything".to_string()), C { x: 2 }, D];
assert_eq!(actual, expected);

Serializing an internally tagged enum

use miniserde::{json, Serialize};
use miniserde_enum::Serialize_enum;

#[serde(tag = "type")]
#[derive(Serialize_enum)]
enum Internal {
    A,
    #[serde(rename = "renamedB")]
    B,
    C {
        x: i32,
    },
}
use Internal::*;

let example = [A, B, C { x: 2 }];
let actual = json::to_string(&example[..]);
let expected = r#"[{"type":"A"},{"type":"renamedB"},{"type":"C","x":2}]"#;
assert_eq!(actual, expected);

More examples can be found in the tests directory.

Limitations

Deserializing internally tagged enums and adjacently tagged enums requires the tag to be the first key in the object, otherwise from_str will return an error.

Additionally, not every enum representation is currently supported (see TODO).

TODO

  • Serialization:
    • Externally tagged enums
    • Internally tagged enums
    • Untagged enums
    • Adjacently tagged enums
  • Deserialization
    • Externally tagged enums
    • Internally tagged enums
    • Untagged enums
    • Adjacently tagged enums

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.5–1MB
~22K SLoC