json-emitter 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bcc17f2e3ef47a32337396bed9145491d2e0cbe42a2df061b5f04a9f49506dc1
-  data.tar.gz: '0592545cd3afbf689ac6d6f513b61fafba17e913649dd84ec97b64780c731187'
+  metadata.gz: 2c101e09517330bff537ee6584fc20ec6c8785a7aa3fd86936599709de18ab54
+  data.tar.gz: 8d8cf0d57d66133d17c5cfc787244dfce26fba9c203049894a818381718720d3
 SHA512:
-  metadata.gz: 8ae3508d431a54d9e6b13f3cc0ff9da4357cc821194df7e6868c248bf0c729a7cdea68232147682b591b7f7356cc3eb6d8b88c7dc99ade0deca3411d0f5db731
-  data.tar.gz: 45cd948d048d575ef20daab90c09eadd7576fcf668e6022c8131a12c10d421a6f5dc3bb6490b1811ca051ed23060d3e8b0438e27a43fe91870c3e242c6a04d1a
+  metadata.gz: 21da8c5d80a1be418a5b402e57a240dc5e0e8477f15818b4d1826a2361008cf93720ff1ecc18f1b10099ce7729bec6acea9865772b869f42fc89f388220d1413
+  data.tar.gz: ba6d4e57f31d37a71892a4ad34b419d3401a26e447a4c02f3c5444865c75c86f2b0d7cabc9555571ae84c5804c24b108a6306a4ca1d060e2414c0b864559c73a

data/README.md

@@ -1,12 +1,12 @@
-# JsonEmitter
+# JsonEmitter [![Build Status](https://travis-ci.org/jhollinger/json-emitter.svg?branch=master)](https://travis-ci.org/jhollinger/json-emitter)
 
 JsonEmitter is a library for efficiently generating very large bits of JSON in Ruby. Need to generate a JSON array of 10,000 database records without eating up all your RAM? No problem! Objects? Nested structures? JsonEmitter has you covered.
 
-Use JsonEmitter in your Rack/Rails/Sinatra/Grape API to stream large JSON responses without worrying about RAM or HTTP timeouts. Use it to write large JSON objects to your filesystem, S3, or ~~a 3D printer~~ anywhere else!
+Use JsonEmitter in your Rack/Rails/Sinatra/Grape API to stream large JSON responses without worrying (much) about RAM or HTTP timeouts. Use it to write large JSON objects to your filesystem, S3, or ~~a 3D printer~~ anywhere else!
 
 # HTTP Chunked Responses
 
-These examples will use the Order enumerator to generate chunks of JSON and send them to the client as more chunks are generated. No more than 500 orders will be in memory at a time, regardless of how many orders there are. And only small portions of the JSON will be in memory at once, no matter how much we're generating.
+These examples will use the Order enumerator to generate chunks of JSON and send them to the client as more chunks are generated. No more than 500 orders will be in memory at a time, regardless of how many orders there are. And only small portions of the JSON will be in memory at once, no matter how much we're generating. (NOTE There **are** limits to how long something will stream - your app server, nginx/apache, your browser, etc. may cut it off eventually.)
 
 ```ruby
 enumerator = Order.
@@ -70,7 +70,7 @@ JsonEmitter.array(enumerator).each { |json_chunk|
 }
 ```
 
-`JsonEmitter.object` takes a `Hash` and returns a stream that generates chunks of JSON.
+`JsonEmitter.object` takes a `Hash` and returns a stream that generates chunks of JSON. Hash values can be literals, Enumerators, Arrays, other Hashes, or Procs that return any of those. Hashes and arrays may be nested.
 
 ```ruby
 JsonEmitter.object({
@@ -97,3 +97,11 @@ File.open("~/out.json", "w+") { |f|
   JsonEmitter.array(enumerator).write f
 }
 ```
+
+# License
+
+MIT License. See LICENSE for details.
+
+# Copyright
+
+Copywrite (c) 2019 Jordan Hollinger.

data/lib/json-emitter.rb

@@ -51,11 +51,12 @@ module JsonEmitter
   # @param enum [Enumerable] Something that can be enumerated over, like an Array or Enumerator. Each element should be something that can be rendered as JSON (e.g. a number, string, boolean, Array, or Hash).
   # @param buffer_size [Integer] The buffer size in kb. This is a size *hint*, not a hard limit.
   # @param buffer_unit [Symbol] :bytes | :kb (default) | :mb
+  # @param rack [Hash] optional Rack env for error handling
   # @yield If a block is given, it will be yielded each value in the array. The return value from the block will be converted to JSON instead of the original value.
   # @return [JsonEmitter::BufferedStream]
   #
-  def self.array(enum, buffer_size: 16, buffer_unit: :kb, &mapper)
-    emitter = Emitter.new.array(enum, &mapper)
+  def self.array(enum, buffer_size: 16, buffer_unit: :kb, rack: nil, &mapper)
+    emitter = Emitter.new(rack_env: rack).array(enum, &mapper)
     BufferedStream.new(emitter, buffer_size, unit: buffer_unit)
   end
 
@@ -95,10 +96,11 @@ module JsonEmitter
   # @param hash [Hash] Keys should be Strings or Symbols and values should be any JSON-compatible value like a number, string, boolean, Array, or Hash.
   # @param buffer_size [Integer] The buffer size in kb. This is a size *hint*, not a hard limit.
   # @param buffer_unit [Symbol] :bytes | :kb (default) | :mb
+  # @param rack [Hash] optional Rack env for error handling
   # @return [JsonEmitter::BufferedStream]
   #
-  def self.object(hash, buffer_size: 16, buffer_unit: :kb)
-    emitter = Emitter.new.object(hash)
+  def self.object(hash, buffer_size: 16, buffer_unit: :kb, rack: nil)
+    emitter = Emitter.new(rack_env: rack).object(hash)
     BufferedStream.new(emitter, buffer_size, unit: buffer_unit)
   end
 

data/lib/json-emitter/context.rb

@@ -8,7 +8,11 @@ module JsonEmitter
   # and JsonEmitter.error to add critical behavior back in.
   #
   class Context
-    def initialize
+    # @return [Hash] The Rack environment Hash (if present)
+    attr_reader :rack_env
+
+    def initialize(rack_env: nil)
+      @rack_env = rack_env
       @wrappers = JsonEmitter.wrappers.map(&:call).compact
       @error_handlers = JsonEmitter.error_handlers
       @pass_through_errors = []
@@ -29,6 +33,13 @@ module JsonEmitter
       @error_handlers += [handler]
     end
 
+    # Returns a Rack::Request from rack_env (if rack_env was given).
+    def request
+      if rack_env
+        @request ||= Rack::Request.new(rack_env)
+      end
+    end
+
     # Execute a block within this context.
     def execute(&inner)
       @wrappers.reduce(inner) { |f, outer_wrapper|
@@ -38,7 +49,7 @@ module JsonEmitter
     rescue *@pass_through_errors => e
       raise e
     rescue => e
-      @error_handlers.each { |h| h.call(e) }
+      @error_handlers.each { |h| h.call(e, self) }
       raise e
     end
   end

data/lib/json-emitter/emitter.rb

@@ -1,4 +1,6 @@
 module JsonEmitter
+  COMMA = ",".freeze
+
   #
   # Builds Enumerators that yield JSON from Ruby Arrays or Hashes.
   #
@@ -6,8 +8,8 @@ module JsonEmitter
     # @return [JsonEmitter::Context]
     attr_reader :context
 
-    def initialize
-      @context = Context.new
+    def initialize(rack_env: nil)
+      @context = Context.new(rack_env: rack_env)
     end
 
     #
@@ -51,7 +53,7 @@ module JsonEmitter
 
         first = true
         enum.each { |val|
-          y << ",".freeze unless first
+          y << COMMA unless first
           first = false if first
 
           mapped_val = mapper ? mapper.call(val) : val
@@ -70,7 +72,7 @@ module JsonEmitter
 
         first = true
         hash.each { |key, val|
-          y << ",".freeze unless first
+          y << COMMA unless first
           first = false if first
 
           json_key = MultiJson.dump(key.to_s)

data/lib/json-emitter/version.rb

@@ -1,4 +1,4 @@
 module JsonEmitter
   # Library version
-  VERSION = "0.1.0".freeze
+  VERSION = "0.2.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: json-emitter
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jordan Hollinger
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-31 00:00:00.000000000 Z
+date: 2020-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -56,8 +56,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Efficiently generate tons of JSON