zeal 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in zeal.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 by Academia, 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,60 @@
+Zeal: eager loading (but not too eager) for ActiveRecord collections
+====================================================================
+
+Sometimes you need to eager load some associations, but it's not
+convenient to do so at the same time as loading the original records.
+Zeal is a simple gem that offers a couple of different ways to trigger
+ActiveRecord's built-in eager loading on an array of already-retrieved
+records.
+
+### For Example
+
+Let's say you want to do the equivalent of this:
+
+``` ruby
+User.find(:all, :limit => 10, :include => {:posts => :comments})
+```
+
+If you're reducing code duplication by loading Users in a before filter
+that's shared between multiple actions, it may not make sense to eager
+load the same associations for all of those pages. Instead, you can do
+this:
+
+``` ruby
+# before_filters.rb
+@users = User.find(:all, :limit => 10)
+
+# users_controller.rb
+def users_and_posts_and_stuff
+  @users.eager_load(:posts => :comments)
+end
+
+def users_and_friends_and_stuff
+  @users.eager_load(:friends, :countrymen)
+end
+```
+
+You can now avoid both N+1 and unnecessary preloading, while keeping
+your code as DRY as possible.
+
+### Usage
+
+There are two ways to use Zeal: the nicer, more intrusive way, and the
+more explicit, less intrusive way.
+
+``` ruby
+# more_intrusive.rb
+class Array
+  include Zeal
+end
+
+@users.eager_load(:friends, :countrymen)
+
+# less_intrusive.rb
+Zeal.eager_load(@users, :friends, :countrymen)
+
+# or alternately
+@users.extend(Zeal).eager_load(@users, :friends, :countrymen)
+```
+
+Your choice!

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/zeal.rb

@@ -0,0 +1,39 @@
+require "zeal/version"
+
+module Zeal
+  class EagerLoadError < RuntimeError; end
+
+  class << self
+    if Rails.version.to_s =~ /^3/
+      def eager_load(collection, *args)
+        ActiveRecord::Associations::Preloader.new(collection, args).run
+        collection
+      end
+    else
+      def eager_load(collection, *args)
+        class_of_collection(collection).send(:preload_associations, collection, args)
+        collection
+      end
+    end
+
+    private
+    def class_of_collection(collection)
+      klasses = collection.map(&:class).uniq
+      if klasses.count > 1
+        raise EagerLoadError, "Collection includes objects of multiple classes: #{klasses.inspect}"
+      end
+
+      klass = klasses.first
+      unless klass < ActiveRecord::Base
+        raise EagerLoadError, "#{klass} isn't an ActiveRecord class."
+      end
+
+      klass
+    end
+  end
+
+  def eager_load(*args)
+    Zeal.eager_load(self, *args)
+    self
+  end
+end

data/lib/zeal/version.rb

@@ -0,0 +1,3 @@
+module Zeal
+  VERSION = "0.0.1"
+end

data/zeal.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "zeal/version"
+
+Gem::Specification.new do |s|
+  s.name        = "zeal"
+  s.version     = Zeal::VERSION
+  s.authors     = ["Ryan Fitzgerald"]
+  s.email       = ["rfitz@academia.edu"]
+  s.homepage    = ""
+  s.summary     = %q{eager loading (but not too eager) for ActiveRecord collections}
+  s.description = %q{Zeal allows you to eager-load associations on ActiveRecord objects that have already been loaded from the database.}
+
+  s.rubyforge_project = "zeal"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: zeal
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ryan Fitzgerald
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-11-29 00:00:00.000000000 Z
+dependencies: []
+description: Zeal allows you to eager-load associations on ActiveRecord objects that
+  have already been loaded from the database.
+email:
+- rfitz@academia.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/zeal.rb
+- lib/zeal/version.rb
+- zeal.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: zeal
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: eager loading (but not too eager) for ActiveRecord collections
+test_files: []
+has_rdoc: