in_json 0.0.1

data/.document

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

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,24 @@
+source 'http://rubygems.org'
+# Add dependencies required to use your gem here.
+# Example:
+#   gem 'activesupport', '>= 2.3.5'
+
+gem 'activerecord', '>= 2.3.8', :require => 'active_record'
+gem 'activesupport', '>= 2.3.8', :require => 'active_support'
+gem 'json'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem 'rspec', '~> 2.3.0'
+  gem 'yard', '~> 0.6.0'
+  gem 'bundler', '~> 1.0.0'
+  gem 'jeweler', '~> 1.5.2'
+  gem 'rcov', '>= 0'
+  gem 'reek', '~> 1.2.8'
+  gem 'roodi', '~> 2.1.0'
+  gem 'autotest'
+  gem 'sqlite3'
+  gem 'rspec-rails'
+  gem 'database_cleaner'
+end

data/Gemfile.lock

@@ -0,0 +1,64 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.5.0)
+    activerecord (2.3.11)
+      activesupport (= 2.3.11)
+    activesupport (2.3.11)
+    autotest (4.4.6)
+      ZenTest (>= 4.4.1)
+    database_cleaner (0.6.4)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    json (1.5.1)
+    rack (1.2.1)
+    rake (0.8.7)
+    rcov (0.9.9)
+    reek (1.2.8)
+      ruby2ruby (~> 1.2)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    roodi (2.1.0)
+      ruby_parser
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    rspec-rails (1.3.2)
+      rack (>= 1.0.0)
+      rspec (>= 1.3.0)
+    ruby2ruby (1.2.5)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    ruby_parser (2.0.6)
+      sexp_processor (~> 3.0)
+    sexp_processor (3.0.5)
+    sqlite3 (1.3.3)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord (>= 2.3.8)
+  activesupport (>= 2.3.8)
+  autotest
+  bundler (~> 1.0.0)
+  database_cleaner
+  jeweler (~> 1.5.2)
+  json
+  rcov
+  reek (~> 1.2.8)
+  roodi (~> 2.1.0)
+  rspec (~> 2.3.0)
+  rspec-rails
+  sqlite3
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Henry Hsu
+
+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,19 @@
+= in_json
+
+JSON serialization for Rails. Straight-forward attributes. Only serialize what you want. Optimally obeys eager-loaded associations
+
+== Contributing to in_json
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Henry Hsu. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "in_json"
+  gem.homepage = "http://github.com/hsume2/in_json"
+  gem.license = "MIT"
+  gem.summary = %Q{Optimally straight-forward JSON serialization for Rails}
+  gem.description = %Q{JSON serialization for Rails. Straight-forward attributes. Only serialize what you want. Optimally obeys eager-loaded associations}
+  gem.email = "henry.hsu@photomugs.com"
+  gem.authors = ["Henry Hsu"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+  spec.rcov_opts = %w(--exclude gems)
+end
+
+require 'reek/rake/task'
+Reek::Rake::Task.new do |t|
+  t.fail_on_error = true
+  t.verbose = false
+  t.source_files = 'lib/**/*.rb'
+end
+
+require 'roodi'
+require 'roodi_task'
+RoodiTask.new do |t|
+  t.verbose = false
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/in_json.gemspec

@@ -0,0 +1,96 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{in_json}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Henry Hsu"]
+  s.date = %q{2011-03-10}
+  s.description = %q{JSON serialization for Rails. Straight-forward attributes. Only serialize what you want. Optimally obeys eager-loaded associations}
+  s.email = %q{henry.hsu@photomugs.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "in_json.gemspec",
+    "lib/in_json.rb",
+    "lib/in_json/ext/array.rb",
+    "spec/in_json_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/hsume2/in_json}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Optimally straight-forward JSON serialization for Rails}
+  s.test_files = [
+    "spec/in_json_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activerecord>, [">= 2.3.8"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.8"])
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<reek>, ["~> 1.2.8"])
+      s.add_development_dependency(%q<roodi>, ["~> 2.1.0"])
+      s.add_development_dependency(%q<autotest>, [">= 0"])
+      s.add_development_dependency(%q<sqlite3>, [">= 0"])
+      s.add_development_dependency(%q<rspec-rails>, [">= 0"])
+      s.add_development_dependency(%q<database_cleaner>, [">= 0"])
+    else
+      s.add_dependency(%q<activerecord>, [">= 2.3.8"])
+      s.add_dependency(%q<activesupport>, [">= 2.3.8"])
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<reek>, ["~> 1.2.8"])
+      s.add_dependency(%q<roodi>, ["~> 2.1.0"])
+      s.add_dependency(%q<autotest>, [">= 0"])
+      s.add_dependency(%q<sqlite3>, [">= 0"])
+      s.add_dependency(%q<rspec-rails>, [">= 0"])
+      s.add_dependency(%q<database_cleaner>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activerecord>, [">= 2.3.8"])
+    s.add_dependency(%q<activesupport>, [">= 2.3.8"])
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<yard>, ["~> 0.6.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<reek>, ["~> 1.2.8"])
+    s.add_dependency(%q<roodi>, ["~> 2.1.0"])
+    s.add_dependency(%q<autotest>, [">= 0"])
+    s.add_dependency(%q<sqlite3>, [">= 0"])
+    s.add_dependency(%q<rspec-rails>, [">= 0"])
+    s.add_dependency(%q<database_cleaner>, [">= 0"])
+  end
+end
+

data/lib/in_json/ext/array.rb

@@ -0,0 +1,17 @@
+module InJson
+  module ArrayExt
+    def self.included(base)
+      base.send :include, InstanceMethods
+    end
+
+    module InstanceMethods
+      def in_json(name = :default, overrule_definition = nil)
+        map { |entry| entry.respond_to?(:in_json) ? entry.in_json(name, overrule_definition) : entry }
+      end
+    end
+  end
+end
+
+Array.class_eval do
+  include InJson::ArrayExt
+end

data/lib/in_json.rb

@@ -0,0 +1,96 @@
+require 'in_json/ext/array'
+
+module InJson
+  def self.included(base)
+    base.extend ClassMethods
+    base.send :include, InstanceMethods
+  end
+
+  def self.with(name = :default, &block)
+    begin
+      Thread.current[:in_json_definition] = name
+      yield
+    ensure
+      Thread.current[:in_json_definition] = nil
+    end
+  end
+
+  # A {Definition} is a proxy class primarily for evaluating {InJson} blocks into a {Hash} definition.
+  #
+  #  class Post
+  #    in_json do
+  #      name
+  #      email
+  #    end # => {:email=>nil, :name=>nil}
+  #
+  #    in_json(:with_posts_and_comments_named) do
+  #      posts do
+  #        title
+  #        comments :only_approved
+  #      end
+  #    end # => {:posts=>{:title=>nil, :comments=>:only_approved}}
+  #  end
+  class Definition
+    def initialize
+      @hash = {}
+    end
+
+    # Stores any method calls as {Hash} keys
+    # @return [Hash] the evaluated definition
+    def method_missing(method, *args, &block)
+      method = method.to_s.sub(/^_/, '').to_sym if method.to_s =~ /^_.*/
+      @hash[method] = block_given? ? Definition.new.instance_eval(&block) : args.first
+      @hash
+    end
+  end
+
+  module ClassMethods
+    # Defines an {InJson} definition that can be used to convert an object to JSON format {InJson::InstanceMethods#in_json}
+    # @param [Symbol] name the name of the definition
+    # @yield a block of definitions
+    def in_json(name = :default, &block)
+      definitions = read_inheritable_attribute(:in_json_definitions) || {}
+
+      definitions[name] = Definition.new.instance_eval(&block)
+
+      write_inheritable_attribute :in_json_definitions, definitions
+    end
+  end
+
+  module InstanceMethods
+    # Returns a Hash that can be used as this object in JSON format
+    # @param [Symbol] name the {InJson} definition to evaluate
+    # @param [Symbol, Hash, nil] injected_definition a named {InJson} definition, a full Hash definition, or nil
+    # @return [Hash] the JSON-ready Hash
+    def in_json(name = :default, injected_definition = nil)
+      definition = in_json_definition(name, injected_definition)
+      attrs = attributes.freeze.symbolize_keys
+      return attrs unless definition
+      definition.inject({}) do |result, attr_dfn|
+        attr, definition = attr_dfn
+
+        result_at = attrs.has_key?(attr) ? attrs[attr] : send(attr)
+        result_at = result_at.in_json(name, definition) if result_at.respond_to?(:in_json) && !result_at.kind_of?(Class)
+
+        result[attr] = result_at
+        result
+      end
+    end
+    alias_method :as_json, :in_json
+
+    protected
+
+    def in_json_definition(name, injected_definition)
+      definitions = self.class.read_inheritable_attribute(:in_json_definitions)      
+      if Thread.current[:in_json_definition] || injected_definition.kind_of?(Symbol)
+        definitions && (definitions[Thread.current[:in_json_definition]] || definitions[injected_definition])
+      elsif injected_definition.kind_of?(Hash)
+        injected_definition
+      elsif definitions
+        definitions[name]        
+      end || (definitions && definitions[:default])
+    end
+  end
+end
+
+ActiveRecord::Base.class_eval { include InJson }

data/spec/in_json_spec.rb

@@ -0,0 +1,307 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+class User < ActiveRecord::Base
+  has_many :posts
+  has_many :blog_posts
+
+  in_json do
+    name
+    email
+  end
+
+  in_json(:with_reserved) do
+    _id
+    _type
+  end
+
+  in_json(:with_post_count) do
+    name
+    email
+    post_count
+  end
+
+  in_json(:with_posts) do
+    post_count
+    posts
+  end
+
+  in_json(:with_posts_nested) do
+    posts do
+      title
+      content
+    end
+  end
+
+  in_json(:with_posts_named) do
+    posts :only_content
+  end
+
+  in_json(:with_posts_and_comments) do
+    posts do
+      title
+      comments do
+        content
+      end
+    end
+  end
+
+  in_json(:with_posts_and_comments_named) do
+    posts do
+      title
+      comments :only_approved
+    end
+  end
+  
+  in_json(:with_posts_and_comments_missing) do
+    posts do
+      title
+      comments :always_missing
+    end
+  end
+
+  def post_count
+    self.posts.count
+  end
+end
+
+class Post < ActiveRecord::Base
+  belongs_to :user
+  has_many :comments
+  has_many :reviews
+
+  in_json do
+    title
+  end
+
+  in_json(:only_content) do
+    content
+  end
+
+  in_json(:with_user) do
+    user
+  end
+
+  in_json(:with_reviews) do
+    reviews do
+      score
+    end
+  end
+end
+
+class BlogPost < Post
+end
+
+class Comment < ActiveRecord::Base
+  belongs_to :post
+
+  in_json do
+    content
+  end
+
+  in_json(:only_approved) do
+    approved
+  end
+end
+
+class Review < ActiveRecord::Base
+  belongs_to :post
+end
+
+describe InJson do
+  before do
+    @user = User.create(:name => "John User", :email => "john@example.com")
+    @post = @user.posts.create(:title => "Hello World!", :content => "Welcome to my blog.")
+    @blog_post = @user.blog_posts.create(:title => "Hello World!", :content => "Welcome to my blog post.")
+    @comment = @post.comments.create(:content => "Great blog!", :approved => true)
+  end
+
+  it "should return model in json (default)" do
+    @user.in_json.should == {
+      :name => 'John User',
+      :email => 'john@example.com'
+    }
+  end
+
+  it "should return model in json without definition (default)" do
+    @user.in_json(:missing_def).should == {
+      :name => 'John User',
+      :email => 'john@example.com'
+    }
+  end
+
+  it "should return model in json with reserved methods" do
+    @user.in_json(:with_reserved).should == {
+      :id => @user.id,
+      :type => User
+    }
+  end
+
+  it "should return model in json with post count" do
+    @user.in_json(:with_post_count).should == {
+      :name => 'John User',
+      :email => 'john@example.com',
+      :post_count => 2
+    }
+  end
+
+  it "should return model in json with posts" do
+    @user.in_json(:with_posts).should == {
+      :post_count => 2,
+      :posts => [
+        { :title => 'Hello World!' },
+        { :title => 'Hello World!' }
+      ]
+    }
+  end
+
+  it "should return model in json with posts and nested definition" do
+    @user.in_json(:with_posts_nested).should == {
+      :posts => [
+        { :title => 'Hello World!', :content => 'Welcome to my blog.' },
+        { :title => 'Hello World!', :content => 'Welcome to my blog post.' }
+      ]
+    }
+  end
+
+  it "should return model in json with posts and named definition" do
+    @user.in_json(:with_posts_named).should == {
+      :posts => [
+        { :content => 'Welcome to my blog.' },
+        { :content => 'Welcome to my blog post.' }
+      ]
+    }
+  end
+
+  it "should return model in json with posts and comments" do
+    @user.in_json(:with_posts_and_comments).should == {
+      :posts => [
+        { :title => 'Hello World!', :comments=>[{:content=>"Great blog!"}] },
+        { :title => 'Hello World!', :comments=>[] }
+      ]
+    }
+  end
+
+  it "should return model in json with posts and comments named" do
+    @user.in_json(:with_posts_and_comments_named).should == {
+      :posts => [
+        { :title => 'Hello World!', :comments=>[{:approved=>true}] },
+        { :title => 'Hello World!', :comments=>[] }
+      ]
+    }
+  end
+  
+  it "should return model in json with posts and comments missing" do
+    @user.in_json(:with_posts_and_comments_missing).should == {
+      :posts => [
+        { :title => 'Hello World!', :comments=>[{:content=>"Great blog!"}] },
+        { :title => 'Hello World!', :comments=>[] }
+      ]
+    }
+  end
+
+  it "should use eager-loaded associations" do
+    lambda {  @user = User.find(:first, :include => { :posts => :comments })  }.should have_queries(3)
+
+    lambda {
+      @user.in_json(:with_posts_and_comments).should == {
+        :posts => [
+          { :title => 'Hello World!', :comments=>[{:content=>"Great blog!"}] },
+          { :title => 'Hello World!', :comments=>[] }
+        ]
+      }
+    }.should have_queries(0)
+  end
+
+  it "should use eager-loaded associations on collection" do
+    user = User.create(:name => "John User", :email => "john@example.com")
+    post = user.posts.create(:title => "Hello World!", :content => "Welcome to my blog.")
+
+    lambda {  @users = User.find(:all, :include => { :posts => :comments })  }.should have_queries(3)
+    lambda {
+      @users.in_json(:with_posts_and_comments).should == [{
+        :posts => [
+          { :title => 'Hello World!', :comments=>[{:content=>"Great blog!"}] },
+          { :title => 'Hello World!', :comments=>[] }
+        ]
+      },
+      {
+        :posts => [
+          { :title => 'Hello World!', :comments=>[] }
+        ]
+      }]
+    }.should have_queries(0)
+  end
+
+  it "should return model as json" do
+    @user_hash = JSON.parse(@user.to_json)
+    @user_hash['name'].should == 'John User'
+    @user_hash['email'].should == 'john@example.com'
+  end
+
+  it "should return collection as json" do
+    user = User.create(:name => "User John", :email => "example@john.com")
+    post = user.posts.create(:title => "Hello World!", :content => "Welcome to my blog.")
+    @users = User.find(:all, :include => { :posts => :comments })
+
+    @users_hash = JSON.parse(@users.to_json)
+    @users_hash.tap do |h|
+      h.size.should == 2
+      h[0].tap do |u|
+        u['name'].should == 'John User'
+        u['email'].should == 'john@example.com'
+      end
+      h[1].tap do |u|
+        u['name'].should == 'User John'
+        u['email'].should == 'example@john.com'
+      end
+    end
+  end
+
+  it "should return model in json when without definition and default" do
+    @review = @blog_post.reviews.create(:score => 5)
+    @review.in_json.should == {
+      :id => @review.id,
+      :post_id => @blog_post.id,
+      :score => 5
+    }
+  end
+
+  it "should return model in json when nested without default" do
+    @review = @blog_post.reviews.create(:score => 5)
+    @blog_post.in_json(:with_reviews).should == {
+      :reviews => [
+        { :score => 5 }
+      ]
+    }
+  end
+
+  it "should return model in json with post count via Thread" do
+    InJson.with(:with_post_count) do
+      @user.in_json.should == {
+        :name => 'John User',
+        :email => 'john@example.com',
+        :post_count => 2
+      }
+    end
+  end
+
+  it "should return model in json with posts and named definition via Thread" do
+    InJson.with(:with_posts_named) do
+      @user.in_json.should == {
+        :posts => [
+          { :content => 'Welcome to my blog.' },
+          { :content => 'Welcome to my blog post.' }
+        ]
+      }
+    end
+  end
+
+  it "should return model with user" do
+    @post.in_json(:with_user).should == {
+      :user => {
+        :name => 'John User',
+        :email => 'john@example.com'
+      }
+    }
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,98 @@
+require "rubygems"
+require "bundler/setup"
+Bundler.require(:default)
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'in_json'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+ActiveRecord::Base.establish_connection(:adapter => 'sqlite3', :database => ':memory:')
+
+[:users, :posts, :comments].each do |table|
+  ActiveRecord::Base.connection.drop_table table rescue nil
+end
+
+ActiveRecord::Base.connection.create_table :users do |t|
+  t.string :name
+  t.string :email
+end
+
+ActiveRecord::Base.connection.create_table :posts do |t|
+  t.string :title
+  t.text :content
+  t.integer :user_id
+  t.string :type
+end
+
+ActiveRecord::Base.connection.create_table :comments do |t|
+  t.text :content
+  t.boolean :approved
+  t.integer :post_id
+end
+
+ActiveRecord::Base.connection.create_table :reviews do |t|
+  t.integer :score
+  t.integer :post_id
+end
+
+ActiveRecord::Base.connection.class.class_eval do
+  IGNORED_SQL = [/^PRAGMA/, /^SELECT currval/, /^SELECT CAST/, /^SELECT @@IDENTITY/, /^SELECT @@ROWCOUNT/, /^SAVEPOINT/, /^ROLLBACK TO SAVEPOINT/, /^RELEASE SAVEPOINT/, /SHOW FIELDS/]
+
+  def execute_with_query_record(sql, name = nil, &block)
+    $queries_executed ||= []
+    $queries_executed << sql unless IGNORED_SQL.any? { |r| sql =~ r }
+    execute_without_query_record(sql, name, &block)
+  end
+
+  alias_method_chain :execute, :query_record
+end
+
+module ActiveRecordQueriesMatcher
+  class HaveQueries
+    def initialize(num)
+      @num = num
+    end
+
+    def matches?(target)
+      begin
+        $queries_executed = []
+        target.call
+        @num == $queries_executed.size
+      ensure
+        %w{ BEGIN COMMIT }.each { |x| $queries_executed.delete(x) }
+      end
+    end
+
+    def failure_message_for_should
+      "#{$queries_executed.size} instead of #{@num} queries were executed.#{$queries_executed.size == 0 ? '' : "\nQueries:\n#{$queries_executed.join("\n")}"}"
+    end
+  end
+
+  def have_queries(num = 1)
+    HaveQueries.new(num)
+  end
+end
+
+require 'database_cleaner'
+
+RSpec.configure do |config|
+  config.include ActiveRecordQueriesMatcher
+  
+  config.before(:suite) do
+    DatabaseCleaner.strategy = :transaction
+    DatabaseCleaner.clean_with(:truncation)
+  end
+
+  config.before(:each) do
+    DatabaseCleaner.start
+  end
+
+  config.after(:each) do
+    DatabaseCleaner.clean
+  end
+end

metadata

@@ -0,0 +1,292 @@
+--- !ruby/object:Gem::Specification 
+name: in_json
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Henry Hsu
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-10 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: activerecord
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 2
+        - 3
+        - 8
+        version: 2.3.8
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: activesupport
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 2
+        - 3
+        - 8
+        version: 2.3.8
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: json
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rspec
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: yard
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  requirement: *id005
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: bundler
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id006
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: jeweler
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 5
+        - 2
+        version: 1.5.2
+  requirement: *id007
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rcov
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id008
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: reek
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 2
+        - 8
+        version: 1.2.8
+  requirement: *id009
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: roodi
+  version_requirements: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 2
+        - 1
+        - 0
+        version: 2.1.0
+  requirement: *id010
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: autotest
+  version_requirements: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id011
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: sqlite3
+  version_requirements: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id012
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rspec-rails
+  version_requirements: &id013 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id013
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: database_cleaner
+  version_requirements: &id014 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id014
+description: JSON serialization for Rails. Straight-forward attributes. Only serialize what you want. Optimally obeys eager-loaded associations
+email: henry.hsu@photomugs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- in_json.gemspec
+- lib/in_json.rb
+- lib/in_json/ext/array.rb
+- spec/in_json_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/hsume2/in_json
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Optimally straight-forward JSON serialization for Rails
+test_files: 
+- spec/in_json_spec.rb
+- spec/spec_helper.rb