ohm 0.0.12 → 0.0.13

data/lib/ohm.rb

@@ -69,15 +69,22 @@ module Ohm
       # @example Get five posts sorted by number of votes and starting from the number 5 (zero based):
       #   @blog.posts.sort(Post, :by => :votes, :start => 5, :limit => 10")
       def sort(options = {})
+        return [] if empty?
         options[:start] ||= 0
         options[:limit] = [options[:start], options[:limit]] if options[:limit]
         instantiate(db.sort(key, options))
       end
 
+      # Sort the model instances by the given value.
       def sort_by(att, options = {})
         sort(options.merge(:by => model.key("*", att)))
       end
 
+      # @return [Ohm::Model, nil] Returns the first instance found or nil.
+      def first
+        sort(:limit => 1).first
+      end
+
       def to_ary
         all
       end

data/test/indices_test.rb

@@ -17,7 +17,12 @@ class IndicesTest < Test::Unit::TestCase
     end
 
     should "be able to find by the given attribute" do
-      assert_equal [@user1], User.find(:email, "foo")
+      assert_equal @user1, User.find(:email, "foo").first
+    end
+
+    should "return nil if no results are found" do
+      assert User.find(:email, "foobar").empty?
+      assert_equal nil, User.find(:email, "foobar").first
     end
 
     should "update indices when changing attribute values" do

data/test/model_test.rb

@@ -181,6 +181,11 @@ class TestRedis < Test::Unit::TestCase
 
       assert_equal %w[A B C D], Person.all.sort_by(:name, :order => "ALPHA").map { |person| person.name }
     end
+
+    should "return an empty array if there are no elements to sort" do
+      Ohm.flush
+      assert_equal [], Person.all.sort_by(:name)
+    end
   end
 
   context "Loading attributes" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ohm
 version: !ruby/object:Gem::Version 
-  version: 0.0.12
+  version: 0.0.13
 platform: ruby
 authors: 
 - Michel Martens
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-07-27 00:00:00 -03:00
+date: 2009-07-28 00:00:00 -03:00
 default_executable: 
 dependencies: []