jipe is a pipe to filter, extract from and pretty print a stream of JSON objects. It can be used from the shell, or as a nodejs library.
Using
Always use jipe --help to get the latest documentation.
$ npm install jipe
$ jipe --help
$ jipe < abunchofjsonobjects.json
Using as a Library
You are incouraged to also use jipe as a library. The following streams are available:
jipe.Parse - The parser, input is a binary stream and output is an object
stream. Optional skip option is support to skip first n
bytes of the input stream.
jipe.Inquery - Inquery filter. Objects in and out. Takes a query argument
that is a valid Inquiry
expression.
jipe.JSONPath - JSONPath filter. Objects in and out. Takes a query argument
that is a valid JSONPath
expression.
jipe.Pp - The pretty printer. Optional indent option is supported and is
4 by default. Takes an object stream as input and outputs a
binary stream.
Query Language
There are multiple query languages supported, depending on which parameter are passed. Please refer to the individual packages for docuntation of their query languages.
--jsonpath uses JSONPath
--inquery uses Inquiry
Additional Features
Sometimes you have an enormous JSON array of objects or other arrays and you'd like to treat each element seperately. The --skip option was created for this purpose. Since the jipe parser ignores anything in between objects, if you tell it to skip the opening left bracket, it will treat each of the elements as it's own event. --skip takes a number argument and will skip that number of bytes from the beginning of the input stream.
FAQ
Is it efficient? No. I have spent zero effort making the parsing algorithm efficient. I may or may not in the future.
Is it safe? No. If you pass in invalid JSON, it will just keep buffering data and trying to parse it until it explodes. It cannot recover from bad JSON.
What is valid JSON? Arrays and Objects. That's it. Valid JSON begins with { or [ and ends with } or ]. Any non-[ or non-{ characters before the starting delimiter or after the ending delimeter are simply ignored.
Does it care about newlines? No, your JSON can span multple lines, and doesn't need any newlines between objects.