Evaluate

Note that (as of 4.18.1) this is the default command when none is supplied to yq.
Usage:
1
yq eval [expression] [yaml_file1]... [flags]
Copied!
Aliases: eval, e
Note that you can pass in - as a filename to pipe from STDIN.
Examples:
1
# runs the expression against each file, in series
2
yq '.a.b | length' f1.yml f2.yml 
3
​
4
# '-' will pipe from STDIN
5
cat file.yml | yq '.a.b' f1.yml -  f2.yml
6
​
7
# prints out the file
8
yq sample.yaml 
9
cat sample.yml | yq e
10
​
11
# prints a new yaml document
12
yq -n '.a.b.c = "cat"' 
13
​
14
# updates file.yaml directly
15
yq '.a.b = "cool"' -i file.yaml 
Copied!
Flags:
1
  -h, --help          help for eval
2
  -C, --colors        force print with colors
3
  -e, --exit-status   set exit status if there are no matches or null or false is returned
4
  -I, --indent int    sets indent level for output (default 2)
5
  -i, --inplace       update the yaml file inplace of first yaml file given.
6
  -M, --no-colors     force print with no colors
7
  -N, --no-doc        Don't print document separators (---)
8
  -n, --null-input    Don't read input, simply evaluate the expression given. Useful for creating yaml docs from scratch.
9
  -j, --tojson        output as json. Set indent to 0 to print json in one line.
10
  -v, --verbose       verbose mode
Copied!

Upgrading from V3

Next - Commands

Evaluate All

Last modified 3mo ago

Copy link

Contents

Usage:

Examples:

Flags: