minty_scopes 0.9.1

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "autotest"]
+	path = autotest
+	url = git://github.com/metaskills/autotest_railsplugin.git

data/README.mkdn

@@ -0,0 +1,88 @@
+What
+====
+
+A collection of handy `named_scope`s that you should be able to use in just about any model.
+
+Why
+===
+
+Named scopes turn ugly finders into pretty ones.
+
+Howto
+=====
+
+Specify the gem dependency in your `environment.rb`:
+
+    config.gem 'mintdigital-minty_scopes',
+                :lib => 'minty_scopes',
+                :source => "http://gems.github.com"
+
+Then install and unpack the gem:
+
+    rake gems:install
+    rake gems:unpack
+
+In any model, you can get the scopes by extending the module:
+
+    class Post < ActiveRecord::Base
+      extend MintyScopes
+    end
+
+Scopes
+======
+
+Scopes are grouped into modules by functionality. If you only want some scopes, feel free to extend only the modules you want: `extend MintyScopes::Timestamps`
+
+### Associations ###
+
+    with(:comments)       #=> :joins => :comments, :group => 'posts.id' (only posts with comments)
+    without(:comments)    #=> :joins => 'LEFT JOIN comments ON posts.id = comments.post_id', 
+                          #   :conditions => {'comments.id' => nil}
+    including(:comments)  #=> :include => [:comments]
+
+### Except ###
+
+    except(post)              #=> [ 'posts.id NOT IN (?)', post ]
+    except(post, post)        #=> [ 'posts.id NOT IN (?)', [post, post] ]
+    except(post_collection)   #=> [ 'posts.id NOT IN (?)', post_collection ]
+
+### Order ###
+
+    newest      #=> { :order => 'created_at DESC', :limit => per_page || limit }
+    newest(20)  #=> { :order => 'created_at DESC', :limit => 20 }
+    oldest      #=> { :order => 'created_at ASC',  :limit => per_page || limit }
+    oldest(20)  #=> { :order => 'created_at ASC',  :limit => 20 }
+
+### Timestamps ###
+
+    created_on(date)  #=> :created_at => (date.beginning_of_day..date.end_of_day)
+    modified_on(date) #=> :modified_at => (date.beginning_of_day..date.end_of_day)
+
+Thanks
+======
+
+Big thanks to Ryan Daigle for his [utility_scopes](http://github.com/yfactorial/utility_scope)  plugin, the inspiration for this project.
+
+License
+=======
+The MIT License
+
+Copyright (c) 2009 Dean Strelau, Mint Digital
+
+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/Rakefile

@@ -0,0 +1,32 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/gempackagetask'
+
+desc 'Default: Run Tests'
+task :default => :test
+
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "minty_scopes"
+    gem.summary = %Q{Useful, reusable named_scopes for ActiveRecord.}
+    gem.email = "philnash@gmail.com"
+    gem.homepage = "https://github.com/mintdigital/minty_scopes"
+    gem.authors = ["Dean Strelau", "Mint Digital"]
+    gem.extra_rdoc_files = ["README.mkdn", 'Rakefile']
+    gem.has_rdoc = false
+    gem.rdoc_options = ["--line-numbers", "--inline-source","--main", "README.txt"]
+    gem.add_dependency "activerecord", ">= 2.1.0"
+    gem.add_dependency "activesupport", ">= 2.1.0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.9.1

data/init.rb

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

data/lib/minty_scopes/associations.rb

@@ -0,0 +1,28 @@
+module MintyScopes
+  module Associations
+  
+    def self.extended(within)
+      within.class_eval do
+        # Only show items that have at least one of the associated items
+        # Meant for has_many associations
+        # Post.with(:comments)
+        named_scope :with, lambda { |assoc|
+          raise "The 'with' named_scope expects a non-nil argument." if assoc.nil?
+          { :joins => assoc.to_sym, :group => "#{quoted_table_name}.id" }
+        }
+        
+        named_scope :without, lambda {|assoc|
+          raise "The 'without' named_scope expects a non-nil argument." if assoc.nil?
+          { :joins => "LEFT JOIN #{assoc.to_s} "+
+              "ON #{quoted_table_name}.id = #{assoc.to_s}.#{quoted_table_name.singularize}_id",
+            :conditions => {"#{assoc}.id" => nil} }
+        }
+        named_scope :including, lambda {|*assocs|
+          { :include => assocs.flatten }
+        }
+        
+      end
+    end
+  
+  end
+end

data/lib/minty_scopes/except.rb

@@ -0,0 +1,17 @@
+module MintyScopes
+  module Except
+    
+    def self.extended(within)
+      within.class_eval do
+        # Allow easy rejection of items.
+        # Can take an a single id or ActiveRecord object, or an array of them
+        named_scope :except, lambda { |*args|
+          args.flatten!
+          raise "The 'except' named_scope expects no nil values." unless args.all?
+          { :conditions => ["#{quoted_table_name}.#{primary_key} NOT IN (?)", args] }
+        }
+      end
+    end
+    
+  end
+end

data/lib/minty_scopes/order.rb

@@ -0,0 +1,23 @@
+module MintyScopes
+  module Order
+    
+    def self.extended(within)
+      within.class_eval do
+        # Get only the newest items. Limit by given parameter.
+        # Default to per_page if will_paginate is installed or 10
+        named_scope :newest, lambda { |*limit| {
+          :order => "#{quoted_table_name}.created_at DESC",
+          :limit => limit.empty? ? (per_page rescue 10) : limit.first
+        } }
+
+        # Get only the oldest items. Limit by given parameter.
+        # Default to per_page if will_paginate is installed or 10
+        named_scope :oldest, lambda { |*limit| {
+          :order => "#{quoted_table_name}.created_at ASC",
+          :limit => limit.empty? ? (per_page rescue 10) : limit.first
+        } }
+      end
+    end
+    
+  end
+end

data/lib/minty_scopes/timestamps.rb

@@ -0,0 +1,23 @@
+module MintyScopes
+  module Timestamps
+    
+    def self.extended(within)
+      within.class_eval do
+        # Allow filtering by day of created_on
+        # Argument must be a Date, Time, or DateTime
+        named_scope :created_on, lambda { |date|
+          raise "The 'created_on' named_scope expects a Date, Time or DateTime object" unless date.respond_to? :end_of_day
+          { :conditions => {:created_at => (date.beginning_of_day..date.end_of_day)} }
+        }
+        
+        # Allow filtering by day of modified_on
+        # Argument must be a Date, Time, or DateTime
+        named_scope :modified_on, lambda { |date|
+          raise "The 'modified_on' named_scope expects a Date, Time or DateTime object" unless date.respond_to? :end_of_day
+          { :conditions => {:modified_on => (date.beginning_of_day..date.end_of_day)} }
+        }
+      end
+    end
+    
+  end
+end

data/lib/minty_scopes.rb

@@ -0,0 +1,13 @@
+require 'minty_scopes/associations'
+require 'minty_scopes/except'
+require 'minty_scopes/order'
+require 'minty_scopes/timestamps'
+
+module MintyScopes
+  def self.extended(within)
+    within.extend MintyScopes::Associations
+    within.extend MintyScopes::Except
+    within.extend MintyScopes::Order
+    within.extend MintyScopes::Timestamps
+  end
+end

data/minty_scopes.gemspec

@@ -0,0 +1,65 @@
+# 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{minty_scopes}
+  s.version = "0.9.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dean Strelau", "Mint Digital"]
+  s.date = %q{2009-12-04}
+  s.email = %q{philnash@gmail.com}
+  s.extra_rdoc_files = [
+    "README.mkdn",
+     "Rakefile"
+  ]
+  s.files = [
+    ".gitmodules",
+     "README.mkdn",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/minty_scopes.rb",
+     "lib/minty_scopes/associations.rb",
+     "lib/minty_scopes/except.rb",
+     "lib/minty_scopes/order.rb",
+     "lib/minty_scopes/timestamps.rb",
+     "minty_scopes.gemspec",
+     "test/test_helper.rb",
+     "test/units/associations_test.rb",
+     "test/units/except_test.rb",
+     "test/units/order_test.rb",
+     "test/units/timestamps_test.rb"
+  ]
+  s.homepage = %q{https://github.com/mintdigital/minty_scopes}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Useful, reusable named_scopes for ActiveRecord.}
+  s.test_files = [
+    "test/test_helper.rb",
+     "test/units/associations_test.rb",
+     "test/units/except_test.rb",
+     "test/units/order_test.rb",
+     "test/units/timestamps_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_runtime_dependency(%q<activerecord>, [">= 2.1.0"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.1.0"])
+    else
+      s.add_dependency(%q<activerecord>, [">= 2.1.0"])
+      s.add_dependency(%q<activesupport>, [">= 2.1.0"])
+    end
+  else
+    s.add_dependency(%q<activerecord>, [">= 2.1.0"])
+    s.add_dependency(%q<activesupport>, [">= 2.1.0"])
+  end
+end
+

data/test/test_helper.rb

@@ -0,0 +1,19 @@
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'minty_scopes'
+
+require 'test/unit'
+require 'rubygems'
+require 'shoulda'
+require 'active_record'
+require 'active_support'
+
+class Post < ActiveRecord::Base
+  def self.quoted_table_name; 'posts'; end
+  def self.primary_key; 'id'; end
+  extend MintyScopes
+end
+
+class PaginatedPost < Post
+  def self.per_page; 30; end
+  extend MintyScopes
+end

data/test/units/associations_test.rb

@@ -0,0 +1,39 @@
+require File.join(File.dirname(__FILE__), '..', 'test_helper')
+
+class AssociationsTest < Test::Unit::TestCase # :nodoc:
+  
+  context "with" do
+    should "complain if passed nil" do
+      assert_raise(RuntimeError) { Post.with(nil).proxy_options }
+    end
+    
+    should "return all objects with associated items" do
+      assert_equal( { :joins => :comments, :group => 'posts.id' },
+                    Post.with(:comments).proxy_options )
+    end
+  end
+  
+  context "without" do
+    should "complain if passed nil" do
+      assert_raise(RuntimeError) { Post.with(nil).proxy_options }
+    end
+    
+    should "return all objects without associated items" do
+      assert_equal( { :joins => "LEFT JOIN comments ON posts.id = comments.post_id", 
+                      :conditions => {"comments.id" => nil} },
+                    Post.without(:comments).proxy_options )
+    end
+  end
+  
+  context "including" do
+    should "return objects with given include" do
+      assert_equal( { :include => [:comments] },
+                    Post.including(:comments).proxy_options )
+    end
+    
+    should "return objects with all of given includes" do
+      assert_equal( { :include => [:comments, {:author => :avator}] },
+                    Post.including(:comments, {:author => :avator}).proxy_options )
+    end
+  end
+end

data/test/units/except_test.rb

@@ -0,0 +1,33 @@
+require File.join(File.dirname(__FILE__), '..', 'test_helper')
+
+class ExceptTest < Test::Unit::TestCase # :nodoc:
+  
+  context "except" do
+    should "complain if passed nil" do
+      assert_raise(RuntimeError){ Post.except(nil).proxy_options }
+    end
+    
+    should "complain if passed an array with nil" do
+      assert_raise(RuntimeError) { Post.except([99,nil,101]).proxy_options }
+    end
+    
+    should "return all but the given object" do
+      item = 123
+      assert_equal( { :conditions => ["posts.id NOT IN (?)", [item]] },
+                    Post.except(item).proxy_options )
+    end
+    
+    should "return all but the items in the given list" do
+      list = [123, 456, 7]
+      assert_equal( { :conditions => ["posts.id NOT IN (?)", list] },
+                    Post.except(list).proxy_options )
+    end
+    
+    should "return all but the given items" do
+      maple, oak = 42, 24
+      assert_equal( { :conditions => ["posts.id NOT IN (?)", [maple, oak]] },
+                    Post.except(maple, oak).proxy_options )
+    end
+  end
+  
+end

data/test/units/order_test.rb

@@ -0,0 +1,49 @@
+require File.join(File.dirname(__FILE__), '..', 'test_helper')
+
+class OrderTest < Test::Unit::TestCase # :nodoc:
+  
+  context "newest" do
+    should "return most recent items" do
+      assert Post.newest.proxy_options[:order] = 'posts.created_at DESC'
+    end
+    
+    should "default to 10 items" do
+      assert_equal 10, Post.newest.proxy_options[:limit]
+    end
+    
+    should "use the given limit" do
+      assert_equal 20, Post.newest(20).proxy_options[:limit]
+    end
+    
+    should "default to per_page if it exists" do
+      assert_equal 30, PaginatedPost.newest.proxy_options[:limit]
+    end
+    
+    should "use the given limit over per_page" do
+      assert_equal 15, PaginatedPost.newest(15).proxy_options[:limit]
+    end
+  end
+  
+  context "oldest" do
+    should "return oldest items" do
+      assert Post.oldest.proxy_options[:order] = 'posts.created_at ASC'
+    end
+    
+    should "default to 10 items" do
+      assert_equal 10, Post.oldest.proxy_options[:limit]
+    end
+    
+    should "use the given limit" do
+      assert_equal 20, Post.oldest(20).proxy_options[:limit]
+    end
+    
+    should "default to per_page if it exists" do
+      assert_equal 30, PaginatedPost.oldest.proxy_options[:limit]
+    end
+  
+    should "use the given limit over per_page" do
+      assert_equal 15, PaginatedPost.oldest(15).proxy_options[:limit]
+    end
+  end
+  
+end

data/test/units/timestamps_test.rb

@@ -0,0 +1,32 @@
+require File.join(File.dirname(__FILE__), '..', 'test_helper')
+
+class TimestampsTest < Test::Unit::TestCase # :nodoc:
+  def setup
+    @today = Date.today
+  end
+  
+  context "created_on" do
+    should "complain if passed a non date or time" do
+      assert_raise(RuntimeError){ Post.created_on(nil).proxy_options }
+    end
+  
+    should "return all objects created on the given date" do
+      assert_equal({:conditions =>
+                        { :created_at => (@today.beginning_of_day..@today.end_of_day) }
+                   }, Post.created_on(@today).proxy_options)
+    end
+  end
+  
+  context "modified_on" do
+    should "complain if passed a non date or time" do
+      assert_raise(RuntimeError){ Post.modified_on(nil).proxy_options }
+    end
+  
+    should "return all objects modified on the given date" do
+      assert_equal({:conditions =>
+                      { :modified_on => (@today.beginning_of_day..@today.end_of_day) }
+                   }, Post.modified_on(@today).proxy_options)
+    end
+  end
+  
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: minty_scopes
+version: !ruby/object:Gem::Version 
+  version: 0.9.1
+platform: ruby
+authors: 
+- Dean Strelau
+- Mint Digital
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-04 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.1.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.1.0
+    version: 
+description: 
+email: philnash@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.mkdn
+- Rakefile
+files: 
+- .gitmodules
+- README.mkdn
+- Rakefile
+- VERSION
+- init.rb
+- lib/minty_scopes.rb
+- lib/minty_scopes/associations.rb
+- lib/minty_scopes/except.rb
+- lib/minty_scopes/order.rb
+- lib/minty_scopes/timestamps.rb
+- minty_scopes.gemspec
+- test/test_helper.rb
+- test/units/associations_test.rb
+- test/units/except_test.rb
+- test/units/order_test.rb
+- test/units/timestamps_test.rb
+has_rdoc: true
+homepage: https://github.com/mintdigital/minty_scopes
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --main
+- README.txt
+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: Useful, reusable named_scopes for ActiveRecord.
+test_files: 
+- test/test_helper.rb
+- test/units/associations_test.rb
+- test/units/except_test.rb
+- test/units/order_test.rb
+- test/units/timestamps_test.rb