internuity-quick_scopes 0.1 → 0.2

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2009 Internuity Ltd, Andrew Timberlake <andrew@andrewtimberlake.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

@@ -6,7 +6,9 @@ These are especially useful for quick modifications to a query on an association
 The named scopes added are:
 * <tt>order</tt>
 * <tt>limit</tt>
-* <tt>with</tt>
+* <tt>offset</tt>
+* <tt>with</tt> - alias for :include
+* <tt>where</tt> - alias for :conditions
 
 ==Examples
 With a User model having many Posts
@@ -18,8 +20,17 @@ With a User model having many Posts
 
   # Limit the results to a specific number
   user.posts.limit(5)
+
+  # Offset the results
+  user.posts.offset(5)
    
   # Include other associated models
   user.posts.with(:comments)
   user.posts.with(:comments, :author)
   user.posts.with({:comments => :author}, :author)
+
+  # Limit your results with conditions
+  user.posts.where(:published => true)
+
+==Note
+Some of these don't promote best practices for your code but can be very useful when working with the console.

data/Rakefile

@@ -31,7 +31,7 @@ end
 
 spec = Gem::Specification.new do |s| 
   s.name              = "quick_scopes"
-  s.version           = "0.1"
+  s.version           = "0.2"
   s.author            = "Andrew Timberlake"
   s.email             = "andrew@andrewtimberlake.com"
   s.homepage          = "http://www.internuity.net/projects/quick_scopes"

data/lib/quick_scopes.rb

@@ -14,4 +14,8 @@ class ActiveRecord::Base
   named_scope :where, lambda { |*conditions| 
     { :conditions => conditions.size == 1 ? conditions[0] : conditions }
   }
+
+  named_scope :offset, lambda { |offset|       
+    { :offset => offset }
+  }
 end

data/test/test_quick_scopes.rb

@@ -17,6 +17,14 @@ class QuickScopesTest < Test::Unit::TestCase
       should "have a with scope" do
         assert Post.scopes.include?(:with)
       end
+
+      should "have a where scope" do
+        assert Post.scopes.include?(:where)
+      end
+
+      should "have a offset scope" do
+        assert Post.scopes.include?(:offset)
+      end
     end
   end
 
@@ -46,6 +54,21 @@ class QuickScopesTest < Test::Unit::TestCase
     end
   end
 
+  context "using the offset named_scope" do
+    setup {
+      @post = Post.first
+    }
+
+    should "return 2 comments when offset by 1" do
+      assert_equal 2, @post.comments.limit(3).offset(1).to_a.size
+    end
+
+    should "return 1 comments when offset by 2" do
+      #Not sure why I have to add to_a?
+      assert_equal 1, @post.comments.limit(3).offset(2).to_a.size
+    end
+  end
+
   context "using the where named_scope" do
     setup {
       @post = Post.first

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: internuity-quick_scopes
 version: !ruby/object:Gem::Version 
-  version: "0.1"
+  version: "0.2"
 platform: ruby
 authors: 
 - Andrew Timberlake