a pipeable JSON parser written in Bash
Latest commit 022ec33 Aug 11, 2016 @dominictarr committed on GitHub Merge pull request #45 from cttyler/master
Corrected typo in doc. No functional change.



yo, so it's a json parser written in shell, compatible with ash, bash, dash and zsh


pipe json to it, and it traverses the json objects and prints out the path to the current object (as a JSON array) and then the object, without whitespace.

$ json_parse < package.json
["name"]  "JSON.sh"
["version"]  "0.0.0"
["description"]  ""
["homepage"]  "http://github.com/dominictarr/JSON.sh"
["repository","type"]  "git"
["repository","url"]  "https://github.com/dominictarr/JSON.sh.git"
["repository"]  {"type":"git","url":"https://github.com/dominictarr/JSON.sh.git"}
["bin","json_parse"]  "./JSON.sh"
["bin"]  {"json_parse":"./JSON.sh"}
["dependencies"]  {}
#  ... etc

a more complex example:

curl registry.npmjs.org/express | ./JSON.sh | egrep '\["versions","[^"]*"\]'
... try it and see



Brief output. Combines 'Leaf only' and 'Prune empty' options.


Leaf only. Only show leaf nodes, which stops data duplication.


Prune empty. Exclude fields with empty values.


No-head. Don't show nodes that have no path. Normally these output a leading '[]', which you can't use in a bash array.


Remove escaping of the solidus symbol (stright slash).


Show help text.

Cool Links


install via npm or from AUR on archlinux


This software is available under the following licenses:

  • MIT
  • Apache 2