Recursive Descent (Glob)
This operator recursively matches (or globs) all children nodes given of a particular element, including that node itself. This is most often used to apply a filter recursively against all matches.
This will, like the
jq equivalent, recursively match all value nodes. Use it to find/manipulate particular values.For instance to set the
style of all value nodes in a yaml doc, excluding map keys:yq '.. style= "flow"' file.yaml
The also includes map keys in the results set. This is particularly useful in YAML as unlike JSON, map keys can have their own styling and tags and also use anchors and aliases.
For instance to set the
style of all nodes in a yaml doc, including the map keys:yq '... style= "flow"' file.yaml
Given a sample.yml file of:
a: frog
then
yq '..' sample.yml
will output
a: frog
frog
Note that this example has wrapped the expression in
[] to show that there are two matches returned. You do not have to wrap in [] in your path expression.Given a sample.yml file of:
a:
name: frog
b:
name: blog
age: 12
then
yq '[.. | select(has("name"))]' sample.yml
will output
- name: frog
b:
name: blog
age: 12
- name: blog
age: 12
Given a sample.yml file of:
a:
nameA: frog
b:
nameB: frog
age: 12
then
yq '.. | select(. == "frog")' sample.yml
will output
frog
frog
Note that the map key appears in the results
Given a sample.yml file of:
a: frog
then
yq '...' sample.yml
will output
a: frog
a
frog
Given a sample.yml file of:
a: &cat
c: frog
b: *cat
then
yq '[..]' sample.yml
will output
- a: &cat
c: frog
b: *cat
- &cat
c: frog
- frog
- *cat
Given a sample.yml file of:
foo: &foo
a: foo_a
thing: foo_thing
c: foo_c
bar: &bar
b: bar_b
thing: bar_thing
c: bar_c
foobarList:
b: foobarList_b
!!merge <<:
- *foo
- *bar
c: foobarList_c
foobar:
c: foobar_c
!!merge <<: *foo
thing: foobar_thing
then
yq '.foobar | [..]' sample.yml
will output
- c: foobar_c
!!merge <<: *foo
thing: foobar_thing
- foobar_c
- *foo
- foobar_thing
Last modified 6mo ago