jason 0.4.0 → 0.5.0

data/README.md

@@ -47,6 +47,12 @@ You can configure the output format of the JSON:
 `:compact` will remove any unnecessary whitespace in the JSON while `:pretty`
 will indent the result JSON so that it looks, well, pretty.
 
+You can add output listeners to jason so that you can run arbitrary code upon
+the generated JSON. For example, if you'd like to log all of the JSON responses
+in Rails:
+
+    Jason.output_listeners << lambda { |json| Rails.logger.info(json) }
+
 ## Usage with Rails ##
 
 Name your view template with the extension `jason`. Everything else is the same.

data/lib/jason.rb

@@ -6,6 +6,7 @@ require 'strscan'
 module Jason
   class << self
     attr_writer :output_format
+    attr_writer :output_listeners
     
     # The output format of the JSON.
     # 
@@ -16,6 +17,18 @@ module Jason
     def output_format
       @output_format ||= :compact
     end
+    
+    # The output listeners for jason.
+    # 
+    # All objects in this array are sent #call with the generated JSON whenever
+    # jason processes a buffer. This can be useful for logging output like so:
+    # 
+    #     Jason.output_listeners << lambda { |json| Rails.logger.info(json) }
+    # 
+    # @returns [<#call>]
+    def output_listeners
+      @output_listeners ||= []
+    end
   end
   
   # Render a template.
@@ -48,19 +61,24 @@ module Jason
   
   # Process a rendered buffer.
   # 
-  # Removes any trailing commas and compresses the buffer.
+  # Removes any trailing commas and compresses the buffer. After generating the
+  # JSON, it calls each one of the output listeners with the generated JSON.
   # 
-  # Usually, you should not have to call this method.
+  # You should not have to directly call this method.
   # 
   # @param [String] buffer
   def self.process(buffer)
     obj = JSON.load(remove_trailing_commas(buffer))
     
     if output_format == :pretty
-      JSON.pretty_generate(obj)
+      json = JSON.pretty_generate(obj)
     else
-      JSON.generate(obj)
+      json = JSON.generate(obj)
     end
+    
+    output_listeners.each { |listener| listener.call(json) }
+    
+    json
   end
   
   private

data/lib/jason/version.rb

@@ -1,3 +1,3 @@
 module Jason
-  VERSION = '0.4.0'
+  VERSION = '0.5.0'
 end

data/test/test_jason.rb

@@ -85,4 +85,19 @@ EOF
     assert_equal :pretty, Jason.output_format
     assert_equal "{\n  \"foo\": [\n    \"bar\"\n  ]\n}", Jason.process('{"foo":["bar"]}')
   end
+  
+  test '.output_listeners' do
+    assert_equal [], Jason.output_listeners
+    
+    listener = mock
+    listener.expects(:call).with('{"foo":["bar"]}')
+    Jason.output_listeners << listener
+    
+    Jason.process('{"foo":["bar"]}')
+  end
+  
+  def teardown
+    Jason.output_format = :compact
+    Jason.output_listeners = []
+  end
 end

metadata

@@ -2,7 +2,7 @@
 name: jason
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors: 
 - Alexander Kern
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-06 00:00:00 -07:00
+date: 2011-06-07 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency