1// Package parser implements decoding and encoding between a flat map of labels and a typed Configuration.
2package parser
3
4// Decode decodes the given map of labels into the given element.
5// If any filters are present, labels which do not match the filters are skipped.
6// The operation goes through three stages roughly summarized as:
7// labels -> tree of untyped nodes
8// untyped nodes -> nodes augmented with metadata such as kind (inferred from element)
9// "typed" nodes -> typed element.
10func Decode(labels map[string]string, element interface{}, rootName string, filters ...string) error {
11	node, err := DecodeToNode(labels, rootName, filters...)
12	if err != nil {
13		return err
14	}
15
16	metaOpts := MetadataOpts{TagName: TagLabel, AllowSliceAsStruct: true}
17	err = AddMetadata(element, node, metaOpts)
18	if err != nil {
19		return err
20	}
21
22	return Fill(element, node, FillerOpts{AllowSliceAsStruct: true})
23}
24
25// Encode converts an element to labels.
26// element -> node (value) -> label (node).
27func Encode(element interface{}, rootName string) (map[string]string, error) {
28	etnOpts := EncoderToNodeOpts{OmitEmpty: true, TagName: TagLabel, AllowSliceAsStruct: true}
29	node, err := EncodeToNode(element, rootName, etnOpts)
30	if err != nil {
31		return nil, err
32	}
33
34	return EncodeNode(node), nil
35}
36