A streaming JSON parser (generates SAX-like events) and JSON Path like implementation to parse small amount of data in a large JSON file.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Please update to 0.1.0 version. It's bug free.

It's a JSON Path like implementation and memory optimization in JSON Stream gem (https://github.com/dgraham/json-stream)

JSON Stream Path is well suit for parsing subset of JSON data from a huge JSON file.

Usual stream based parsers will reduce the memory only in parsing file. But they may still keeps the graph(a intermediate data structure to create hash) of whole JSON data in memory. Again the graph is converted into hash that again may consume memory. If only subset of JSON data have to be parsed from a huge JSON file, graph no need to be created for the whole JSON data and final hash also no need to contain whole JSON data.

JSON Stream Path address this problem. Path to parse in JSON file is supplied as an argument in the .parse API. JSON Stream Path parses according to the path supplied. So it consumes memory to create graph only for the subset of huge JSON data. Same way, final out come (hash) is the subset of huge JSON data which will again consume memory for the subset of huge JSON data.

Future releases will optimize memory and improve performance.
Please keep update to the latest version.


Add this line to your application's Gemfile:

gem 'json-stream-path', :require => 'json/stream'

And then execute:

$ bundle

Or install it yourself as:

$ gem install json-stream-path


To parse subset of data from JSON file.

require 'json/stream'
parser = JSON::Stream::Parser.new
stream = File.open('path/to/json-file.json')
hash = parser.parse(stream, '/json/path')

To parse whole JSON file

require 'json/stream'
parser = JSON::Stream::Parser.new
stream = File.open('path/to/json-file.json')
hash = parser.parse(stream)

For the other basic usage refer https://github.com/dgraham/json-stream

Thanks to David Graham for his JSON Stream https://github.com/dgraham/json-stream

Future Enhancements: Implement full stack JSON Path Option to get hash or JSON


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request