JayDiff
A JSON diff utility.
Install
Downloading the compiled binary
- Download the latest version of the binary: releases
- extract the archive and place the
jaydiffbinary in your$PATH
From source
- Have go 1.11 or greater installed: golang.org
- run
go get -u github.com/yazgazan/jaydiff
Usage
Usage:
jaydiff [OPTIONS] FILE_1 FILE_2
Application Options:
-i, --ignore= paths to ignore (glob)
--indent= indent string (default: "\t")
-t, --show-types show types
--json json-style output
--ignore-excess ignore excess keys and array elements
--ignore-values ignore scalar's values (only type is compared)
-r, --report output report format
--slice-myers use myers algorithm for slices
--stream treat FILE_1 and FILE_2 as JSON streams
--stream-lines read JSON stream line by line (expecting 1 JSON value per line)
--stream-ignore-excess ignore excess values in JSON stream
--stream-validate compare FILE_2 JSON stream against FILE_1 single value
-v, --version print release version
Help Options:
-h, --help Show this help message
Examples
Getting a full diff of two json files:
$ jaydiff --show-types old.json new.json
map[string]interface {} map[
a: float64 42
b: []interface {} [
float64 1
- float64 3
+ float64 5
+ float64 4
]
c: map[string]interface {} map[
- a: string toto
+ a: string titi
- b: float64 23
+ b: string 23
]
- e: []interface {} []
- f: float64 42
g: []interface {} [1 2 3]
+ h: float64 42
]
Ignoring fields:
$ jaydiff --show-types \
--ignore='.b\[\]' --ignore='.d' --ignore='.c.[ac]' \
old.json new.json
map[string]interface {} map[
a: float64 42
b: []interface {} [1 3]
c: map[string]interface {} map[
- b: float64 23
+ b: string 23
]
- e: []interface {} []
- f: float64 42
g: []interface {} [1 2 3]
+ h: float64 42
]
Report format:
$ jaydiff --report --show-types old.json new.json
- .b[1]: float64 3
+ .b[1]: float64 5
+ .b[2]: float64 4
- .c.a: string toto
+ .c.a: string titi
- .c.b: float64 23
+ .c.b: string 23
- .e: []interface {} []
- .f: float64 42
+ .h: float64 42
JSON-like format:
$ jaydiff --json old.json new.json
{
"a": 42,
"b": [
1,
- 3,
+ 5,
+ 4
],
"c": {
- "a": "toto",
+ "a": "titi",
- "b": 23,
+ "b": "23"
},
- "e": [],
- "f": 42,
"g": [1,2,3],
+ "h": 42
}
Ignore Excess values (useful when checking for backward compatibility):
$ jaydiff --report --show-types --ignore-excess old.json new.json
- .b[1]: float64 3
+ .b[1]: float64 5
- .c.a: string toto
+ .c.a: string titi
- .c.b: float64 23
+ .c.b: string 23
- .e: []interface {} []
- .f: float64 42
Ignore values (type must still match):
$ jaydiff --report --show-types --ignore-excess --ignore-values old.json new.json
- .c.b: float64 23
+ .c.b: string 23
- .e: []interface {} []
- .f: float64 42
JSON streams:
$ jaydiff --stream --json old.json new.json
[
{"foo":"bar"},
[
2,
3,
4,
{
+ "v": "some"
}
],
+ {"some":"thing"}
]
Validating JSON stream types:
$ jaydiff --ignore-excess --ignore-values --stream-validate --report --show-types base.json stream.json
- [1].bar: float64 4.2
+ [1].bar: string !
Ideas
- JayPatch
Sponsored by Datumprikker.nl
