utility_scopes 0.3.0

data/.gitignore

@@ -0,0 +1,2 @@
+doc
+pkg

data/CHANGELOG

@@ -0,0 +1,29 @@
+0.3.0
+
+Added only_pks named scope (and pks class method)
+
+0.2.3
+
+Renamed metaclass to eigenclass to avoid conflict w/ Rails' method of the same name 
+
+0.2.2
+
+* More flexible @ordered@ syntax (by jney - http://github.com/jney)
+
+0.2.1
+
+* Fixed except named scope not correctly determining its base class
+  (as reported by Marcus Crafter: http://github.com/crafterm)
+
+0.2.0
+
+* Added except scope from danielmorrison (http://github.com/danielmorrison)
+
+    Article.except(1, 2, 3)           # Get all articles whose id is NOT 1, 2 or 3
+    Article.except(@article)          # Get all articles except the given one
+    Article.except(Article.published) # Get all UN-published articles (poor example
+                                      # since it executes full "published" query first)
+
+0.1.0
+
+* Initial release with limit, with (eager loading) and ordered scopes.

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2008 Ryan Daigle
+ 
+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.textile

@@ -0,0 +1,146 @@
+h1. Utility Scopes
+
+h2. Summary
+
+Utility scopes provides a collection of utilitarian "named scopes":http://api.rubyonrails.com/classes/ActiveRecord/NamedScope/ClassMethods.html#M001246 for use with your
+ActiveRecord models.
+
+
+Utility scopes was originally announced "here":http://ryandaigle.com/articles/2008/8/20/named-scope-it-s-not-just-for-conditions-ya-know and has expanded in scope and functionality since then thanks to user contributions.  See the
+"CHANGELOG":http://github.com/yfactorial/utility_scopes/tree/master/CHANGELOG for contribution details. 
+
+Utility scopes has the following dependencies:
+
+* activerecord >= 2.1.0
+* rspec >= 1.1.4 (for specs only, not runtime)
+
+h2. Installation
+
+To install the utility_scopes gem run the following:
+
+  sudo gem install utility_scopes
+  
+And to enable the scopes in your project just require @utility_scopes@:
+
+  require 'utility_scopes'
+
+h3. Rails
+
+You can also specify the gem dependency if you're running Rails 2.1 in your @config/environment.rb@ file:
+
+  Rails::Initializer.run do |config|
+    # ...
+    config.gem "utility_scopes"
+  end
+
+You don't need to @require 'utility_scopes'@ in this case as Rails will automatically require it.
+  
+h2. Scopes
+
+Most examples assume the following @Article@ class:
+
+  class Article < ActiveRecord::Base
+    has_many :comments  # (assume each comment also has a :user)
+    has_many :contributors
+    belongs_to :author, :class_name => 'User'
+  end
+
+Named scopes are chainable by nature, meaning that the following is possible:
+
+  Article.with(:comments).except(1, 2, 3).ordered.limited(5)
+  
+Any exceptions to chainable scopes will be specified in their section below.
+  
+h3. With (eager-loading)
+
+The @with@ scope let's you eager load your model associations.  So instead of having to invoke @find(:all, :include => [:association1, :association2])@ just pass these association names into
+the @with@ named scope:
+
+  <pre><code>
+  # Get all articles and eager-load their comments, each comments' user, article contributors
+  # and the article author.
+  Article.with({ :comments => :user }, :contributors, :author)
+  
+  # Get all articles and eager-load their comments
+  Article.with(:comments)
+  </code></pre>
+
+Again, just pass in the same arguments into @eager@ that you would pass in as the @:include@ value to "ActiveRecord::Base#find":http://api.rubyonrails.com/classes/ActiveRecord/Base.html#M001298
+
+h3. Except
+
+_contributed by danielmorrison_
+
+@except@ excludes the given records from the result set:
+
+  Article.except(1, 2, 3)           # Get all articles whose id is NOT 1, 2 or 3
+  Article.except(@article)          # Get all articles except the given one
+  Article.except(@new_articles)     # Get all non-new articles
+  
+h3. Limited
+
+@limited@ lets you place a limit on the number of results returned.  By default
+the scope will limit the result set to 10 results if no argument is passed in:
+
+  Article.limited                # Get the first 10 articles
+  Article.except(1).limited(5)   # Get the first 5 articles where id != 1
+
+If you're using "will_paginate":http://github.com/mislav/will_paginate/tree/master and don't
+pass an argument to the scope then the @per_page@ value that is used by will_paginate
+will be used:
+
+  Article.per_page   #=> 20
+  Article.limited    # Get the first 20 articles   
+
+If you would like to specify a different default value you can do so on a per class basis
+using @default_limit@:
+
+  <pre><code>
+  # Set the default limit to be 15  
+  class Article < ActiveRecord::Base
+    default_limit 15
+  end
+  
+  Article.limited  # Get the first 15 articles
+  </code></pre>
+  
+h3. Ordered
+
+_Note: the @ordered@ scope cannot be chained with any other @order@ clauses_
+
+@ordered@ lets you dynamically specify the ordering of your result set.  If no
+arguments are given it will default to @created_at DESC@.  (@ordered@ is also
+available as @order_by@ and @sort_by@)
+
+  Article.ordered                 # Get all articles ordered by "created_at DESC"
+  Article.ordered(:id)            # Get all articles ordered by "id"
+  Article.ordered("rank ASC")     # Get all articles ordered by "rank ASC"
+  Article.order_by(:id)           # order_by and sort_by are alias to ordered
+  Article.order_by([:id, :desc], :popularity)           # can take a two-element array as parameter
+  Article.sort_by(:id => :desc, :popularity => :asc)   # can take a hash as parameter
+                                                        # only available for jruby/ruby 1.9
+  Article.order_by_id             # can be set as a sentence
+
+If you would like to specify a different default sort order you can do so on a per class basis
+using @ordered_by@:
+
+  <pre><code>
+  # Set the default order to be "published_at DESC"
+  class Article < ActiveRecord::Base
+    ordered_by 'published_at DESC'
+  end
+ 
+  Article.ordered              # Get all articles ordered by "published_at DESC"
+  Article.ordered("rank ASC")  # Get all articles ordered by "rank ASC"
+  </code></pre>
+
+The current default ordering for a class can always be accessed via @default_ordering@:
+
+  Article.default_ordering #=> "published_at DESC"
+
+h3. PKs
+
+@only_pks@ selects only the primary key column.  This is useful when combined with the @pks@ class method to get the primary key values as an array:
+
+  Article.published.limited(10).only_pks   # Get the first 10 published articles with only the 'id' value populated [<Article:XX>, <Article:XX>, ...]
+  Article.published.limited(10).pks   # Get the first 10 published article ids: [1, 2, 3 ...]

data/Rakefile

@@ -0,0 +1,39 @@
+require 'rubygems'
+require 'rake'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+
+desc 'Run the specs'
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ['--colour --format progress --loadby mtime --reverse']
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+ 
+desc 'Generate RDoc documentation.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_files.include('README.rdoc', 'LICENSE', 'Rakefile').
+    include('lib/**/*.rb')
+  
+  rdoc.main = "README.rdoc"
+  rdoc.title = "utility_scopes documentation"
+  
+  rdoc.rdoc_dir = 'doc' # rdoc output folder
+  rdoc.options << '--inline-source' << '--charset=UTF-8'
+  rdoc.options << '--webcvs=http://github.com/yfactorial/utility_scopes/tree/master/'
+end
+
+# Rakefile
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "utility_scopes"
+    gemspec.summary = "A collection of utilitarian named scopes providing common functionality for ActiveRecord models."
+    gemspec.description = "A collection of utilitarian named scopes providing common functionality for ActiveRecord models."
+    gemspec.email = "ryan@digitaltoniq.com"
+    gemspec.homepage = "http://github.com/yfactorial/utility_scopes"
+    gemspec.authors = ["Ryan Daigle", "Daniel Morrison"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install jeweler -s http://gemcutter.org"
+end

data/VERSION

@@ -0,0 +1 @@
+0.3.0

data/init.rb

@@ -0,0 +1 @@
+require 'utility_scopes'

data/lib/utility_scopes.rb

@@ -0,0 +1,17 @@
+require 'utility_scopes/limited'
+require 'utility_scopes/ordered'
+require 'utility_scopes/eager'
+require 'utility_scopes/except'
+require 'utility_scopes/pks'
+  
+if defined?(ActiveRecord)
+
+  ActiveRecord::Base.class_eval do
+    include UtilityScopes::Limited
+    include UtilityScopes::Ordered
+    include UtilityScopes::Eager
+    include UtilityScopes::Except
+    include UtilityScopes::Pks
+  end
+  
+end

data/lib/utility_scopes/eager.rb

@@ -0,0 +1,10 @@
+module UtilityScopes
+  module Eager
+    
+    def self.included(within)
+      within.class_eval do
+        named_scope :with, lambda { |*associations| { :include => associations } }
+      end
+    end
+  end
+end

data/lib/utility_scopes/except.rb

@@ -0,0 +1,41 @@
+module UtilityScopes
+  module Except
+    
+    def self.included(within)      
+      within.class_eval do
+        
+        # Give every class the ability to add to itself the except named
+        # scope
+        extend ClassMethods
+        
+        # And automatically do so for all its subclasses
+        def self.inherited_with_except_scope_hook(child)
+          inherited_without_except_scope_hook(child)
+          child.attach_except_utility_scope
+        end
+        class << self
+          alias_method_chain :inherited, :except_scope_hook
+        end
+      end
+    end
+    
+    module ClassMethods
+      
+      # Must be a class method called directly on AR::Base subclasses
+      # so named_scope knows who its base class, and thus, table_name
+      # and primary_key are.
+      def attach_except_utility_scope
+      
+        # Allow easy rejection of items. 
+        # Can take an a single id or ActiveRecord object, or an array of them
+        # Example: 
+        #   before   Article.all.reject{|a| a == @bad_article }
+        #   after    Article.except(@bad_article)
+        named_scope :except, lambda { |item_or_list|
+          # nil or empty array causes issues here with mysql
+          item_or_list.blank? ? {} : {:conditions => ["#{quoted_table_name}.#{primary_key} NOT IN (?)", item_or_list]}
+        }
+      end      
+    end
+  end
+end

data/lib/utility_scopes/limited.rb

@@ -0,0 +1,26 @@
+module UtilityScopes
+  module Limited
+    
+    def self.included(within)
+      
+      within.class_eval do
+      
+        # Provide default limit scope (can be overridden
+        # if default_limit is called)
+        named_scope :limited, lambda { |*num|
+          { :limit => num.flatten.first || (defined?(per_page) ? per_page : 10) }
+        }
+        
+        extend ClassMethods
+      end
+    end
+    
+    module ClassMethods
+      
+      # Set the default limit to use for the limit scope
+      def default_limit(default)
+        named_scope :limited, lambda { |*num| { :limit => num.flatten.first || default } }
+      end      
+    end
+  end
+end

data/lib/utility_scopes/ordered.rb

@@ -0,0 +1,82 @@
+#TODO: use base_class to get rid off duplication?
+module UtilityScopes
+  module Ordered
+    
+    def self.included(base)
+      base.extend ClassMethods
+      
+      base.class_eval do
+        # Provide an ordered scope
+        named_scope(:ordered, lambda { |*order|
+          { :order => case
+            when order.empty?
+              self.default_ordering
+            # allow hash support for jruby or ruby 1.9
+            when order.size == 1 && order[0].is_a?(Hash) && (PLATFORM=~/java/ || RUBY_VERSION=~/1\.9.*/)
+              order.first.collect{|(k,v)| "#{k} #{v.to_s.upcase}"}.join(', ')
+            else
+              order.collect{|e| e.is_a?(Array) ? "#{e[0]} #{e[1].to_s.upcase}" : e}.join(', ')
+            end
+          }
+        })
+        
+        class << self
+          # Set alias order_by
+          alias_method :order_by, :ordered
+          # Set alias sort_by
+          alias_method :sort_by, :ordered
+          # Set the default order
+          define_method(:default_ordering) { 'created_at DESC' }
+        end
+      end
+    end
+    
+    module ClassMethods
+      
+      # Decorate this class with the ability to order itself in queries
+      # either from a given parameter or from its default ordering:
+      #
+      #   class Article < ActiveRecord::Base
+      #     ordered_by "published_at DESC"
+      #   end
+      #
+      #   Article.ordered #=> all items ordered by "published_at DESC"
+      #   Article.ordered('popularity ASC') #=> all items ordered by "popularity ASC"
+      #   Article.default_ordering #=> "published_at DESC"
+      #
+      def ordered_by(clause)
+        # Override named scope on AR::Base so we can access default_ordering
+        # on subclass
+        named_scope(:ordered, lambda { |*order|
+          { :order => case
+            when order.empty?
+              self.default_ordering
+            # allow hash support for jruby or ruby 1.9
+            when order.size == 1 && order[0].is_a?(Hash) && (PLATFORM=~/java/ || RUBY_VERSION=~/1\.9.*/)
+              order.first.collect{|(k,v)| "#{k} #{v.to_s.upcase}"}.join(', ')
+            else
+              order.collect{|e| e.is_a?(Array) ? "#{e[0]} #{e[1].to_s.upcase}" : e}.join(', ') 
+            end
+          }
+        })
+        
+        eigenclass.instance_eval do
+          define_method(:default_ordering) { clause }
+        end
+      end
+      
+      def method_missing(method, *args, &block)
+        col = method.to_s.match(/^(order_by_|sort_by_)(.*)$/)[2] rescue false
+        if col && self.columns.collect{ |c| c.name }.include?(col)
+          return self.order_by(col, *args, &block)
+        else
+          super
+        end
+      end
+      
+      private
+      
+      def eigenclass; class << self; self end; end
+    end
+  end
+end

data/lib/utility_scopes/pks.rb

@@ -0,0 +1,23 @@
+module UtilityScopes
+  module Pks
+    
+    def self.included(within)
+      
+      within.class_eval do        
+        extend ClassMethods
+      end
+    end
+    
+    module ClassMethods
+
+      # Can't use named_scope b/c don't have access to table_name etc... yet
+      def only_pks
+        scoped(:select => "`#{table_name}`.#{primary_key}")
+      end
+
+      def pks
+        only_pks.collect(&:"#{primary_key}")
+      end
+    end
+  end
+end

data/spec/abstract_spec.rb

@@ -0,0 +1,10 @@
+require File.join(File.dirname(__FILE__), *%w[spec_helper])
+require 'activerecord'
+
+$:.unshift "#{File.dirname(__FILE__)}/../lib"
+require 'utility_scopes'
+
+# Load a test class
+def uses_fixture(fixture_name)
+  require File.join(File.dirname(__FILE__), 'fixtures', fixture_name.to_s)
+end

data/spec/eager_spec.rb

@@ -0,0 +1,20 @@
+require File.join(File.dirname(__FILE__), *%w[abstract_spec])
+
+describe "Eager scope" do
+
+  before do
+    uses_fixture(:article)
+  end
+  
+  it "should provide eager loading of a single association" do
+    Article.with(:comments).proxy_options.should == {:include => [:comments] }
+  end
+
+  it "should provide eager loading of a multiple associations" do
+    Article.with(:comments, :contributors).proxy_options.should == {:include => [:comments, :contributors] }
+  end
+  
+  it "should provider eager loading of nested associations" do
+    Article.with(:comments => :author).proxy_options.should == {:include => [ {:comments => :author} ] }
+  end
+end

data/spec/except_spec.rb

@@ -0,0 +1,25 @@
+require File.join(File.dirname(__FILE__), *%w[abstract_spec])
+
+describe "except scope" do
+
+  before do
+    uses_fixture(:article)
+    # Stub these so it doesn't try to hit the (non-existant) database
+    Article.stub!(:quoted_table_name).and_return("'articles'")
+    Article.stub!(:primary_key).and_return('id')
+  end
+  
+  it "should not change the scope with nil" do
+    Article.except(nil).proxy_options.should == {}
+  end
+  
+  it "should return all items except the one specified" do
+    item = 123
+    Article.except(item).proxy_options.should == {:conditions => ["'articles'.id NOT IN (?)", item]}
+  end
+  
+  it "should return all items except ones in the list specified" do
+    list = [123, 456, 7]
+    Article.except(list).proxy_options.should == {:conditions => ["'articles'.id NOT IN (?)", list]}
+  end
+end

data/spec/fixtures/article.rb

@@ -0,0 +1,2 @@
+class Article < ActiveRecord::Base
+end

data/spec/limit_spec.rb

@@ -0,0 +1,36 @@
+require File.join(File.dirname(__FILE__), *%w[abstract_spec])
+
+describe "limited scope" do
+
+  before do
+    uses_fixture(:article)
+  end
+
+  it "should default to a limited of 10" do
+    Article.limited.proxy_options.should == {:limit => 10}
+  end
+  
+  it "should allow the limited to be specified at runtime" do
+    Article.limited(20).proxy_options.should == {:limit => 20}
+  end
+  
+  it "should find the per_page value from will_paginate" do
+    ActiveRecord::Base.instance_eval { def per_page; 50; end }
+    Article.limited.proxy_options.should == {:limit => 50}
+  end
+  
+  it "should use the runtime limited value over the per_page value from will_paginate" do
+    ActiveRecord::Base.instance_eval { def per_page; 50; end }
+    Article.limited(5).proxy_options.should == {:limit => 5}
+  end
+  
+  it "should allow override the default limited value with 'default_limited'" do
+    Article.default_limit 13
+    Article.limited.proxy_options.should == {:limit => 13}
+  end
+  
+  it "should use the runtime value over the default limited value set with 'default_limited'" do
+    Article.default_limit 13
+    Article.limited(25).proxy_options.should == {:limit => 25}
+  end
+end

data/spec/ordered_spec.rb

@@ -0,0 +1,64 @@
+require File.join(File.dirname(__FILE__), *%w[abstract_spec])
+
+describe "Ordered scope" do
+
+  before(:each) do
+    uses_fixture(:article)
+  end
+
+  it "should default to created_at DESC" do
+    Article.ordered.proxy_options.should == {:order => 'created_at DESC'}
+    Article.default_ordering.should == 'created_at DESC'
+  end
+  
+  it "should allow the order to be specified at runtime" do
+    Article.ordered('created_at ASC').proxy_options.should == {:order => 'created_at ASC'}
+  end
+  
+  it "should allow the order to use arrays as arg" do
+    Article.ordered([:popularity, :asc], [:second_param, :desc]).proxy_options.should == {:order => 'popularity ASC, second_param DESC'}
+  end
+  
+  it "should allow the order hash as arg" do
+    if (PLATFORM=~/java/ || RUBY_VERSION=~/1\.9.*/)
+      Article.ordered(:popularity => :asc, :second_param => :desc).proxy_options.should == {:order => 'popularity ASC, second_param DESC'}
+    end
+  end
+  
+  it "should allow the order with several args" do
+    Article.ordered(:popularity, :updated_at).proxy_options.should == {:order => 'popularity, updated_at'}
+  end
+
+  it "should sort by column popularity when calling order_by_popularity" do
+    require 'ostruct'
+    columns = [OpenStruct.new({:name => 'popularity'})]
+    Article.stub!(:columns).and_return(columns)
+    Article.order_by_popularity.proxy_options.should == {:order => 'popularity'}
+  end
+  
+  it "should raise an error when column does not exist" do
+    require 'ostruct'
+    columns = [OpenStruct.new({:name => 'popularity'})]
+    Article.stub!(:columns).and_return(columns)
+    lambda{ Article.order_by_unknown_columns }.should raise_error
+  end
+  
+  it "should have an alias" do
+    Article.order_by([:popularity, :asc]).proxy_options.should == {:order => 'popularity ASC'}
+  end
+  
+  it "should allow the default to be overidden by using ordered_by" do
+    Article.ordered_by 'published_at DESC'
+    Article.default_ordering.should == 'published_at DESC'
+    Article.ordered.proxy_options.should == {:order => 'published_at DESC'}
+  end
+  
+  it "should use the runtime sort value over the ordered_by value" do
+    Article.ordered_by 'published_at DESC'
+    Article.ordered('popularity ASC').proxy_options.should == {:order => 'popularity ASC'}
+  end
+  
+  it "should be able to handle symbol order criteria" do
+    Article.ordered(:id).proxy_options.should == { :order => 'id' }
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'spec'
+
+Spec::Runner.configure do |config|
+end

data/utility_scopes.gemspec

@@ -0,0 +1,67 @@
+# 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{utility_scopes}
+  s.version = "0.3.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ryan Daigle", "Daniel Morrison"]
+  s.date = %q{2009-12-11}
+  s.description = %q{A collection of utilitarian named scopes providing common functionality for ActiveRecord models.}
+  s.email = %q{ryan@digitaltoniq.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.textile"
+  ]
+  s.files = [
+    ".gitignore",
+     "CHANGELOG",
+     "LICENSE",
+     "README.textile",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/utility_scopes.rb",
+     "lib/utility_scopes/eager.rb",
+     "lib/utility_scopes/except.rb",
+     "lib/utility_scopes/limited.rb",
+     "lib/utility_scopes/ordered.rb",
+     "lib/utility_scopes/pks.rb",
+     "spec/abstract_spec.rb",
+     "spec/eager_spec.rb",
+     "spec/except_spec.rb",
+     "spec/fixtures/article.rb",
+     "spec/limit_spec.rb",
+     "spec/ordered_spec.rb",
+     "spec/spec_helper.rb",
+     "utility_scopes.gemspec"
+  ]
+  s.homepage = %q{http://github.com/yfactorial/utility_scopes}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A collection of utilitarian named scopes providing common functionality for ActiveRecord models.}
+  s.test_files = [
+    "spec/abstract_spec.rb",
+     "spec/eager_spec.rb",
+     "spec/except_spec.rb",
+     "spec/fixtures/article.rb",
+     "spec/limit_spec.rb",
+     "spec/ordered_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::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: utility_scopes
+version: !ruby/object:Gem::Version 
+  version: 0.3.0
+platform: ruby
+authors: 
+- Ryan Daigle
+- Daniel Morrison
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-11 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: A collection of utilitarian named scopes providing common functionality for ActiveRecord models.
+email: ryan@digitaltoniq.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.textile
+files: 
+- .gitignore
+- CHANGELOG
+- LICENSE
+- README.textile
+- Rakefile
+- VERSION
+- init.rb
+- lib/utility_scopes.rb
+- lib/utility_scopes/eager.rb
+- lib/utility_scopes/except.rb
+- lib/utility_scopes/limited.rb
+- lib/utility_scopes/ordered.rb
+- lib/utility_scopes/pks.rb
+- spec/abstract_spec.rb
+- spec/eager_spec.rb
+- spec/except_spec.rb
+- spec/fixtures/article.rb
+- spec/limit_spec.rb
+- spec/ordered_spec.rb
+- spec/spec_helper.rb
+- utility_scopes.gemspec
+has_rdoc: true
+homepage: http://github.com/yfactorial/utility_scopes
+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: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A collection of utilitarian named scopes providing common functionality for ActiveRecord models.
+test_files: 
+- spec/abstract_spec.rb
+- spec/eager_spec.rb
+- spec/except_spec.rb
+- spec/fixtures/article.rb
+- spec/limit_spec.rb
+- spec/ordered_spec.rb
+- spec/spec_helper.rb