jsoned is a command line utility that provides a fast and simple way to retrieve or update values from JSON documents. It uses GJSON and SJSON under the hood.
It's fast because it avoids parsing irrelevant sections of json, skipping over values that do not apply, and aborts as soon as the target value has been found or updated.
jsoned can be compiled and used on Linux, OSX, Windows, FreeBSD, and probably others since the codebase is 100% Go. We support both 32 bit and 64 bit systems. Go must be installed on the build machine.
To build simply:
$ make
Or download a pre-built binary for Linux, OSX, Windows, or FreeBSD.
Usage menu:
$ jsoned -h
usage: jsoned [-v value] [-s] [-D] [-i infile] [-o outfile] keypath
examples: jsoned keypath read value from stdin
or: jsoned -i infile keypath read value from infile
or: jsoned -v value keypath edit value
or: jsoned -v value -o outfile keypath edit value and write to outfile
options:
-v value Edit JSON key path value
-D Delete the value at the specified key path
-i infile Use input file instead of stdin
-o outfile Use output file instead of stdout
-r Use raw values, otherwise types are auto-detected
keypath JSON key path (like "name.last")
jsoned uses a special path syntax for finding values.
Get a string:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jsoned name.last
Smith
Get a block of JSON:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jsoned name
{"first":"Tom","last":"Smith"}
Try to get a non-existent key:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jsoned name.middle
null
Get the raw string value:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jsoned -r name.last
"Smith"
Get an array value by index:
$ echo '{"friends":["Tom","Jane","Carol"]}' | jsoned friends.1
Jane
The path syntax for setting values has a couple of tiny differences than for getting values.
The -v value
option is auto-detected as a Number, Boolean, Null, or String.
You can override the auto-detection and input raw JSON by including the -r
option.
This is useful for raw JSON blocks such as object, arrays, or premarshalled strings.
Update a value:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jsoned -v Andy name.first
{"name":{"first":"Andy","last":"Smith"}}
Set a new value:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jsoned -v 46 age
{"age":46,"name":{"first":"Tom","last":"Smith"}}
Set a new nested value:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jsoned -v relax task.today
{"task":{"today":"relax"},"name":{"first":"Tom","last":"Smith"}}
Replace an array value by index:
$ echo '{"friends":["Tom","Jane","Carol"]}' | jsoned -v Andy friends.1
{"friends":["Tom","Andy","Carol"]}
Append an array:
$ echo '{"friends":["Tom","Jane","Carol"]}' | jsoned -v Andy friends.-1
{"friends":["Tom","Andy","Carol","Andy"]}
Set an array value that's past the bounds:
$ echo '{"friends":["Tom","Jane","Carol"]}' | jsoned -v Andy friends.5
{"friends":["Tom","Andy","Carol",null,null,"Andy"]}
Set a raw block of JSON:
$ echo '{"name":"Carol"}' | jsoned -r -v '["Tom","Andy"]' friends
{"friends":["Tom","Andy"],"name":"Carol"}
Start new JSON document:
$ echo '' | jsoned -v 'Sam' name.first
{"name":{"first":"Sam"}}
Delete a value:
$ echo '{"age":46,"name":{"first":"Tom","last":"Smith"}}' | jsoned -D age
{"name":{"first":"Tom","last":"Smith"}}
Delete an array value by index:
$ echo '{"friends":["Andy","Carol"]}' | ./jsoned -D friends.0
{"friends":["Carol"]}
Delete last item in array:
$ echo '{"friends":["Andy","Carol"]}' | ./jsoned -D friends.-1
{"friends":["Andy"]}
Josh Baker @tidwall
jsoned source code is available under the MIT License.