gojsondiff

To use gojsondiff within your Go projects, install the package using go get.

go get github.com/yudai/gojsondiff

The repository includes a CLI tool package. You can install it by running go get on the jd subpackage.

go get github.com/yudai/gojsondiff/jd

The jd command compares two JSON files. By default, it produces a human-readable diff output.

To use the jsondiffpatch compatible delta format instead, use the -f delta flag.

# Standard diff output
jd one.json another.json

# Delta format output
jd -f delta one.json another.json

The jp command applies a diff file (in the delta format) to a target JSON file.

jp diff.delta one.json

The jd CLI provides several flags to control the output format and appearance:

Example with flags:

# Compare files using delta format without coloring
jd -f delta file1.json file2.json

# Compare files using ascii format with coloring enabled
jd -f ascii -c file1.json file2.json

jd --format ascii --coloring file1.json file2.json

The jd CLI tool allows you to apply a JSON patch (in a specific diff format) to a target JSON file. It reads a diff file and a JSON file from the command line arguments and outputs the resulting JSON after the patch has been applied to stdout.

Usage: jd <diff_file> <json_file>

Exit Codes:

• 1: Not enough arguments provided.
• 2: Failed to open a file or failed to load the diff file.

jd diff.json target.json

The jd CLI tool generates a human-readable diff between two JSON files. It supports two output formats: ascii (visual representation of the JSON structure) and delta (a list of changes).

Basic Usage:

jd <json_file_1> <json_file_2>

Exit Codes:

• 1: Differences were found.
• 2: Failed to open a file.
• 3: Failed to unmarshal JSON.
• 4: Unknown format specified.

jd file1.json file2.json