mongoid 3.1.6 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d24616c46c93a31777a37b97c93cca0b10df2625
-  data.tar.gz: 000fc93a80cfc7e296f305a1ddca2d77517578aa
+  metadata.gz: f25ce5318d49b1e171f4e6fa2d4067eb933ecf0d
+  data.tar.gz: 94846f4aff6c2ba1ccf34a63789b7503e536611b
 SHA512:
-  metadata.gz: 71d177604ae5df43f63a5f45b1fa68ea2bedf263009ca58406e23ef6c3fdbe09f0b76bdf5e4c70a9612c515f3aa2fca8ae384d62ede1e86629f788905822e483
-  data.tar.gz: f840e9a8796efaa27b3536c95270c9e5abcbe233718a546095cc09671fd1d6edb8c7d16b55505ad33e1737ab610fb422b04318d0486c37841a2b9c495959ca2f
+  metadata.gz: 96e54337599c2679fcb56acc7c817b1d119730f40d58eda3b0c8d2d4d66867c5c92ff6c475ce770ac52230fe8666ee29a1ecc81be1e8801a13359708bef76caf
+  data.tar.gz: 693af581fa3e7c64cf8014a9ca3a4eb1c90baddfcb26c5162d1bd842da149092ad8c1d7ec34d5d4c45f9b58c739431e8f0a3a7794346798cb1cb469e08aa16d5

data/CHANGELOG.md

@@ -3,6 +3,432 @@
 For instructions on upgrading to newer versions, visit
 [mongoid.org](http://mongoid.org/en/mongoid/docs/upgrading.html).
 
+## 4.0.0
+
+### Major Changes (Backwards Incompatible)
+
+* \#3320 Remove Rails dependencies on database rake tasks. (Arthur Neves)
+
+    All db:* rake tasks should work as before when using Rails.
+    When not in a Rails, just load the database tasks using:
+
+        load 'mongoid/tasks/database.rake'
+
+* Mongoid 4 now only supports MongoDB 2.4.0 and higher.
+
+* `Document#metadata` has been renamed to `Document#relation_metadata` to
+  avoid common conflicts. Relation proxies also have this renamed to the
+  same as well.
+
+* Scopes and default scopes must now all be defined within lambdas or procs.
+
+* `skip_version_check` config option was removed.
+
+* IdentityMap removed. (Arthur Neves)
+
+* Eager load rework. Eager load now doesnt need the identity map to load
+  related documents. A set of preloaders can eager load the associations
+  passed to .includes method. (Arthur Neves)
+
+* Mongoid now supports the new read preferences that the core drivers
+  provide. These include:
+
+    - `:primary`: Will always read from a primary node. (default)
+    - `:primary_preferred`: Attempt a primary first, then secondary if none available.
+    - `:secondary`: Will always read from a secondary node.
+    - `:secondary_preferred`: Attempt a secondary first, then primary if none available.
+    - `:nearest`: Attempt to read from the node with the lowest latency.
+
+    Sample syntax:
+
+        Person.with(read: :secondary).first
+
+    The `:consistency` option is no longer valid, use the `:read` option now.
+
+* Mongoid now defaults all writes to propagate (formerly "safe mode") and now
+  has different propagate semantics:
+
+    - `{ w: -1 }`: Don't verify writes and raise no network errors.
+    - `{ w: 0 }`: Don't verify writes and raise network errors.
+    - `{ w: 1 }`: Verify writes on the primary node. (default)
+    - `{ w: n }`: Verify writes on n number of nodes.
+    - `{ w: "majority" }`: Verify writes on a majority of nodes.
+
+    Sample syntax:
+
+        Person.with(write: {w: :majority}).create!(name: "John")
+
+    The `:safe` option is no longer valid use the `:write` option now.
+
+* \#3230 Array and Hash fields now validate that the correct types are
+  getting set, instead of allowing any value. (Rodrigo Saito)
+
+* \#3043/\#2949 Rework on the internals of persistence options. (Arthur Neves)
+
+* Mongoid now requires Active Model 4 or higher.
+
+* `Document#set` now accepts multiple attributes in the form of a hash,
+  instead of the previous `(field, value)` args. Field aliases and typecasting
+  are also now supported in this operation.
+
+        document.set(name: "Photek", likes: 10000)
+
+* `Document#rename` now accepts multiple attributes in the form of a hash,
+  instead of the previous `(field, value)` args. Field aliases are supported.
+
+        document.rename(first_name: "fn", last_name: "ln")
+
+* `Document#inc` now accepts multiple attributes in the form of a hash, instead
+  of previously only being able to increment one value at a time. Aliases and
+  serialization is supported.
+
+        document.inc(score: 10, place: -1, lives: -10)
+
+* `Document#pop` now accepts multiple attributes in the form of a hash, instead
+  of previously only being able to pop one value at a time. Aliases and
+  serialization is supported.
+
+        document.pop(names: 1, aliases: -1)
+
+* `Document#bit` now accepts multiple attributes in the form of a hash, instead
+  of previously only being able to apply one set of operations at a time.
+  Aliases and serialization are supported.
+
+        document.bit(age: { and: 13 }, score: { or: 13 })
+
+* `Document#pull` now accepts multiple attributes in the form of a hash, instead
+  of previously only being able to pull one value at a time. Aliases and
+  serialization is supported.
+
+        document.pull(names: "James", aliases: "007")
+
+* `Document#pull_all` now accepts multiple attributes in the form of a hash,
+  instead of previously only being able to pull one value at a time. Aliases and
+  serialization is supported.
+
+        document.pull_all(names: ["James", "Bond"], aliases: ["007"])
+
+* `Document#push_all` has been removed since it was deprecated in MongoDB 2.4.
+  Use `Document.push` instead.
+
+* `Document#push` now accepts multiple attributes in the form of a hash, and
+  can handle the pushing of single values or multiple values to the field via
+  $push with $each. Aliases and serialization is supported.
+
+        document.push(names: "James", aliases: [ "007", "Jim" ])
+
+* `Document#add_to_set` now accepts multiple attributes in the form of a hash,
+  and now aliases and serialization are supported.
+
+        document.add_to_set(names: "James", aliases: "007")
+
+* Criteria atomic operations API is now changed to match the changes in the
+  single document atomic API, for example:
+
+        Band.where(name: "Depeche Mode").inc(likes: 10, followers: 20)
+
+* \#3399 #create and #create! on relations can now take an array of attributes as
+  the first parameter to create multiple documents at once.
+
+        person.addresses.create([{ street: "Bond" }, { street: "Upper" }])
+        person.addresses.create!([{ street: "Bond" }, { street: "Upper" }])
+
+* \#3141 `rake db:test:prepare` now sets up all defined indexes if Mongoid is the
+  only ODM/ORM in the environment.
+
+* \#3138 `update_attributes` can now be accessed simply by calling `update`.
+
+* \#3083 A new rake task: `rake mongoid:remove_undefined_indexes` has been added to
+  remove indexes from the database that are not explicitly defined in the models.
+  (Aidan Feldman)
+
+* \#3029 The `relation_field` field that is added for a single use case with polymorphic
+  relations has been removed. So where the following would work before:
+
+        class Eye
+          include Mongoid::Document
+          belongs_to :eyeable, polymorphic: true
+        end
+
+        class Face
+          include Mongoid::Document
+          has_one :left_eye, class_name: "Eye", as: :eyeable
+          has_one :right_eye, class_name: "Eye", as: :eyeable
+        end
+
+      This would now need to be modeled as (with the appropriate migration):
+
+        class Eye
+          include Mongoid::Document
+          belongs_to :left_socket, class_name: "Face", inverse_of: :left_eye
+          belongs_to :right_socket, class_name: "Face", inverse_of: :right_eye
+        end
+
+        class Face
+          include Mongoid::Document
+          has_one :left_eye, class_name: "Eye", inverse_of: :left_socket
+          has_one :right_eye, class_name: "Eye", inverse_of: :right_socket
+        end
+
+* \#3075 `update_attribute` now properly calls the setter method instead of
+  using `write_attribute`.
+
+* \#3060 Allow atomically blocks to allow multiple calls of the same type.
+  (Brian Norton)
+
+* \#3037 Model indexes are no longer stored in an `index_options` hash on the
+  model class. Instead, an array named `index_specifications` now exists on the
+  class which contains a list of `Indexable::Specification` objects. This is so
+  we could properly handle the case of indexes with the same keys but different
+  order.
+
+* \#2956 Caching on queries now only happens when `cache` is specifically
+  called. (Arthur Neves)
+
+* \#2659 `Mongoid::Railtie` now properly uses only one initializer and
+  the name has changed to `mongoid.load-config`.
+
+* \#2656 `rake db:reseed` is now `rake db:reset` (Arthur Neves)
+
+* \#2648 `Boolean` becomes `Mongoid::Boolean` to avoid polluting the global
+  namespace with a commonly used class by other libraries.
+
+* \#2603 Return values from setters are now always the set value, regardless
+  of calling the setter or using send.
+
+* \#2597 `Mongoid::Observer` was removed in line with Rails 4.
+
+* \#2563 The `allow_dynamic_fields` configuration option has been removed as
+  dynamic fields are now allowed on a per-model level. In order to allow a
+  model to use dynamic fields, simply include the module in each.
+  (Josh Martin)
+
+        class Band
+          include Mongoid::Document
+          include Mongoid::Attributes::Dynamic
+        end
+
+* \#2497 Calling `to_json` no longer tampers with the return value from the
+  driver, and proper returns `{ "$oid" : object_id.to_s }` instead of just
+  the string representation previously.
+
+* \#2433 `Mongoid::Paranoia` has been removed.
+
+* \#2432 `Mongoid::Versioning` has been removed.
+
+* \#2218 Creating or instantiating documents that have default scopes will now
+  apply the default scope to the document, if the scope is not complex.
+
+* \#2200 Mass assignment security now mirrors Rails 4's behavior.
+  `without_protection` option was also removed.
+  `attr_accessible` class method was removed.
+  Mongoid and Strong parameters should work fine for mass assignment protection.
+
+* `delete_all` and `destroy_all` no longer take a `:conditions` hash but
+  just the raw attributes.
+
+* \#1908 Documents now loaded from criteria using `#only` or `#without` will now
+  raise an error when attempting to save, update, or delete these records.
+  Additionally fields excluded from the fields retrieved from the database will
+  also raise an exception when trying to access them.
+
+* \#1344 Atomic updates can now be executed in an `atomically` block, which will
+  delay any atomic updates on the document the block was called on until the
+  block is complete.
+
+    Update calls can be executed as normal in the block:
+
+        document.atomically do
+          document.inc(likes: 10)
+          document.bit(members: { and: 10 })
+          document.set(name: "Photek")
+        end
+
+    The document is also yielded to the block:
+
+        document.atomically do |doc|
+          doc.inc(likes: 10)
+          doc.bit(members: { and: 10 })
+          doc.set(name: "Photek")
+        end
+
+    The atomic commands are have a fluid interface:
+
+        document.atomically do |doc|
+          doc.inc(likes: 10).bit(members: { and: 10 }).set(name: "Photek")
+        end
+
+    If the fluid interface is leveraged without the `atomically` block, the
+    operations will persist in individual calls. For example, the following
+    would hit the database 3 times without the block provided:
+
+        doc.inc(likes: 10).bit(members: { and: 10 }).set(name: "Photek")
+
+    The block is only good for 1 document at a time, so embedded and root
+    document updates cannot be mixed at this time.
+
+### New Features
+
+* Mongoid now uses ActiveSupport::LogSubscriber to subscribe logs, and
+  ActiveSupport::Notifications to send operation logs. (Arthur Neves)
+  Example of log subscription:
+
+    ActiveSupport::Notifications.subscribe('query.moped') do |event|
+      ..
+    end
+
+* Field types can now use symbols as well as class names. See:
+  https://github.com/mongoid/mongoid/blob/master/lib/mongoid/fields.rb#L16
+  for the available mappings.
+
+* \#3580 Fields can now be reset to their default values, with the methods:
+
+    document.reset_name_to_default!
+
+* \#3513 Documents now have a `#destroy!` method that will raise a
+  `Mongoid::Errors::DocumentNotDestroyed` error if a destroy callback returns
+  a false value.
+
+* \#3496 Added class level and criteria level `find_or_create_by!`.
+
+* \#3479 Map/reduce now respects criteria no timeout options if output is not
+  inline.
+
+* \#3478 Criteria objects now have a #none method that will cause the criteria to
+  never hit the database and always have zero documents.
+
+    Band.none
+    Band.none.where(name: "Tool") # Always has zero documents.
+
+* \#3410 Mongoid now has a query cache that can be used as a middleware in
+  Rack applications. (Arthur Neves)
+
+    For Rails:
+
+      config.middleware.use(Mongoid::QueryCache::Middleware)
+
+* \#3319 Counters can now be reset from a document instance:
+
+    document.reset_counters(:relation)
+
+* \#3310 embedded_in relations now accept a `touch` option to update parents.
+
+* \#3302 Aliasing using `alias_attribute` now properly handles aliases in criteria.
+
+* \#3155 Range field will persist the exclude_end when provided.
+  (Daniel Libanori)
+
+* \#3146 Adding :overwrite field option, when it`s true, it wont check duplicates.
+ (Daniel Libanori)
+
+* \#3002 Reloading the Rails console will also now clear Mongoid's identity map.
+
+* \#2938 A configuration option `duplicate_fields_exception` has been added that
+  when set to `true` will raise an exception when defining a field that will
+  override an existing method. (Arthur Neves)
+
+* \#2924 MongoDB 2.4 beta text search now has a DSL provided by Mongoid. Like
+  other queries, text searches are lazy evaluated, and available off the class
+  or criteria level.
+
+    Note that any 3rd party gem that provides a `text_search` method will now no
+    longer work with Mongoid, and will need to change its syntax. Examples:
+
+        Band.text_search("mode").project(name: 1).each do |doc|
+          # ...
+        end
+
+        Band.limit(10).text_search("phase").language("latin")
+        Band.where(:likes.gt => 1000).text_search("lucy")
+
+* \#2855 Multiple extensions can now be supplied to relations. (Daniel Libanori)
+
+### Resolved Issues
+
+* \#3676 Make pluck work with embedded associations
+  (Arthur Neves)
+
+* \#2898 Dirty attribute methods now properly handle field aliases.
+  (Niels Ganser)
+
+* \#3620 Add ActiveModel module instance methods to prohibited_methods list.
+  (Arthur Neves)
+
+* \#3610 Don't allow atomic operations on read-only attributes
+  (Frederico Araujo)
+
+* \#3619 Don't validate documents that are flagged for destruction.
+  (Christopher J. Bottaro)
+
+* \#3617 Don't skip index creation on cyclic documents. (shaiker)
+
+* \#3568 Fixed missing attributes error on present localized fields.
+
+* \#3514 Fixed query cache to work on first/last calls.
+
+* \#3383/\#3495 Fix has_and_belongs_to_many eager load. (Arthur Neves)
+
+* \#3492 $rename operations should not mongoize values. (Vladislav Melanitskiy)
+
+* \#3490 Allow localized fields to work with boolean `false` values.
+
+* \#3487 Map Boolean to Mongoid::Boolean in field definitions. (Arthur Neves)
+
+* \#3449 Touch needs to work for create and update. (Greggory Rothmeier)
+
+* \#3347 Creating documents off of scopes for embedded relations now properly
+  sets the parent document on the created children.
+
+* \#3432 Fixed mongoization of DateTime losing precision.
+
+* \#3397 Fixed $ne matcher for embedded documents to match server behaviour.
+
+* \#3352 Allow named scopes named "open" to work through 1-n relations.
+
+* \#3348 Fixing compounded indexes having the same keys with
+  different directions. (Arthur Neves)
+
+* \#2701 Fixing extra query on belongs_to binding. (Arthur Neves)
+
+* \#3089 Allow demongoization of strings to floats (Daniel Libanori)
+
+* \#3278 Counter cache should update the document in memory too. (Arthur Neves)
+
+* \#3242 Has_many relation must use the inverse foreign_key. (Arthur Neves)
+
+* \#3233 Don't double call validation callbacks when cascading children and
+  relation validation is turned on.
+
+* \#3197 Improvements in the calls to `aggregates` on root and embedded
+  collections. (Wojciech Piekutowski)
+
+* \#3144/\#3219 Fixing name colission on @_children ivar. (Arthur Neves)
+
+* \#3088 Range field can accept a hash, which could be the attribute from the db.
+  (Daniel Libanori)
+
+* \#3116 Relations instance variables are now all prefixed with `_`.
+
+* \#3093 Only flatten 1 level when atomically pushing arrays.
+
+* \#3063 `Document#becomes` now properly sets base object on errors.
+  (Adam Ross Cohen)
+
+* \#3019 Atomic operations will no longer attempt to persist if the document
+  is not persisted.
+
+* \#2903 Removed unused string `to_a` extension.
+
+## 3.1.7
+
+### Resolved Issues
+
+* \#3465 Fixed ambigous relation errors where inverse_of is set to nil.
+
+* \#3414 Backkport skip and limit options on aggregation. (Wojciech Piekutowski)
+
+* \#3469 Fix RegexpError: failed to allocate memory: /\./ on .hash_dot_syntax?  (Dmitry Krasnoukhov)
+
 ## 3.1.6
 
 ### Resolved Issues
@@ -91,6 +517,7 @@ For instructions on upgrading to newer versions, visit
 ### Resolved Issues
 
 * Dont duplicate embedded documents when saving after calling becomes method.
+  (Arthur Neves)
 
 * \#2961 Reloading a mongoid.yml configuration now properly clears previously
   configured sessions.
@@ -101,11 +528,6 @@ For instructions on upgrading to newer versions, visit
 * \#2921 Don't use type in identity map selection if inheritance is not
   in play. (Arthur Neves)
 
-* \#2899 Dirty attribute methods now properly handle field aliases.
-  (Niels Ganser)
-
-* \#2895 Allow scopes that return nil to still be chainable. (niedhui)
-
 * \#2893 Removed memoization of collection name and database name so lambdas
   with `store_in` work properly when changing.
 
@@ -283,12 +705,14 @@ For instructions on upgrading to newer versions, visit
 * \#2465 Documents now have an `attribute_before_type_cast` for proper
   handling of validations. (Gerad Suyderhoud)
 
-* \#2443 `expire_after_seconds` is now a valid index option.
+* \#2443 `expire_after_seconds` is now a valid index option
+  (http://docs.mongodb.org/manual/core/indexes/#ttl-indexes,
+   http://docs.mongodb.org/manual/tutorial/expire-data/).
 
         class Event
           include Mongoid::Document
-          field :status, type: Integer
-          index({ status: 1 }, { expire_after_seconds: 3600 })
+          field :created_at, type: DateTime
+          index({ created_at: 1 }, { expire_after_seconds: 3600 })
         end
 
 * \#2373 Relations with the `touch: true` option will now be automatically

data/README.md

@@ -1,4 +1,4 @@
-Mongoid [![Build Status](https://secure.travis-ci.org/mongoid/mongoid.png?branch=master&.png)](http://travis-ci.org/mongoid/mongoid)
+Mongoid [![Build Status](https://travis-ci.org/mongoid/mongoid.svg)](https://travis-ci.org/mongoid/mongoid) [![Code Climate](https://codeclimate.com/github/mongoid/mongoid.png)](https://codeclimate.com/github/mongoid/mongoid) [![Coverage Status](https://coveralls.io/repos/mongoid/mongoid/badge.png?branch=master)](https://coveralls.io/r/mongoid/mongoid?branch=master) [![Gem Version](https://badge.fury.io/rb/mongoid.png)](http://badge.fury.io/rb/mongoid) [![Dependency Status](https://www.versioneye.com/ruby/mongoid/3.1.6/badge.png)](https://www.versioneye.com/ruby/mongoid/3.1.6)
 ========
 
 Mongoid is an ODM (Object-Document-Mapper) framework for MongoDB in Ruby.
@@ -6,14 +6,15 @@ Mongoid is an ODM (Object-Document-Mapper) framework for MongoDB in Ruby.
 Project Tracking
 ----------------
 
-* [Mongoid Google Group](http://groups.google.com/group/mongoid)
 * [Mongoid Website and Documentation](http://mongoid.org)
-* [Mongoid Code Climate](https://codeclimate.com/github/mongoid/mongoid)
+* [Mongoid Google Group](http://groups.google.com/group/mongoid)
+* [Stackoverflow](http://stackoverflow.com/questions/tagged/mongoid)
+* [#mongoid](http://webchat.freenode.net/?channels=mongoid) on freenode IRC
 
 Compatibility
 -------------
 
-Mongoid is tested against MRI 1.9.3, 2.0.0, and JRuby (1.9).
+Mongoid is tested against MRI 1.9.3, 2.0.0, 2.1.0 and JRuby (1.9).
 
 Documentation
 -------------
@@ -24,8 +25,6 @@ Please see the new Mongoid website for up-to-date documentation:
 Donating
 --------
 
-[Support Mongoid at Wepay](https://www.wepay.com/donations/mongoid)
-
 [Support Mongoid at Pledgie](http://www.pledgie.com/campaigns/7757)
 
 <a href='http://www.pledgie.com/campaigns/7757'>

data/lib/config/locales/en.yml

@@ -31,6 +31,13 @@ en:
           resolution: "Most likely this is caused by passing parameters directly
             through to the find, and the parameter either is not present or the
             key from which it is accessed is incorrect."
+        document_not_destroyed:
+          message: "%{klass} with id %{id} was not destroyed."
+          summary: "When calling %{klass}#destroy! and a callback halts the destroy
+            callback chain by returning a false value, the deletion will not
+            actually occur."
+          resolution: "Check the before/after destroy callbacks to ensure that the
+            return values are truthy for the chain to continue."
         document_not_found:
           message: "Document(s) not found for class %{klass} with id(s) %{missing}."
           summary: "When calling %{klass}.find with an id or array of ids, each
@@ -119,6 +126,7 @@ en:
             has the correct options.\n\n
             Valid options are:\n
             \_\_background: true|false\n
+            \_\_database: 'database_name'\n
             \_\_drop_dups: true|false\n
             \_\_name: 'index_name'\n
             \_\_sparse: true|false\n
@@ -128,6 +136,7 @@ en:
             \_\_bits: 26\n
             \_\_bucket_size : 1\n
             \_\_weights: { content: 1, title: 2 }\n
+            \_\_expire_after_seconds: number_of_seconds\n
             Valid types are: 1, -1, '2d', '2dsphere', 'geoHaystack', 'text', 'hashed'\n\n
             Example:\n
             \_\_class Band\n
@@ -156,15 +165,11 @@ en:
         invalid_scope:
           message: "Defining a scope of value %{value} on %{klass} is not
             allowed."
-          summary: "Scopes in Mongoid must be either criteria objects or procs
-            that wrap criteria objects."
-          resolution: "Change the scope to be a criteria or proc wrapped
-            critera.\n\n
+          summary: "Scopes in Mongoid must be procs that wrap criteria objects."
+          resolution: "Change the scope to be a proc wrapped critera.\n\n
             Example:\n
             \_\_class Band\n
             \_\_\_\_include Mongoid::Document\n
-            \_\_\_\_field :active, type: Boolean, default: true\n
-            \_\_\_\_scope :active, where(active: true)\n
             \_\_\_\_scope :inactive, ->{ where(active: false) }\n
             \_\_end\n\n"
         invalid_storage_options:
@@ -179,6 +184,12 @@ en:
             \_\_\_\_include Mongoid::Document\n
             \_\_\_\_store_in collection: 'artists', database: 'secondary'\n
             \_\_end\n\n"
+        invalid_storage_parent:
+          message: "Invalid store_in call on class %{klass}."
+          summary: "The :store_in macro can only be called on a base Mongoid Document"
+          resolution: "Remove the store_in call on class %{klass}, as it will use its
+            parent store configuration. Or remove the hierarchy extension for this
+            class."
         invalid_time:
           message: "'%{value}' is not a valid Time."
           summary: "Mongoid tries to serialize the values for Date, DateTime, and
@@ -222,6 +233,10 @@ en:
             from the child side which relation to go in."
           resolution: "Set the values from the parent, or redefine the relation
             with only a single definition in the parent."
+        invalid_value:
+          message: "Value of type %{value_class} cannot be written to a field of type %{field_class}"
+          summary: "Tried to set a value of type %{value_class} to a field of type %{field_class}"
+          resolution: "Verify if the value to be set correspond to field definition"
         mixed_relations:
           message: "Referencing a(n) %{embedded} document from the %{root}
             document via a relational association is not allowed since the
@@ -387,6 +402,12 @@ en:
             can only have values set when the document is a new record."
           resolution: "Don't define '%{name}' as readonly, or do not attempt
             to update its value after the document is persisted."
+        readonly_document:
+          message: "Attempted to persist the readonly document '%{klass}'."
+          summary: "Documents loaded from the database using #only
+            cannot be persisted."
+          resolution: "Don't attempt to persist documents that are flagged as
+            readonly."
         scope_overwrite:
           message: "Cannot create scope :%{scope_name}, because of existing
             method %{model_name}.%{scope_name}."
@@ -411,12 +432,12 @@ en:
         unknown_attribute:
           message: "Attempted to set a value for '%{name}' which is not
             allowed on the model %{klass}."
-          summary: "When setting Mongoid.allow_dynamic_fields to false and the
-            attribute does not already exist in the attributes hash, attempting
-            to call %{klass}#%{name}= for it is not allowed. This is also
-            triggered by passing the attribute to any method that accepts an
+          summary: "Without including Mongoid::Attributes::Dynamic in your model
+            and the attribute does not already exist in the attributes hash,
+            attempting to call %{klass}#%{name}= for it is not allowed. This is
+            also triggered by passing the attribute to any method that accepts an
             attributes hash, and is raised instead of getting a NoMethodError."
-          resolution: "You can set Mongoid.allow_dynamic_fields to true if you
+          resolution: "You can include Mongoid::Attributes::Dynamic if you
             expect to be writing values for undefined fields often."
         unsaved_document:
           message: "Attempted to save %{document} before the parent %{base}."
@@ -439,13 +460,6 @@ en:
           summary: "The following errors were found: %{errors}"
           resolution: "Try persisting the document with valid data or remove
             the validations."
-        versioning_not_on_root:
-          message: "Versioning not allowed on embedded document: %{klass}."
-          summary: "Mongoid::Versioning behaviour is only allowed on documents
-            that are the root document in the hierarchy."
-          resolution: "Remove the versioning from the embedded %{klass} or
-            consider moving it to a root location in the hierarchy if
-            versioning is needed."
         delete_restriction:
           message: "Cannot delete %{document} because of dependent '%{relation}'."
           summary: "When defining '%{relation}' with a :dependent => :restrict,

data/lib/mongoid/atomic/paths/embedded/many.rb

@@ -35,7 +35,7 @@ module Mongoid
           def position
             pos = parent.atomic_position
             locator = document.new_record? ? "" : ".#{document._index}"
-            "#{pos}#{"." unless pos.blank?}#{document.metadata.store_as}#{locator}"
+            "#{pos}#{"." unless pos.blank?}#{document.__metadata.store_as}#{locator}"
           end
         end
       end

data/lib/mongoid/atomic/paths/embedded/one.rb

@@ -34,7 +34,7 @@ module Mongoid
           # @since 2.1.0
           def position
             pos = parent.atomic_position
-            "#{pos}#{"." unless pos.blank?}#{document.metadata.store_as}"
+            "#{pos}#{"." unless pos.blank?}#{document.__metadata.store_as}"
           end
         end
       end

data/lib/mongoid/atomic/paths/embedded.rb

@@ -22,36 +22,6 @@ module Mongoid
         def path
           @path ||= position.sub(/\.\d+$/, "")
         end
-
-        # Get the selector to use for the root document when performing atomic
-        # updates. When sharding this will include the shard key.
-        #
-        # @example Get the selector.
-        #   many.selector
-        #
-        # @return [ Hash ] The selector to identify the document with.
-        #
-        # @since 2.1.0
-        def selector
-          @selector ||= generate_selector
-        end
-
-        private
-
-        def generate_selector
-          if only_root_selector?
-            parent.atomic_selector
-          else
-            parent.
-              atomic_selector.
-              merge("#{path}._id" => document._id).
-              merge(document.shard_key_selector)
-          end
-        end
-
-        def only_root_selector?
-          document.persisted? && document._id_changed?
-        end
       end
     end
   end