MONGOID-5453 Add .none_of query method (#5524)

* "none_of" query method

* update docs and release notes

* fix underline for header

Author: jamis

source/reference/queries.txt

@@ -324,7 +324,7 @@ conditions are added to the criteria:
   Band.where(name: 1).or(name: 2).selector
   # => {"$or"=>[{"name"=>"1"}, {"name"=>"2"}]}
 
-``any_of``, ``nor`` and ``not`` behave similarly, with ``not`` producing
+``any_of``, ``none_of``, ``nor`` and ``not`` behave similarly, with ``not`` producing
 different query shapes as described below.
 
 When ``and``, ``or`` and ``nor`` logical operators are used, they
@@ -425,6 +425,20 @@ The conditions are hoisted to the top level if possible:
   # => {"label"=>/Trust/, "name"=>"Astral Projection"}
 
 
+.. _none-of:
+
+``none_of`` Behavior
+--------------------
+
+``none_of`` adds a negated disjunction ("nor") built from its arguments to
+the existing conditions in the criteria. For example:
+
+.. code-block:: ruby
+
+  Band.where(label: /Trust/).none_of({name: 'Astral Projection'}, {name: /Best/})
+  # => {"label"=>/Trust/, "$nor"=>[{"name"=>"Astral Projection"}, {"name"=>/Best/}]}
+
+
 ``not`` Behavior
 ----------------
 

source/release-notes/mongoid-8.1.txt

@@ -371,4 +371,30 @@ example:
   # => <Band _id: 633c74113282a438a15d2b56, name: "Death Cab For Cutie">
 
 See the section on :ref:`Hash Assignment on Embedded Associations <hash-assignment>`
-for more details
+for more details
+
+
+Added ``none_of`` Query Method
+------------------------------
+
+With the addition of ``none_of``, Mongoid 8.1 allows queries to exclude
+conditions in bulk. The emitted query will encapsulate the specified 
+criteria in a ``$nor`` operation. For example:
+
+.. code:: ruby
+
+  class Building
+    include Mongoid::Document
+    field :city, type: String
+    field :height, type: Integer
+    field :purpose, type: String
+    field :occupancy, type: Integer
+  end
+
+  Building.where(city: 'Portland').
+    none_of(:height.lt => 100,
+            :purpose => 'apartment',
+            :occupancy.gt => 2500)
+
+This would query all buildings in Portland, excluding apartments, buildings less than
+100 units tall, and buildings with an occupancy greater than 2500 people.