Blob Blame History Raw
.TH GRON 1
.SH NAME
gron \- Transform JSON into discrete assignments to make it greppable
.SH SYNOPSIS
.B gron
.RB [OPTIONS] [FILE|URL|-]
.SH DESCRIPTION
gron transforms JSON into discrete assignments to make it easier to grep for
what you want and see the absolute 'path' to it. It eases the exploration of
APIs that return large blobs of JSON.

.SH OPTIONS
.TP
.B -u, --ungron
Reverse the operation (turn assignments back into JSON)
.TP
.B -c, --colorize
Colorize output (default on tty)
.TP
.B -m, --monochrome
Monochrome (don't colorize output)
.TP
.B -s, --stream
Treat each line of input as a separate JSON object
.TP
.B -k, --insecure
Disable certificate validation
.TP
.B -j, --json
Represent gron data as JSON stream
.TP
.B --no-sort
Don't sort output (faster)
.TP
.B --version
Print version information

.SH EXIT CODES
.TP
.B 0
OK
.TP
.B 1
Failed to open file
.TP
.B 2
Failed to read input
.TP
.B 3
Failed to form statements
.TP
.B 4
Failed to fetch URL
.TP
.B 5
Failed to parse statements
.TP
.B 6
Failed to encode JSON

.SH EXAMPLES

gron /tmp/apiresponse.json

gron http://jsonplaceholder.typicode.com/users/1 

curl -s http://jsonplaceholder.typicode.com/users/1 | gron

gron http://jsonplaceholder.typicode.com/users/1 | grep company | gron --ungron