Documentation ¶
Index ¶
- func DisallowUnknownFields(d *json.Decoder) *json.Decoder
- func JSONObjectToYAMLObject(j map[string]interface{}) yaml.MapSlice
- func JSONToYAML(j []byte) ([]byte, error)
- func Marshal(obj interface{}) ([]byte, error)
- func Unmarshal(yamlBytes []byte, obj interface{}, opts ...JSONOpt) error
- func UnmarshalStrict(yamlBytes []byte, obj interface{}, opts ...JSONOpt) error
- func YAMLToJSON(y []byte) ([]byte, error)
- func YAMLToJSONStrict(y []byte) ([]byte, error)
- type JSONOpt
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func DisallowUnknownFields ¶ added in v1.1.0
DisallowUnknownFields configures the JSON decoder to error out if unknown fields come along, instead of dropping them by default.
func JSONObjectToYAMLObject ¶ added in v1.2.0
func JSONObjectToYAMLObject(j map[string]interface{}) yaml.MapSlice
JSONObjectToYAMLObject converts an in-memory JSON object into a YAML in-memory MapSlice, without going through a byte representation. A nil or empty map[string]interface{} input is converted to an empty map, i.e. yaml.MapSlice(nil).
interface{} slices stay interface{} slices. map[string]interface{} becomes yaml.MapSlice.
int64 and float64 are down casted following the logic of github.com/go-yaml/yaml: - float64s are down-casted as far as possible without data-loss to int, int64, uint64. - int64s are down-casted to int if possible without data-loss.
Big int/int64/uint64 do not lose precision as in the json-yaml roundtripping case.
string, bool and any other types are unchanged.
func JSONToYAML ¶
JSONToYAML converts JSON to YAML. Notable implementation details:
- Duplicate fields, are case-sensitively ignored in an undefined order.
- The sequence indentation style is compact, which means that the "- " marker for a YAML sequence will be on the same indentation level as the sequence field name.
- Unlike Unmarshal, all integers, up to 64 bits, are preserved during this round-trip.
func Marshal ¶
Marshal marshals obj into JSON using stdlib json.Marshal, and then converts JSON to YAML using JSONToYAML (see that method for more reference)
func Unmarshal ¶
Unmarshal first converts the given YAML to JSON, and then unmarshals the JSON into obj. Options for the standard library json.Decoder can be optionally specified, e.g. to decode untyped numbers into json.Number instead of float64, or to disallow unknown fields (but for that purpose, see also UnmarshalStrict). obj must be a non-nil pointer.
Important notes about the Unmarshal logic:
- Decoding is case-insensitive, unlike the rest of Kubernetes API machinery, as this is using the stdlib json library. This might be confusing to users.
- This decodes any number (although it is an integer) into a float64 if the type of obj is unknown, e.g. *map[string]interface{}, *interface{}, or *[]interface{}. This means integers above +/- 2^53 will lose precision when round-tripping. Make a JSONOpt that calls d.UseNumber() to avoid this.
- Duplicate fields, including in-case-sensitive matches, are ignored in an undefined order. Note that the YAML specification forbids duplicate fields, so this logic is more permissive than it needs to. See UnmarshalStrict for an alternative.
- Unknown fields, i.e. serialized data that do not map to a field in obj, are ignored. Use d.DisallowUnknownFields() or UnmarshalStrict to override.
- As per the YAML 1.1 specification, which yaml.v2 used underneath implements, literal 'yes' and 'no' strings without quotation marks will be converted to true/false implicitly.
- YAML non-string keys, e.g. ints, bools and floats, are converted to strings implicitly during the YAML to JSON conversion process.
- There are no compatibility guarantees for returned error values.
func UnmarshalStrict ¶ added in v1.1.0
UnmarshalStrict is similar to Unmarshal (please read its documentation for reference), with the following exceptions:
- Duplicate fields in an object yield an error. This is according to the YAML specification.
- If obj, or any of its recursive children, is a struct, presence of fields in the serialized data unknown to the struct will yield an error.
func YAMLToJSON ¶
YAMLToJSON converts YAML to JSON. Since JSON is a subset of YAML, passing JSON through this method should be a no-op.
Some things YAML can do that are not supported by JSON:
- In YAML you can have binary and null keys in your maps. These are invalid in JSON, and therefore int, bool and float keys are converted to strings implicitly.
- Binary data in YAML with the !!binary tag is not supported. If you want to use binary data with this library, encode the data as base64 as usual but do not use the !!binary tag in your YAML. This will ensure the original base64 encoded data makes it all the way through to the JSON.
- And more... read the YAML specification for more details.
Notable about the implementation:
- Duplicate fields are case-sensitively ignored in an undefined order. Note that the YAML specification forbids duplicate fields, so this logic is more permissive than it needs to. See YAMLToJSONStrict for an alternative. - As per the YAML 1.1 specification, which yaml.v2 used underneath implements, literal 'yes' and 'no' strings without quotation marks will be converted to true/false implicitly. - Unlike Unmarshal, all integers, up to 64 bits, are preserved during this round-trip. - There are no compatibility guarantees for returned error values.
func YAMLToJSONStrict ¶ added in v1.1.0
YAMLToJSONStrict is like YAMLToJSON but enables strict YAML decoding, returning an error on any duplicate field names.