yq/pkg/yqlib/doc/operators/flatten.md

Flatten

This recursively flattens arrays.

Flatten

Recursively flattens all arrays

Given a sample.yml file of:

[1, [2], [[3]]]

then

yq 'flatten' sample.yml

will output

[1, 2, 3]

Flatten with depth of one

Given a sample.yml file of:

[1, [2], [[3]]]

then

yq 'flatten(1)' sample.yml

will output

[1, 2, [3]]

Flatten empty array

Given a sample.yml file of:

[[]]

then

yq 'flatten' sample.yml

will output

[]

Flatten array of objects

Given a sample.yml file of:

[{foo: bar}, [{foo: baz}]]

then

yq 'flatten' sample.yml

will output

[{foo: bar}, {foo: baz}]