yq
v3.x
v3.x
  • yq
  • Upgrading from V2
  • Commands
    • Read
    • Validate
    • Compare
    • Write
    • Create
    • Delete
    • Merge
    • Prefix
    • Shell Completion
  • Usage
    • Output format
    • Path Expressions
    • Value Parsing
    • Working with JSON
  • Github Page
Powered by GitBook
On this page
  • Example data
  • Basic
  • Formatted
  • Using path expressions

Was this helpful?

  1. Commands

Compare

Deeply compare two yaml documents

PreviousValidateNextWrite

Last updated 5 years ago

Was this helpful?

yq compare <yaml_file_1> <yaml_file_2> <path_expression>

Compares the matching yaml nodes at path expression in the two yaml documents. See for more details. Difference calculated line by line, and is printed out line by line where the first character of each line is either:

  • a space, indicating no change at this line

  • - a minus ,indicating the line is not present in the second document (it's removed)

  • + a plus, indicating that the line is not present in the first document (it's added)

If there are differences then yq will print out the differences and exit with code 1. If there are no differences, then nothing will be printed and the exit code will be 0.

Example data

Given data1.yaml

"apples": are nice
somethingElse: cool # this is nice
favouriteNumbers: [1,2,3]
noDifference: it's the same

and data2.yaml

apples: are nice
somethingElse: cool # yeah i like it
favouriteNumbers:
- 1
- 3
- 4
noDifference: it's the same

Basic

Basic will compare the yaml documents 'as-is'

yq compare data1.yaml data2.yaml

yields

-"apples": are nice
-somethingElse: cool # this is nice
-favouriteNumbers: [1, 2, 3]
+apples: are nice
+somethingElse: cool # yeah i like it
+favouriteNumbers:
+- 1
+- 3
+- 4
 noDifference: it's the same

Formatted

yq compare --prettyPrint data1.yaml data2.yml

yields

 apples: are nice
-somethingElse: cool # this is nice
+somethingElse: cool # yeah i like it
 favouriteNumbers:
 - 1
-- 2
 - 3
+- 4
 noDifference: it's the same

Using path expressions

yq compare -P data1.yaml data2.yml favouriteNumbers

yields

 - 1
-- 2
 - 3
+- 4

Most of the time, it will make sense to the documents before comparing:

Use to compare subsets of yaml documents

path expression
path expressions
format