oresoftware / read.json

Read properties from JSON files using the shell. 🏯

@oresoftware/read.json

A simple alternative to jq for bash/shell Reads in JSON to stdin, and always writes JSON to stdout

installation

npm i -g @oresoftware/read.json

Usage

Given a foo.json file like so:

{
 "foo":{
   "bar": {
     "baz":"biz"
  }
 }
}

You can get 'biz' by running:

$ read_json -k 'foo.bar.baz' < foo.json

or equally like so:

$ read_json -k 'foo.bar.baz' -f  foo.json

To pass an expression to evaluate, use:

$ read_json --eval "['foo']['bar']['baz']" -f  foo.json

note that if you have keys with dots in them, it's necessary to use the --eval technique:

$ read_json --eval "['foo.x.y']" -f  foo.json

As a final example, if you run this:

$  cat foo.json | read_json

You will get this:

{"foo":{"bar":{"baz":"biz"}}}

read.json's Issues

group quotes around keys with dot in the name

if you have an object like this:

const foo = {
 'bar.baz': {}
}

then you should be able to access this property like this:

read_json -k 'foo."bar.baz"' < foo.json

obviated by JQ

this project should be obviated by JQ tool (obviously)