April 12, 2023

Hi All,

Can some point me where i can find examples on how to use mir-ion YAML

From,
Vino.B

April 12, 2023

On Wednesday, 12 April 2023 at 12:00:14 UTC, Vino wrote:

>

Hi All,

Can some point me where i can find examples on how to use mir-ion YAML

From,
Vino.B

documentation is very sparse, but essentially with mir-ion you import the different ser/deser packages that you would like to use. If you for example want to deserialize YAML to a custom struct, you use

import mir.deser.yaml;

struct CustomStruct
{
    string foo;
    uint bar;
}

void main()
{
    string yamlString = `{foo: str, bar: 4}`;
    CustomStruct s = yamlString.deserializeYaml!CustomStruct;

    assert(s == S("str", 4));
}

If you want to deserialize arbitrary values and introspect them at runtime, you use YamlAlgebraic instead of CustomStruct, which you can think of like std.json : JSONValue, but utilizes mir's algebraic structures, which work more like std.sumtype.

To convert algebraic values to custom structs later, you use mir.ion.conv : serde, which basically just internally serializes the data and deserializes it again (but a little more efficiently)

more deserialization examples in the unittests: https://github.com/libmir/mir-ion/blob/62c476a6a00d0d5ddfb3585bdfbe520d825e872b/source/mir/deser/yaml.d

and for serialization you use serializeYaml from mir.ser.yaml, see https://github.com/libmir/mir-ion/blob/62c476a6a00d0d5ddfb3585bdfbe520d825e872b/source/mir/ser/yaml.d