Keeps yaml comments and formatting, can specify yaml tags when updating.
Can print out matching paths and values when splatting, more info here.
JSON output works for all commands! Yaml files with multiple documents are printed out as one JSON document per line, more info here
Deep splat (
**) to match arbitrary paths and match nodes by their children, more info here
In V3 users are able to better control how values are treated when updating YAML by using a new
--tag argument (see more info here). A result of this however, is that quoting values, e.g. "true" will no longer have an effect on how the value is interpreted like it did in V2.
For instance, to get the string "true" into a yaml file:
yq n a.path '"true"'
yq n a.path --tag '!!str' true
In V2 this would return null, V3 does not return anything.
Similarly, reading null yaml values
~ and , V2 returns null whereas V3 returns the values as is.
This is a result of taking effort not to format values coming in and out of the original YAML.
Comments can be added, and delete commands have been introduced.
b.e[+].name: Mike Farah
- command: updatepath: b.e[+].thingvalue:#greatthings: frog # wow!- command: deletepath: b.d
parent:childA:no: matches herechildB:there: matcheshi: no matchthere2: also matches
yq r sample.yaml 'parent.*.there*'
- null- - matches- also matches
As JSON is a subset of YAML, and
yq now preserves the formatting of the passed in document, you will most likely need to use the
--prettyPrint flag to format the JSON document as idiomatic YAML. See Working with JSON for more info.