rufus-json 0.1.0

data/CHANGELOG.txt

@@ -0,0 +1,6 @@
+
+= rufus-json CHANGELOG.txt
+
+
+== rufus-json - 0.1.0    released 2009/12/25
+

data/CREDITS.txt

@@ -0,0 +1,5 @@
+
+== authors
+
+John Mettraux - http://github.com/jmettraux
+

data/LICENSE.txt

@@ -0,0 +1,21 @@
+
+Copyright (c) 2009-2010, John Mettraux, jmettraux@gmail.com
+
+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.rdoc

@@ -0,0 +1,79 @@
+
+= rufus-json
+
+One interface for various JSON Ruby backends.
+
+  # load your favourite JSON backend
+  require 'yajl'
+  #require 'json'
+  #require 'active_support'
+
+  p Rufus::Json.decode('{"a":2,"b":true}')
+    # => { 'a' => 2, 'b' => true }
+
+  p Rufus::Json.encode({ 'a' => 2, 'b' => true })
+    # => '{"a":2,"b":true}'
+
+
+If multiple libs are present, it will favour yajl-ruby and json, and then active_support. It's OK to force a backend.
+
+  Rufus::Json.backend = :yajl
+  #Rufus::Json.backend = :json
+  #Rufus::Json.backend = :active
+
+
+To know if there is currently a backend set :
+
+  Rufus::Json.has_backend?
+
+
+It's OK to load a lib and force detection :
+
+  require 'json'
+  Rufus::Json.detect_backend
+
+  p Rufus::Json.backend
+    # => :json
+
+
+There is a dup method, it may be useful in an all JSON system (flattening stuff that will anyway get flattened later).
+
+  o = Rufus::Json.dup(o)
+
+
+== rdoc
+
+http://rufus.rubyforge.org/rufus-json/
+
+
+== mailing list
+
+On the rufus-ruby list :
+
+http://groups.google.com/group/rufus-ruby
+
+
+== issue tracker
+
+http://github.com/jmettraux/rufus-json/issues
+
+
+== irc
+
+  irc.freenode.net #ruote
+
+
+== the rest of Rufus
+
+http://rufus.rubyforge.org
+
+
+== authors
+
+* John Mettraux, http://jmettraux.wordpress.com/
+
+
+== license
+
+MIT
+

data/Rakefile

@@ -0,0 +1,83 @@
+
+
+require 'lib/rufus/json.rb'
+
+require 'rubygems'
+require 'rake'
+
+
+#
+# CLEAN
+
+require 'rake/clean'
+CLEAN.include('pkg', 'tmp', 'html')
+task :default => [ :clean ]
+
+
+#
+# GEM
+
+require 'jeweler'
+
+Jeweler::Tasks.new do |gem|
+
+  gem.version = Rufus::Json::VERSION
+  gem.name = 'rufus-json'
+
+  gem.summary = 'One interface to various JSON ruby libs (yajl, json, json_pure, json-jruby, active_support). Has a preference for yajl.'
+
+  gem.description = %{
+One interface to various JSON ruby libs (yajl, json, json_pure, json-jruby, active_support). Has a preference for yajl.
+  }
+  gem.email = 'jmettraux@gmail.com'
+  gem.homepage = 'http://github.com/jmettraux/rufus-json/'
+  gem.authors = [ 'John Mettraux' ]
+  gem.rubyforge_project = 'rufus'
+
+  gem.test_file = 'test/test.rb'
+
+  gem.add_development_dependency 'json'
+  gem.add_development_dependency 'yajl-ruby'
+  gem.add_development_dependency 'activesupport'
+  #gem.add_development_dependency 'json_pure'
+  #gem.add_development_dependency 'json-jruby'
+  gem.add_development_dependency 'yard', '>= 0'
+
+  # gemspec spec : http://www.rubygems.org/read/chapter/20
+end
+Jeweler::GemcutterTasks.new
+
+
+#
+# DOC
+
+begin
+
+  require 'yard'
+
+  YARD::Rake::YardocTask.new do |doc|
+    doc.options = [
+      '-o', 'html/rufus-json', '--title',
+      "rufus-json #{Rufus::Json::VERSION}"
+    ]
+  end
+
+rescue LoadError
+
+  task :yard do
+    abort "YARD is not available : sudo gem install yard"
+  end
+end
+
+
+#
+# TO THE WEB
+
+task :upload_website => [ :clean, :yard ] do
+
+  account = 'jmettraux@rubyforge.org'
+  webdir = '/var/www/gforge-projects/rufus'
+
+  sh "rsync -azv -e ssh html/rufus-json #{account}:#{webdir}/"
+end
+

data/lib/rufus/json.rb

@@ -0,0 +1,126 @@
+#--
+# Copyright (c) 2009-2010, John Mettraux, jmettraux@gmail.com
+#
+# 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.
+#
+# Made in Japan.
+#++
+
+
+module Rufus
+module Json
+
+  VERSION = '0.1.0'
+
+  # The JSON / JSON pure decoder
+  #
+  JSON = [
+    lambda { |o| o.to_json },
+    lambda { |s| ::JSON.parse(s) }
+  ]
+
+  # The Rails ActiveSupport::JSON decoder
+  #
+  ACTIVE_SUPPORT = [
+    lambda { |o| o.to_json },
+    lambda { |s| ActiveSupport::JSON.decode(s) }
+  ]
+  ACTIVE = ACTIVE_SUPPORT
+
+  # http://github.com/brianmario/yajl-ruby/
+  #
+  YAJL = [
+    lambda { |o| Yajl::Encoder.encode(o) },
+    lambda { |s| Yajl::Parser.parse(s) }
+  ]
+
+  # The "raise an exception because there's no backend" backend
+  #
+  NONE = [ lambda { |s| raise 'no JSON backend found' } ] * 2
+
+  # [Re-]Attempts to detect a JSON backend
+  #
+  def self.detect_backend
+
+    @backend = if defined?(::Yajl)
+      YAJL
+    elsif defined?(::JSON)
+      JSON
+    elsif defined?(ActiveSupport::JSON)
+      ACTIVE_SUPPORT
+    else
+      NONE
+    end
+  end
+
+  detect_backend
+    # run it right now
+
+  # Returns true if there is a backend set for parsing/encoding JSON
+  #
+  def self.has_backend?
+
+    (@backend != NONE)
+  end
+
+  # Returns :yajl|:json|:active|:none (an identifier for the current backend)
+  #
+  def self.backend
+
+    %w[ yajl json active none ].find { |b|
+      Rufus::Json.const_get(b.upcase) == @backend
+    }.to_sym
+  end
+
+  # Forces a decoder JSON/ACTIVE_SUPPORT or any lambda pair that knows
+  # how to deal with JSON.
+  #
+  # It's OK to pass a symbol as well, :yajl, :json, :active (or :none).
+  #
+  def self.backend= (b)
+
+    b = { :yajl => YAJL, :json => JSON, :active => ACTIVE, :none => NONE }[b] \
+      if b.is_a?(Symbol)
+
+    @backend = b
+  end
+
+  def self.encode (o)
+
+    @backend[0].call(o)
+  end
+
+  # Decodes the given JSON string.
+  #
+  def self.decode (s)
+
+    @backend[1].call(s)
+  end
+
+  # Duplicates an object by turning it into JSON and back.
+  #
+  # Don't laugh, yajl-ruby makes that faster than a Marshal copy.
+  #
+  def self.dup (o)
+
+    (@backend == NONE) ? Marshal.load(Marshal.dump(o)) : decode(encode(o))
+  end
+end
+end
+

data/lib/rufus-json.rb

@@ -0,0 +1,3 @@
+
+require 'rufus/json'
+

data/rufus-json.gemspec

@@ -0,0 +1,64 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rufus-json}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["John Mettraux"]
+  s.date = %q{2009-12-25}
+  s.description = %q{
+One interface to various JSON ruby libs (yajl, json, json_pure, json-jruby, active_support). Has a preference for yajl.
+  }
+  s.email = %q{jmettraux@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+     "README.rdoc"
+  ]
+  s.files = [
+    "CHANGELOG.txt",
+     "CREDITS.txt",
+     "LICENSE.txt",
+     "README.rdoc",
+     "Rakefile",
+     "lib/rufus-json.rb",
+     "lib/rufus/json.rb",
+     "rufus-json.gemspec",
+     "test/test.rb"
+  ]
+  s.homepage = %q{http://github.com/jmettraux/rufus-json/}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{rufus}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{One interface to various JSON ruby libs (yajl, json, json_pure, json-jruby, active_support). Has a preference for yajl.}
+  s.test_files = [
+    "test/test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<yajl-ruby>, [">= 0"])
+      s.add_development_dependency(%q<activesupport>, [">= 0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<yajl-ruby>, [">= 0"])
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<yajl-ruby>, [">= 0"])
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

data/test/test.rb

@@ -0,0 +1,133 @@
+
+#
+# testing rufus-json
+#
+# Fri Jul 31 13:05:37 JST 2009
+#
+
+require 'test/unit'
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'rufus/json'
+require 'rubygems'
+
+
+class JsonTest < Test::Unit::TestCase
+
+  def setup
+    Rufus::Json.backend = Rufus::Json::NONE
+  end
+  #def teardown
+  #end
+
+  def test_no_backend
+
+    assert_raise RuntimeError do
+      Rufus::Json.decode('nada')
+    end
+  end
+
+  def test_get_backend
+
+    assert_equal :none, Rufus::Json.backend
+
+    require 'json'
+
+    Rufus::Json.detect_backend
+
+    assert_not_equal :none, Rufus::Json.backend
+  end
+
+  def test_set_backend
+
+    require 'json'
+
+    Rufus::Json.backend = :json
+
+    assert_equal :json, Rufus::Json.backend
+  end
+
+  def test_decode_json
+
+    do_test_decode('json', Rufus::Json::JSON)
+  end
+
+  def test_encode_json
+
+    do_test_encode('json', Rufus::Json::JSON)
+  end
+
+  def test_dup_json
+
+    do_test_dup('json', Rufus::Json::JSON)
+  end
+
+  def test_decode_yajl
+
+    do_test_decode('yajl', Rufus::Json::YAJL)
+  end
+
+  def test_encode_yajl
+
+    do_test_encode('yajl', Rufus::Json::YAJL)
+  end
+
+  def test_dup_yajl
+
+    do_test_dup('yajl', Rufus::Json::YAJL)
+  end
+
+  def test_decode_as
+
+    do_test_decode('active_support', Rufus::Json::ACTIVE)
+  end
+
+  def test_encode_as
+
+    do_test_encode('active_support', Rufus::Json::ACTIVE)
+  end
+
+  def test_dup_as
+
+    do_test_dup('active_support', Rufus::Json::ACTIVE)
+  end
+
+  protected
+
+  def do_test_decode (lib, cons)
+
+    require lib
+
+    assert_raise RuntimeError do
+      Rufus::Json.decode('nada')
+    end
+
+    Rufus::Json.backend = cons
+    assert_equal [ 1, 2, 3 ], Rufus::Json.decode("[ 1, 2, 3 ]")
+  end
+
+  def do_test_encode (lib, cons)
+
+    require lib
+
+    assert_raise RuntimeError do
+      Rufus::Json.encode('nada')
+    end
+
+    Rufus::Json.backend = cons
+    assert_equal "[1,2,3]", Rufus::Json.encode([ 1, 2, 3 ])
+  end
+
+  def do_test_dup (lib, cons)
+
+    require lib
+
+    d0 = { 'id' => 'nada' }
+    d1 = { :id => :nada }
+
+    Rufus::Json.backend = cons
+
+    assert_equal({ 'id' => 'nada' }, Rufus::Json.dup(d0))
+    assert_equal({ 'id' => 'nada' }, Rufus::Json.dup(d1))
+  end
+end
+

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: rufus-json
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- John Mettraux
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-25 00:00:00 +09:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: "\n\
+  One interface to various JSON ruby libs (yajl, json, json_pure, json-jruby, active_support). Has a preference for yajl.\n  "
+email: jmettraux@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- CHANGELOG.txt
+- CREDITS.txt
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- lib/rufus-json.rb
+- lib/rufus/json.rb
+- rufus-json.gemspec
+- test/test.rb
+has_rdoc: true
+homepage: http://github.com/jmettraux/rufus-json/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: rufus
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: One interface to various JSON ruby libs (yajl, json, json_pure, json-jruby, active_support). Has a preference for yajl.
+test_files: 
+- test/test.rb