serde_sono 0.5.0

Sono data format de-/serialization implementations for serde
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

# serde_sono

A [serde](https://serde.rs/) de-/serializer for the [Sono data format](https://github.com/xitep/sono).


# Example

```rust
    use serde::Deserialize;

    #[derive(Deserialize, Debug)]
    struct Hobby(String);

    #[derive(Deserialize, Debug)]
    struct Person {
        name: String,
        age: u32,
        hobby: Hobby,
        #[serde(default)]
        friends: Vec<Person>,
    }

    fn main() {
        let input = r#"

Person {
    name: "katie",
    age: 10,
    hobby: "reading",
    friends: [
        { name: "tom", age: 33, hobby: "writing" },
        Person("bea", 9, Hobby("transpiling"), []),
        Person { name: "josh", hobby: "dreaming", age: 12 },
    ]
}

"#;
        match serde_sono::from_str::<Person>(input) {
            Err(e) => println!("syntax error: {e:#}"),
            Ok(value) => println!("{value:#?}"),
        }
    }
```


# SONO language

See https://github.com/xitep/sono


# TODOs

- [ ] Pretty formatting when serializing
- [X] Generic data model `serde_sono::Value`
- [X] Efficient value skipping / ignoring
- [ ] Documentation
- [ ] Measure and tweak performance

# Features

- *value*: enabled by default; guards the `serde_sono::Value` type

- *lossless-serialize-value-leaking*: Implements `serde::Serialize`
  for `serde_sono::Value` producing a lossless presentation of the
  serialized values at the cost of leaking memory for object names and
  property keys to support serializes which do retain references to
  these.
  
  The feature is disabled by default and results in objects being
  serialized as lists and/or maps of their properties.
  
  This feature is an alternative to `lossless-serialize-value-unsafe`.

- *lossless-serialize-value-unsafe*: Implements `serde::Serialize` for
  `serde_sono::Value` producing a lossless presentation of the
  serialized values by assuming that the used serializer does not
  retain references to the handed object and property names.  (The
  serializer provided by `serde_sono`, for example, does not.)
  
  The feature is disabled by default and results in objects being
  serialized as lists and/or maps of their properties.
  
  This feature is an alternative to `lossless-serialize-value-leaking`.