mongoid 2.1.9 → 2.2.0

data/CHANGELOG.md

@@ -0,0 +1,281 @@
+# Overview
+
+For instructions on upgrading to newer versions, visit [mongoid.org](http://mongoid.org/docs/upgrading.html).
+
+## 2.2.0
+
+### New Features
+
+* Mongoid now contains eager loading in the form of `Criteria#includes(|*args)`.
+  This works on all relational associations and requires the identity map to
+  be enabled in order to function. Set `identity_map_enabled: true` in your
+  `mongoid.yml`.
+
+* Relations can now take a module as a value to the `:extend` option. (Roman
+  Shterenzon)
+
+* Capped collections can be created by passing the options to the `#store_in`
+  macro: `Person.store_in :people, capped: true, max: 1000000`
+
+* Mongoid::Collection now supports `collection.find_and_modify`
+
+* `Document#has_attribute?` now aliases to `Document#attribute_present?`
+
+* \#930 You can now turn off the Mongoid logger via the mongoid.yml by
+doing `logger: false`
+
+* \#909 We now raise a `Mongoid::Errors::Callback` exception if persisting with
+a bang method and a callback returns false, instead of the uninformative
+validations error from before.
+
+### Major Changes
+
+* \#1173 has_many relations no longer delete all documents on a set of the relation
+ (= [ doc_one, doc_two ]) but look to the dependent option to determine what
+ behaviour should occur. :delete and :destroy will behave as before, :nullify and
+ no option specified will both nullify the old documents without deleting.
+
+* \#1142, \#767 Embedded relations no longer immediately persist atomically
+when accessed via a parent attributes set. This includes nested attributes setting
+and `attributes=` or `write_attributes`. The child changes then remain dirty and
+atomically update when save is called on them or the parent document.
+
+### Resolved Issues
+
+* \#1190 Fixed the gemspec errors due to changing README and CHANGELOG to markdown.
+
+* \#1180, \#1084, \#955 Mongoid now checks the field types rather than if the name
+contains `/id/` when trying to convert to object ids on criteria.
+
+* \#1176 Enumerable targets should always return the in memory documents first,
+when calling `#first`
+
+* \#1175 Make sure both sides of many to many relations are in sync during a create.
+
+* \#1172 Referenced enumerable relations now properly handle `#to_json`
+(Daniel Doubrovkine)
+
+* \#1040 Increased performance of class load times by removing all delegate calls
+to self.class.
+
+## 2.1.9
+
+### Resolved Issues
+
+* \#1159 Fixed build blocks not to cancel out each other when nested.
+
+* \#1154 Don't delete many-to-many documents on empty array set.
+
+* \#1153 Retain parent document reference in after callbacks.
+
+* \#1151 Fix associated validation infinite loop on self referencing documents.
+
+* \#1150 Validates associated on `belongs_to` is `false` by default.
+
+* \#1149 Fixed metadata setting on `belongs_to` relations.
+
+* \#1145 Metadata inverse should return `nil` if `inverse_of` was set as `nil`.
+
+* \#1139 Enumerable targets now quack like arrays.
+
+* \#1136 Setting `belongs_to` parent to `nil` no longer deletes the parent.
+
+* \#1120 Don't call `in_memory` on relations if they don't respond to it.
+
+* \#1075 Set `self` in default procs to the document instance.
+
+* \#1072 Writing attributes for nested documents can take a hash or array of hashes.
+
+* \#990 Embedded documents can use a single `embedded_in` with multiple parent definitions.
+
+## 2.1.8
+
+### Resolved Issues
+
+* \#1148 Fixed `respond_to?` on all relations to return properly.
+
+* \#1146 Added back the Mongoid destructive fields check when defining fields.
+
+* \#1141 Fixed conversions of `nil` values in criteria.
+
+* \#1131 Verified Mongoid/Kaminari paginating correctly.
+
+* \#1105 Fixed atomic update consumer to be scoped to class.
+
+* \#1075 `self` in default lambdas and procs now references the document instance.
+
+* \#740 Removed `embedded_object_id` configuration parameter.
+
+* \#661 Fixed metadata caching on embedded documents.
+
+* \#595 Fixed relation reload flagging.
+
+* \#410 Moving documents from one relation to another now works as expected.
+
+## 2.1.7
+
+This was a specific release to fix MRI 1.8.7 breakages introduced by 2.1.6.
+
+## 2.1.6
+
+### Resolved Issues
+
+* \#1126 Fix setting of relations with other relation proxies.
+
+* \#1122 Hash and array fields now properly flag as dirty on access and change.
+
+* \#656 Fixed reload breaking relations on unsetting of already loaded associations.
+
+* \#647 Prefer `#unset` to `#remove_attribute` for removing values.
+
+* \#290 Verify pushes into deeply embedded documents.
+
+## 2.1.5
+
+### Resolved Issues
+
+* \#1116 Embedded children retain reference to parent in destroy callbacks.
+
+* \#1110, \#1115 Don't memoize metadata related helpers on documents.
+
+* \#1112 `db:create_indexes` no longer indexes subclasses multiple times.
+
+* \#1111, \#1098 Don't set `_id` in `$set` operations.
+
+* \#1007 Update attribute properly tracks array changes.
+
+## 2.1.4
+
+This was a specific release to get a Psych generated gemspec so no more parse errors would occur on those rubies that were using the new YAML parser.
+
+## 2.1.3
+
+### Resolved Issues
+
+* \#1109 Fixed validations not loading one to ones into memory.
+
+* \#1107 Mongoid no longer wants required `mongoid/railtie` in `application.rb`.
+
+* \#1102 Fixed nested attributes deletion.
+
+* \#1097 Reload now runs `after_initialize` callbacks.
+
+* \#1079 Embeds many no longer duplicates documents.
+
+* \#1078 Fixed array criteria matching on embedded documents.
+
+* \#1028 Implement scoped on one-to-many and many-to-many relations.
+
+* \#988 Many-to-many clear no longer deletes the child documents.
+
+* \#977 Autosaving relations works also through nested attributes.
+
+* \#972 Recursive embedding now handles namespacing on generated names.
+
+* \#943 Don't override `Document#attributes`.
+
+* \#893 Verify count is not caching on many to many relations.
+
+* \#815 Verify `after_initialize` is run in the correct place.
+
+* \#793 Verify `any_of` scopes chain properly with any other scope.
+
+* \#776 Fixed mongoid case quality when dealing with subclasses.
+
+* \#747 Fixed complex criteria using its keys to render its string value.
+
+* \#721 `#safely` now properly raises validation errors when they occur.
+
+## 2.1.2
+
+### Resolved Issues
+
+* \#1082 Alias `size` and `length` to `count` on criteria. (Adam Greene)
+
+* \#1044 When multiple relations are defined for the same class, always return the default inverse first if `inverse_of` is not defined.
+
+* \#710 Nested attributes accept both `id` and `_id` in hashes or arrays.
+
+* \#1047 Ignore `nil` values passed to `embeds_man` pushes and substitution. (Derick Bailey)
+
+## 2.1.1
+
+### Resolved Issues
+
+* \#1021, \#719 Many to many relations dont trigger extra database queries when pushing new documents.
+
+* \#607 Calling `create` on large associations does not load the entire relation.
+
+* \#1064 `Mongoid::Paranoia` should respect `unscoped` and `scoped`.
+
+* \#1026 `model#update_attribute` now can update booleans to `false`.
+
+* \#618 Crack XML library breaks Mongoid by adding `#attributes` method to the `String` class. (Stephen McGinty)
+
+## 2.1.0
+
+### Major Changes
+
+* Mongoid now requires MongoDB 1.8.x in order to properly support the `#bit` and `#rename` atomic operations.
+
+* Traditional slave support has been removed from Mongoid. Replica sets should be used in place of traditional master and slave setups.
+
+* Custom field serialization has changed. Please see [serializable](https://github.com/mongoid/mongoid/blob/master/lib/mongoid/fields/serializable.rb) for changes.
+
+* The dirty attribute tracking has been switched to use ActiveModel, this brings many bug fixes and changes:
+
+  * \#756 After callbacks and observers see what was changed instead of changes just made being in previous_changes
+
+  * \#434 Documents now are flagged as dirty when brand new or the state on instantiation differs from the database state. This is consistent with ActiveRecord.
+
+  * \#323 Mongoid now supports [field]_will_change! from ActiveModel::Dirty
+
+* Mongoid model preloading in development mode now defaults to `false`.
+
+* `:autosave => true` on relational associations now saves on update as well as create.
+
+* Mongoid now has an identity map for simple `find_by_id` queries. See the website for documentation.
+
+### New Features
+
+* \#1067 Fields now accept a `:versioned` attribute to be able to disable what fields are versioned with `Mongoid::Versioning`. (Jim Benton)
+
+* \#587 Added order preference to many and many to many associations. (Gregory Man)
+
+* Added ability to chain `order_by` statements. (Gregory Man)
+
+* \#961 Allow arbitrary `Mongo::Connection` options to pass through `Mongoid::Config::Database` object. (Morgan Nelson)
+
+* Enable `autosave` for many to many references. (Dave Krupinski)
+
+* The following explicit atomic operations have been added: `Model#bit`, `Model#pop`, `Model#pull`, `Model#push_all`, `Model#rename`, `Model#unset`.
+
+* Added exception translations for Hindi. (Sukeerthi Adiga)
+
+### Resolved Issues
+
+* \#974 Fix `attribute_present?` to work correctly then attribute value is `false`, thanks to @nickhoffman. (Gregory Man)
+
+* \#960 create indexes rake task is not recognizing a lot of mongoid models because it has problems guessing their model names from filenames. (Tobias Schlottke)
+
+* \#874 Deleting from a M-M reference is one-sided. (nickhoffman, davekrupinski)
+
+* Replace deprecated `class_inheritable_hash` dropped in Rails 3.1+. (Konstantin Shabanov)
+
+* Fix inconsistent state when replacing an entire many to many relation.
+
+* Don't clobber inheritable attributes when adding subclass field inheritance. (Dave Krupinski)
+
+* \#914 Querying embedded documents with `$or` selector. (Max Golovnia)
+
+* \#514 Fix marshaling of documents with relation extensions. (Chris Griego)
+
+* `Metadata#extension` now returns a `Module`, instead of a `Proc`, when an extension is defined.
+
+* \#837 When `allow_dynamic_fields` is set to `false` and loading an embedded document with an unrecognized field, an exception is raised.
+
+* \#963 Initializing array of embedded documents via hash regressed (Chris Griego, Morgan Nelson)
+
+* `Mongoid::Config.reset` resets the options to their default values.
+
+* `Mongoid::Fields.defaults` is memoized for faster instantiation of models.

data/{README.rdoc → README.md}

@@ -1,29 +1,39 @@
-= Overview
+Overview
+========
 
-== About Mongoid
+About Mongoid
+-------------
 
 Mongoid is an ODM (Object-Document-Mapper) framework for MongoDB in Ruby.
 
-== Project Tracking
+Project Tracking
+----------------
 
-* {Mongoid Google Group}[http://groups.google.com/group/mongoid]
-* {Mongoid Website and Documentation}[http://mongoid.org]
+* [Mongoid Google Group](http://groups.google.com/group/mongoid)
+* [Mongoid Website and Documentation](http://mongoid.org)
 
-== Compatibility
+Compatibility
+-------------
 
 Mongoid is tested against Ruby 1.8.7, 1.9.2, 1.9.3, REE, Rubinius, and JRuby.
 
-https://secure.travis-ci.org/mongoid/mongoid.png?branch=master&.png  {Build History}[http://travis-ci.org/mongoid/mongoid]
+<img src="https://secure.travis-ci.org/mongoid/mongoid.png?branch=master&.png"/>
 
-= Documentation
+[Build History](http://travis-ci.org/mongoid/mongoid)
+
+Documentation
+-------------
 
 Please see the new Mongoid website for up-to-date documentation:
-{mongoid.org}[http://mongoid.org]
+[mongoid.org](http://mongoid.org)
+
+Donating
+--------
 
-= Donating
-* {Support Mongoid at Pledgie}[http://www.pledgie.com/campaigns/7757]
+* [Support Mongoid at Pledgie](http://www.pledgie.com/campaigns/7757)
 
-= License
+License
+-------
 
 Copyright (c) 2009, 2010, 2011 Durran Jordan
 
@@ -38,7 +48,6 @@ 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
@@ -47,6 +56,7 @@ 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.
 
-= Credits
+Credits
+-------
 
 Durran Jordan: durran at gmail dot com

data/Rakefile

@@ -49,4 +49,4 @@ RDoc::Task.new do |rdoc|
   rdoc.rdoc_files.include("lib/**/*.rb")
 end
 
-task :default => :spec
+task :default => [ "spec:functional", "spec:unit" ]

data/lib/config/locales/bg.yml

@@ -4,8 +4,13 @@ bg:
       messages:
         taken:
           е вече заето
+        callbacks:
+          "Calling %{method} on %{klass} resulted in a false return from a callback."
         document_not_found:
           Не е намерен документ %{klass} с id(та) %{identifiers}.
+        eager_load:
+          "Eager loading :%{name} is not supported due to it being a many-to-many
+          or polymorphic belongs_to relation."
         invalid_database:
           Базата данни трябва да е от тип Mnogo:DB, а не  %{name}.
         invalid_type:

data/lib/config/locales/de.yml

@@ -4,8 +4,13 @@ de:
       messages:
         taken:
           ist bereits vergeben
+        callbacks:
+          "Calling %{method} on %{klass} resulted in a false return from a callback."
         document_not_found:
           Dokument für Klasse %{klass} mit ID(s) %{identifiers} nicht gefunden.
+        eager_load:
+          "Eager loading :%{name} is not supported due to it being a many-to-many
+          or polymorphic belongs_to relation."
         invalid_database:
           Datenbank sollte eine Mongo::DB sein, nicht %{name}.
         invalid_type:

data/lib/config/locales/en-GB.yml

@@ -4,8 +4,13 @@ en-GB:
       messages:
         taken:
           is already taken
+        callbacks:
+          "Calling %{method} on %{klass} resulted in a false return from a callback."
         document_not_found:
           Document not found for class %{klass} with id(s) %{identifiers}.
+        eager_load:
+          "Eager loading :%{name} is not supported due to it being a many-to-many
+          or polymorphic belongs_to relation."
         invalid_database:
           "Database should be a Mongo::DB, not %{name}."
         invalid_options:

data/lib/config/locales/en.yml

@@ -4,8 +4,13 @@ en:
       messages:
         taken:
           is already taken
+        callbacks:
+          "Calling %{method} on %{klass} resulted in a false return from a callback."
         document_not_found:
           Document not found for class %{klass} with id(s) %{identifiers}.
+        eager_load:
+          "Eager loading :%{name} is not supported due to it being a many-to-many
+          or polymorphic belongs_to relation."
         invalid_database:
           "Database should be a Mongo::DB, not %{name}."
         invalid_options:

data/lib/config/locales/es.yml

@@ -6,6 +6,9 @@ es:
           ya está en uso
         document_not_found:
           No se encontró ningún documento para la clase %{klass} con los id(s) %{identifiers}.
+        eager_load:
+          "Eager loading :%{name} is not supported due to it being a many-to-many
+          or polymorphic belongs_to relation."
         invalid_database:
           La base de datos debería ser una instancia de Mongo::DB, en lugar de %{name}.
         invalid_type:

data/lib/config/locales/fr.yml

@@ -4,8 +4,13 @@ fr:
       messages:
         taken:
           est déjà pris.
+        callbacks:
+          "Calling %{method} on %{klass} resulted in a false return from a callback."
         document_not_found:
           Document introuvable pour la classe %{klass} avec les ids %{identifiers}.
+        eager_load:
+          "Eager loading :%{name} is not supported due to it being a many-to-many
+          or polymorphic belongs_to relation."
         invalid_database:
           La base de données doit être une Mongo::DB, pas %{name}.
         invalid_type:

data/lib/config/locales/hi.yml

@@ -4,8 +4,13 @@ en:
       messages:
         taken:
           "पहले ही ले लिया है"
+        callbacks:
+          "Calling %{method} on %{klass} resulted in a false return from a callback."
         document_not_found:
           "%{identifiers}  id(s) के साथ, वर्ग %{klass} के लिए दस्तावेज़ नहीं मिला."
+        eager_load:
+          "Eager loading :%{name} is not supported due to it being a many-to-many
+          or polymorphic belongs_to relation."
         invalid_database:
           "डेटाबेस Mongo::DB होना चाहिए, %{name} नहीं."
         invalid_options: