feat(xstructs): custom tags

[ChBLA]

Adding support for custom tag ordering, allowing consumers to decide which tags should be considered and in which order.
Previously, consumers using e.g.

type A struct {
    B string `json:"-" yaml:"b"`
}

would see B omitted, as it prioritised JSON tags over YAML tags.

Now consumers can use:

xstructs.ToMap(s, xstructs.WithTags([]string{"yaml", "json"})

To prioritise YAML tags over JSON tags.

[alex5517]

@ChBLA,

Does providing a list of tags: xstructs.ToMap(s, xstructs.WithTags("yaml", "json")) make a difference if we only consider this first one?

[alex5517]

@ChBLA,

What behavior would be desired if tags were json:"values" yaml:",inline,omitempty" currently default would be to return:

Name: "values"
Options: []string{}

This might be the desired behavior 🤔

[ChBLA]

@ChBLA,

Does providing a list of tags: xstructs.ToMap(s, xstructs.WithTags("yaml", "json")) make a difference if we only consider this first one?

Yes, if, for example, you define the tags as xstructs.WithTags("yaml", "json"), but some struct fields (or all) do not contain yaml, it will use the json tags instead.

[ChBLA]

@ChBLA,

What behavior would be desired if tags were json:"values" yaml:",inline,omitempty" currently default would be to return:

Name: "values"
Options: []string{}

This might be the desired behavior 🤔

This is the behaviour using the default tag ordering (of json before yaml). If, instead, the desired result is to return:

Name: ""
Options: []string{"inline", "omitempty"}

Use xstructs.WithTags("yaml", "json")