From bb53c60fd04650f1347bd0800658fd4b1152405b Mon Sep 17 00:00:00 2001
From: claudiob <claudiob@gmail.com>
Date: Fri, 7 Dec 2012 08:45:45 -0800
Subject: Document the types of arguments accepted by AR#not

This commit stems from https://github.com/rails/rails/pull/8332#issuecomment-11127957

Since the formats in which conditions can be passed to `not` differ
from the formats in which conditions can be passed to `like` and `not_like`,
then I think it's worth adding rdoc and tests to show this behavior
---
 activerecord/lib/active_record/relation/query_methods.rb | 13 +++++++++++--
 activerecord/test/cases/relation/where_chain_test.rb     | 12 ++++++++++++
 2 files changed, 23 insertions(+), 2 deletions(-)

(limited to 'activerecord')

diff --git a/activerecord/lib/active_record/relation/query_methods.rb b/activerecord/lib/active_record/relation/query_methods.rb
index d3a13c8e2f..9484092430 100644
--- a/activerecord/lib/active_record/relation/query_methods.rb
+++ b/activerecord/lib/active_record/relation/query_methods.rb
@@ -14,6 +14,15 @@ module ActiveRecord
       # Returns a new relation expressing WHERE + NOT condition
       # according to the conditions in the arguments.
       #
+      # #not accepts conditions in one of these formats: String, Array, Hash.
+      # See #where for more details on each format.
+      #
+      #    User.where.not("name = 'Jon'")
+      #    # SELECT * FROM users WHERE name <> 'Jon'
+      #
+      #    User.where.not(["name = ?", "Jon"])
+      #    # SELECT * FROM users WHERE name <> 'Jon'
+      #
       #    User.where.not(name: "Jon")
       #    # SELECT * FROM users WHERE name <> 'Jon'
       #
@@ -40,7 +49,7 @@ module ActiveRecord
       end
 
       # Returns a new relation expressing WHERE + LIKE condition
-      # according to the conditions in the arguments.
+      # according to the conditions provided as a hash in the arguments.
       #
       #    Book.where.like(title: "Rails%")
       #    # SELECT * FROM books WHERE title LIKE 'Rails%'
@@ -53,7 +62,7 @@ module ActiveRecord
       end
 
       # Returns a new relation expressing WHERE + NOT LIKE condition
-      # according to the conditions in the arguments.
+      # according to the conditions provided as a hash in the arguments.
       #
       #    Conference.where.not_like(name: "%Kaigi")
       #    # SELECT * FROM conferences WHERE name NOT LIKE '%Kaigi'
diff --git a/activerecord/test/cases/relation/where_chain_test.rb b/activerecord/test/cases/relation/where_chain_test.rb
index 8409fc6571..edb3ea48b9 100644
--- a/activerecord/test/cases/relation/where_chain_test.rb
+++ b/activerecord/test/cases/relation/where_chain_test.rb
@@ -50,6 +50,18 @@ module ActiveRecord
       assert_equal(expected, relation.where_values.last)
     end
 
+    def test_not_eq_with_string_parameter
+      expected = Arel::Nodes::Not.new("title = 'hello'")
+      relation = Post.where.not("title = 'hello'")
+      assert_equal([expected], relation.where_values)
+    end
+
+    def test_not_eq_with_array_parameter
+      expected = Arel::Nodes::Not.new("title = 'hello'")
+      relation = Post.where.not(['title = ?', 'hello'])
+      assert_equal([expected], relation.where_values)
+    end
+
     def test_like
       expected = Arel::Nodes::Matches.new(Post.arel_table[:title], 'a%')
       relation = Post.where.like(title: 'a%')
-- 
cgit v1.2.3