yog-data 0.3.1

Yog Data — the one data model, text syntax, binary form and schema system of every Yog format.
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

//! JSON ⇄ Yog Data (feature `json`): for what still speaks JSON — a
//! `serde` type, a file of the game's own format — on its way into a blob.

use crate::value::{Map, Value};

/// `j` as Yog Data (integers stay integers).
pub fn from_json(j: &serde_json::Value) -> Value {
    match j {
        serde_json::Value::Null => Value::Null,
        serde_json::Value::Bool(b) => Value::Bool(*b),
        serde_json::Value::Number(n) => n.as_i64().map(Value::Int).unwrap_or_else(|| Value::Float(n.as_f64().unwrap_or(0.0))),
        serde_json::Value::String(s) => Value::Str(s.clone()),
        serde_json::Value::Array(a) => Value::List(a.iter().map(from_json).collect()),
        serde_json::Value::Object(o) => Value::Map(o.iter().map(|(k, v)| (k.clone(), from_json(v))).collect::<Map>()),
    }
}

/// JSON text as Yog Data, `None` if it isn't JSON.
pub fn from_json_text(text: &str) -> Option<Value> {
    serde_json::from_str(text).ok().map(|j| from_json(&j))
}

/// `v` as JSON; typed values become their string forms (`"@item:minecraft:stick"`).
pub fn to_json(v: &Value) -> serde_json::Value {
    match v {
        Value::Null => serde_json::Value::Null,
        Value::Bool(b) => serde_json::Value::Bool(*b),
        Value::Int(n) => serde_json::Value::from(*n),
        Value::Float(f) => serde_json::Number::from_f64(*f).map_or(serde_json::Value::Null, serde_json::Value::Number),
        Value::Str(s) => serde_json::Value::String(s.clone()),
        Value::List(items) => serde_json::Value::Array(items.iter().map(to_json).collect()),
        Value::Map(m) => serde_json::Value::Object(m.iter().map(|(k, v)| (k.to_string(), to_json(v))).collect()),
        typed => serde_json::Value::String(crate::typed::typed_string(typed).unwrap_or_default()),
    }
}

/// A `serde` value as Yog Data.
pub fn from_serde<T: serde::Serialize>(t: &T) -> Value {
    serde_json::to_value(t).map(|j| from_json(&j)).unwrap_or(Value::Null)
}

/// Yog Data read as a `serde` type.
pub fn to_serde<T: serde::de::DeserializeOwned>(v: &Value) -> Result<T, String> {
    serde_json::from_value(to_json(v)).map_err(|e| e.to_string())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn round_trips() {
        let j = serde_json::json!({ "a": [1, 2.5, "x", null, true], "b": { "c": -3 } });
        assert_eq!(to_json(&from_json(&j)), j);
    }
}