yq/pkg/yqlib/doc/With.md

Use the with operator to conveniently make multiple updates to a deeply nested path, or to update array elements relatively to each other.

Update and style

Given a sample.yml file of:

a:
  deeply:
    nested: value

then

yq eval 'with(.a.deeply.nested ; . = "newValue" | . style="single")' sample.yml

will output

a:
  deeply:
    nested: 'newValue'

Update multiple deeply nested properties

Given a sample.yml file of:

a:
  deeply:
    nested: value
    other: thing

then

yq eval 'with(.a.deeply ; .nested = "newValue" | .other= "newThing")' sample.yml

will output

a:
  deeply:
    nested: newValue
    other: newThing

Update array elements relatively

Given a sample.yml file of:

myArray:
  - a: apple
  - a: banana

then

yq eval 'with(.myArray[] ; .b = .a + " yum")' sample.yml

will output

myArray:
  - a: apple
    b: apple yum
  - a: banana
    b: banana yum