multi_json-maglev- 1.3.6

data/.document

@@ -0,0 +1,5 @@
+LICENSE.md
+README.md
+bin/*
+features/**/*.feature
+lib/**/*.rb

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--order random

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+rvm:
+  - rbx-18mode
+  - rbx-19mode
+  - jruby-18mode
+  - jruby-19mode
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - ruby-head

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gem 'json',      '~> 1.4', :require => nil
+gem 'oj',        '~> 1.0', :require => nil, :platforms => [:ruby, :mswin, :mingw]
+gem 'yajl-ruby', '~> 1.0', :require => nil, :platforms => [:ruby, :mswin, :mingw]
+
+gemspec

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Michael Bleigh, Josh Kalderimis, Erik Michaels-Ober, and Intridea, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,119 @@
+# MultiJSON [![Build Status](https://secure.travis-ci.org/intridea/multi_json.png?branch=master)][travis] [![Dependency Status](https://gemnasium.com/intridea/multi_json.png?travis)][gemnasium]
+
+[travis]: http://travis-ci.org/intridea/multi_json
+[gemnasium]: https://gemnasium.com/intridea/multi_json
+
+Lots of Ruby libraries parse JSON and everyone has their favorite JSON coder.
+Instead of choosing a single JSON coder and forcing users of your library to be
+stuck with it, you can use MultiJSON instead, which will simply choose the
+fastest available JSON coder. Here's how to use it:
+
+    require 'multi_json'
+
+    MultiJson.load('{"abc":"def"}') #=> {"abc" => "def"}
+    MultiJson.load('{"abc":"def"}', :symbolize_keys => true) #=> {:abc => "def"}
+    MultiJson.dump({:abc => 'def'}) # convert Ruby back to JSON
+    MultiJson.dump({:abc => 'def'}, :pretty => true) # encoded in a pretty form (if supported by the coder)
+
+The `use` method, which sets the MultiJson adapter, takes either a symbol or a
+class (to allow for custom JSON parsers) that responds to both `.load` and `.dump`
+at the class level.
+
+MultiJSON tries to have intelligent defaulting. That is, if you have any of the
+supported engines already loaded, it will utilize them before attempting to
+load any. When loading, libraries are ordered by speed. First Oj, then Yajl,
+then the JSON gem, then JSON pure. If no other JSON library is available,
+MultiJSON falls back to [OkJson][], a simple, vendorable JSON parser.
+
+[okjson]: https://github.com/kr/okjson
+
+## Supported JSON Engines
+
+* [Oj](https://github.com/ohler55/oj) Optimized JSON by Peter Ohler
+* [Yajl](https://github.com/brianmario/yajl-ruby) Yet Another JSON Library by Brian Lopez
+* [JSON](https://github.com/flori/json) The default JSON gem with C-extensions (ships with Ruby 1.9)
+* [JSON Pure](https://github.com/flori/json) A Ruby variant of the JSON gem
+* [NSJSONSerialization](https://developer.apple.com/library/ios/#documentation/Foundation/Reference/NSJSONSerialization_Class/Reference/Reference.html) Wrapper for Apple's NSJSONSerialization in the Cocoa Framework (MacRuby only)
+* [OkJson][okjson] A simple, vendorable JSON parser
+
+## Contributing
+In the spirit of [free software][free-sw], **everyone** is encouraged to help
+improve this project.
+
+[free-sw]: http://www.fsf.org/licensing/essays/free-sw.html
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code (**no patch is too small**: fix typos, add comments, clean up
+  inconsistent whitespace)
+* by refactoring code
+* by closing [issues][]
+* by reviewing patches
+
+[issues]: https://github.com/intridea/multi_json/issues
+
+## Submitting an Issue
+We use the [GitHub issue tracker][issues] to track bugs and features. Before
+submitting a bug report or feature request, check to make sure it hasn't
+already been submitted. When submitting a bug report, please include a [Gist][]
+that includes a stack trace and any details that may be necessary to reproduce
+the bug, including your gem version, Ruby version, and operating system.
+Ideally, a bug report should include a pull request with failing specs.
+
+[gist]: https://gist.github.com/
+
+## Submitting a Pull Request
+1. [Fork the repository.][fork]
+2. [Create a topic branch.][branch]
+3. Add specs for your unimplemented feature or bug fix.
+4. Run `bundle exec rake spec`. If your specs pass, return to step 3.
+5. Implement your feature or bug fix.
+6. Run `bundle exec rake spec`. If your specs fail, return to step 5.
+7. Run `open coverage/index.html`. If your changes are not completely covered
+   by your tests, return to step 3.
+8. Add, commit, and push your changes.
+9. [Submit a pull request.][pr]
+
+[fork]: http://help.github.com/fork-a-repo/
+[branch]: http://learn.github.com/p/branching.html
+[pr]: http://help.github.com/send-pull-requests/
+
+## Supported Ruby Versions
+This library aims to support and is [tested against][travis] the following Ruby
+implementations:
+
+* Ruby 1.8.7
+* Ruby 1.9.2
+* Ruby 1.9.3
+* [JRuby][]
+* [Rubinius][]
+* [MacRuby][] (not tested on Travis CI)
+
+[jruby]: http://www.jruby.org/
+[rubinius]: http://rubini.us/
+[macruby]: http://www.macruby.org/
+
+If something doesn't work on one of these interpreters, it should be considered
+a bug.
+
+This library may inadvertently work (or seem to work) on other Ruby
+implementations, however support will only be provided for the versions listed
+above.
+
+If you would like this library to support another Ruby version, you may
+volunteer to be a maintainer. Being a maintainer entails making sure all tests
+run and pass on that implementation. When something breaks on your
+implementation, you will be personally responsible for providing patches in a
+timely fashion. If critical issues for a particular implementation exist at the
+time of a major release, support for that Ruby version may be dropped.
+
+## Copyright
+Copyright (c) 2010 Michael Bleigh, Josh Kalderimis, Erik Michaels-Ober, and Intridea, Inc.
+See [LICENSE][] for details.
+
+[license]: https://github.com/intridea/multi_json/blob/master/LICENSE.md

data/Rakefile

@@ -0,0 +1,20 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+desc "Run all examples"
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :test => :spec
+
+namespace :doc do
+  require 'rdoc/task'
+  require File.expand_path('../lib/multi_json/version', __FILE__)
+  RDoc::Task.new do |rdoc|
+    rdoc.rdoc_dir = 'rdoc'
+    rdoc.title = "multi_json #{MultiJson::VERSION}"
+    rdoc.main = 'README.md'
+    rdoc.rdoc_files.include('README.md', 'LICENSE.md', 'lib/**/*.rb')
+  end
+end

data/lib/multi_json.rb

@@ -0,0 +1,120 @@
+module MultiJson
+  class DecodeError < StandardError
+    attr_reader :data
+    def initialize(message="", backtrace=[], data="")
+      super(message)
+      self.set_backtrace(backtrace)
+      @data = data
+    end
+  end
+
+  @adapter = nil
+
+  REQUIREMENT_MAP = [
+    ["oj", :oj],
+    ["yajl", :yajl],
+    ["json", :json_gem],
+    ["json/pure", :json_pure]
+  ]
+
+  class << self
+
+    # The default adapter based on what you currently
+    # have loaded and installed. First checks to see
+    # if any adapters are already loaded, then checks
+    # to see which are installed if none are loaded.
+    def default_adapter
+      return :oj if defined?(::Oj)
+      return :yajl if defined?(::Yajl)
+      return :json_gem if defined?(::JSON)
+
+      REQUIREMENT_MAP.each do |(library, adapter)|
+        begin
+          require library
+          return adapter
+        rescue LoadError
+          next
+        end
+      end
+
+      Kernel.warn "[WARNING] MultiJson is using the default adapter (ok_json). We recommend loading a different JSON library to improve performance."
+      :ok_json
+    end
+    # :nodoc:
+    alias :default_engine :default_adapter
+
+    # Get the current adapter class.
+    def adapter
+      return @adapter if @adapter
+      self.use self.default_adapter
+      @adapter
+    end
+    # :nodoc:
+    alias :engine :adapter
+
+    # Set the JSON parser utilizing a symbol, string, or class.
+    # Supported by default are:
+    #
+    # * <tt>:oj</tt>
+    # * <tt>:json_gem</tt>
+    # * <tt>:json_pure</tt>
+    # * <tt>:ok_json</tt>
+    # * <tt>:yajl</tt>
+    # * <tt>:nsjsonserialization</tt> (MacRuby only)
+    def use(new_adapter)
+      @adapter = load_adapter(new_adapter)
+    end
+    alias :adapter= :use
+    # :nodoc:
+    alias :engine= :use
+
+    def load_adapter(new_adapter)
+      case new_adapter
+      when String, Symbol
+        require "multi_json/adapters/#{new_adapter}"
+        MultiJson::Adapters.const_get("#{new_adapter.to_s.split('_').map{|s| s.capitalize}.join('')}")
+      when NilClass
+        nil
+      when Class
+        new_adapter
+      else
+        raise "Did not recognize your adapter specification. Please specify either a symbol or a class."
+      end
+    end
+
+    # Decode a JSON string into Ruby.
+    #
+    # <b>Options</b>
+    #
+    # <tt>:symbolize_keys</tt> :: If true, will use symbols instead of strings for the keys.
+    # <tt>:adapter</tt> :: If set, the selected engine will be used just for the call.
+    def load(string, options={})
+      adapter = current_adapter(options)
+      begin
+        adapter.load(string, options)
+      rescue adapter::ParseError => exception
+        raise DecodeError.new(exception.message, exception.backtrace, string)
+      end
+    end
+    # :nodoc:
+    alias :decode :load
+
+    def current_adapter(options)
+      if new_adapter = (options || {}).delete(:adapter)
+        load_adapter(new_adapter)
+      else
+        adapter
+      end
+    end
+
+    # Encodes a Ruby object as JSON.
+    def dump(object, options={})
+      adapter = current_adapter(options)
+      adapter.dump(object, options)
+    end
+    # :nodoc:
+    alias :encode :dump
+
+  end
+
+end

data/lib/multi_json/adapters/json_common.rb

@@ -0,0 +1,25 @@
+module MultiJson
+  module Adapters
+    module JsonCommon
+
+      def load(string, options={})
+        string = string.read if string.respond_to?(:read)
+        ::JSON.parse(string, :symbolize_names => options[:symbolize_keys])
+      end
+
+      def dump(object, options={})
+        object.to_json(process_options(options))
+      end
+
+    protected
+
+      def process_options(options={})
+        return options if options.empty?
+        opts = {}
+        opts.merge!(JSON::PRETTY_STATE_PROTOTYPE.to_h) if options.delete(:pretty)
+        opts.merge!(options)
+      end
+
+    end
+  end
+end

data/lib/multi_json/adapters/json_gem.rb

@@ -0,0 +1,12 @@
+require 'json' unless defined?(::JSON)
+require 'multi_json/adapters/json_common'
+
+module MultiJson
+  module Adapters
+    # Use the JSON gem to dump/load.
+    class JsonGem
+      ParseError = ::JSON::ParserError
+      extend JsonCommon
+    end
+  end
+end

data/lib/multi_json/adapters/json_pure.rb

@@ -0,0 +1,12 @@
+require 'json/pure' unless defined?(::JSON)
+require 'multi_json/adapters/json_common'
+
+module MultiJson
+  module Adapters
+    # Use JSON pure to dump/load.
+    class JsonPure
+      ParseError = ::JSON::ParserError
+      extend JsonCommon
+    end
+  end
+end

data/lib/multi_json/adapters/nsjsonserialization.rb

@@ -0,0 +1,34 @@
+framework 'Foundation'
+require 'multi_json/adapters/ok_json'
+
+module MultiJson
+  module Adapters
+    class Nsjsonserialization < MultiJson::Adapters::OkJson
+      ParseError = ::MultiJson::OkJson::Error
+
+      def self.load(string, options={})
+        string = string.read if string.respond_to?(:read)
+        data = string.dataUsingEncoding(NSUTF8StringEncoding)
+        object = NSJSONSerialization.JSONObjectWithData(data, options: NSJSONReadingMutableContainers | NSJSONReadingMutableLeaves, error: nil)
+        if object
+          object = symbolize_keys(object) if options[:symbolize_keys]
+          object
+        else
+          super(string, options={})
+        end
+      end
+
+      def self.dump(object, options={})
+        pretty = options[:pretty] ? NSJSONWritingPrettyPrinted : 0
+        object = object.as_json if object.respond_to?(:as_json)
+        if NSJSONSerialization.isValidJSONObject(object)
+          data = NSJSONSerialization.dataWithJSONObject(object, options: pretty, error: nil)
+          NSMutableString.alloc.initWithData(data, encoding: NSUTF8StringEncoding)
+        else
+          super(object, options)
+        end
+      end
+
+    end
+  end
+end

data/lib/multi_json/adapters/oj.rb

@@ -0,0 +1,22 @@
+require 'oj' unless defined?(::Oj)
+
+module MultiJson
+  module Adapters
+    # Use the Oj library to dump/load.
+    class Oj
+      ParseError = SyntaxError
+
+      ::Oj.default_options = {:mode => :compat}
+
+      def self.load(string, options={}) #:nodoc:
+        options.merge!(:symbol_keys => options[:symbolize_keys] || options['symbolize_keys'])
+        ::Oj.load(string, options)
+      end
+
+      def self.dump(object, options={}) #:nodoc:
+        options.merge!(:indent => 2) if options[:pretty] || options['pretty']
+        ::Oj.dump(object, options)
+      end
+    end
+  end
+end

data/lib/multi_json/adapters/ok_json.rb

@@ -0,0 +1,48 @@
+require 'multi_json/vendor/okjson'
+
+module MultiJson
+  module Adapters
+    class OkJson
+      ParseError = ::MultiJson::OkJson::Error
+
+      def self.load(string, options={}) #:nodoc:
+        string = string.read if string.respond_to?(:read)
+        result = ::MultiJson::OkJson.decode(string)
+        options[:symbolize_keys] ? symbolize_keys(result) : result
+      end
+
+      def self.dump(object, options={}) #:nodoc:
+        ::MultiJson::OkJson.valenc(stringify_keys(object))
+      end
+
+      def self.symbolize_keys(object) #:nodoc:
+        modify_keys(object) do |key|
+          key.is_a?(String) ? key.to_sym : key
+        end
+      end
+
+      def self.stringify_keys(object) #:nodoc:
+        modify_keys(object) do |key|
+          key.is_a?(Symbol) ? key.to_s : key
+        end
+      end
+
+      def self.modify_keys(object, &modifier) #:nodoc:
+        case object
+        when Array
+          object.map do |value|
+            modify_keys(value, &modifier)
+          end
+        when Hash
+          object.inject({}) do |result, (key, value)|
+            new_key   = modifier.call(key)
+            new_value = modify_keys(value, &modifier)
+            result.merge! new_key => new_value
+          end
+        else
+          object
+        end
+      end
+    end
+  end
+end