mongoid 2.8.1 → 3.0.0.rc

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Durran Jordan
+Copyright (c) 2009-2012 Durran Jordan
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,9 +1,6 @@
-Overview
+Mongoid [![Build Status](https://secure.travis-ci.org/mongoid/mongoid.png?branch=master&.png)](http://travis-ci.org/mongoid/mongoid)
 ========
 
-About Mongoid
--------------
-
 Mongoid is an ODM (Object-Document-Mapper) framework for MongoDB in Ruby.
 
 Project Tracking
@@ -15,11 +12,7 @@ Project Tracking
 Compatibility
 -------------
 
-Mongoid is tested against Ruby 1.8.7, 1.9.2, 1.9.3, REE, Rubinius, and JRuby.
-
-<img src="https://secure.travis-ci.org/mongoid/mongoid.png?branch=master&.png"/>
-
-[Build History](http://travis-ci.org/mongoid/mongoid)
+Mongoid is tested against MRI 1.9.2, 1.9.3, 2.0.0, and JRuby (1.9).
 
 Documentation
 -------------
@@ -30,12 +23,18 @@ Please see the new Mongoid website for up-to-date documentation:
 Donating
 --------
 
-* [Support Mongoid at Pledgie](http://www.pledgie.com/campaigns/7757)
+[Support Mongoid at Pledgie](http://www.pledgie.com/campaigns/7757)
+
+<a href='http://www.pledgie.com/campaigns/7757'>
+<img alt='Click here to lend your support to: Mongoid and make a donation at www.pledgie.com !' src='http://www.pledgie.com/campaigns/7757.png?skin_name=chrome' border='0'/>
+</a>
+
+[![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=durran&url=http://github.com/mongoid&title=mongoid&language=&tags=github&category=software)
 
 License
 -------
 
-Copyright (c) 2009, 2010, 2011 Durran Jordan
+Copyright (c) 2009-2012 Durran Jordan
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/Rakefile

@@ -2,7 +2,6 @@ require "bundler"
 Bundler.setup
 
 require "rake"
-require "rspec"
 require "rspec/core/rake_task"
 
 $LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
@@ -23,12 +22,8 @@ task :release => :build do
   system "gem push mongoid-#{Mongoid::VERSION}.gem"
 end
 
-RSpec::Core::RakeTask.new("spec:unit") do |spec|
-  spec.pattern = "spec/unit/**/*_spec.rb"
-end
-
-RSpec::Core::RakeTask.new("spec:functional") do |spec|
-  spec.pattern = "spec/functional/**/*_spec.rb"
+RSpec::Core::RakeTask.new("spec") do |spec|
+  spec.pattern = "spec/**/*_spec.rb"
 end
 
 RSpec::Core::RakeTask.new('spec:progress') do |spec|
@@ -36,5 +31,4 @@ RSpec::Core::RakeTask.new('spec:progress') do |spec|
   spec.pattern = "spec/**/*_spec.rb"
 end
 
-task :spec => [ "spec:functional", "spec:unit" ]
 task :default => :spec

data/lib/config/locales/en.yml

@@ -1,64 +1,454 @@
 en:
   mongoid:
+    inspection:
+      criteria: "#<Mongoid::Criteria\n
+        \_\_selector: %{selector},\n
+        \_\_options:  %{options},\n
+        \_\_class:    %{klass},\n
+        \_\_embedded: %{embedded}>\n"
+      metadata: "#<Mongoid::Relations::Metadata\n
+        \_\_autobuild:    %{autobuild},\n
+        \_\_class_name:   %{class_name},\n
+        \_\_cyclic:       %{cyclic},\n
+        \_\_dependent:    %{dependent},\n
+        \_\_inverse_of:   %{inverse_of},\n
+        \_\_key:          %{key},\n
+        \_\_macro:        %{macro},\n
+        \_\_name:         %{name},\n
+        \_\_order:        %{order},\n
+        \_\_polymorphic:  %{polymorphic},\n
+        \_\_relation:     %{relation},\n
+        \_\_setter:       %{setter},\n
+        \_\_versioned:    %{versioned}>\n"
     errors:
       messages:
         blank:
-          can't be blank
-        taken:
-          is already taken
+          "can't be blank"
+        blank_in_locale:
+          "can't be blank in %{location}"
+        ambiguous_relationship:
+          message: "Ambiguous relations %{candidates} defined on %{klass}."
+          summary:
+            "When Mongoid attempts to set an inverse document of a relation
+            in memory, it needs to know which relation it belongs to. When
+            setting %{name}, Mongoid looked on the class %{inverse}
+            for a matching relation, but multiples were found that could
+            potentially match: %{candidates}."
+          resolution: "On the %{name} relation on %{inverse} you must add an
+            :inverse_of option to specify the exact relationship on %{klass}
+            that is the opposite of %{name}."
         callbacks:
-          "Calling %{method} on %{klass} resulted in a false return from a callback."
+          message: "Calling %{method} on %{klass} resulted in a false return
+            from a callback."
+          summary: "If a before callback returns false when using Document.create!,
+            Document#save!, or Documnet#update_attributes! this error will get raised
+            since the document did not actually get saved."
+          resolution: "Double check all before callbacks to make sure they are
+            not unintentionally returning false."
+        calling_document_find_with_nil_is_invalid:
+          message: "Calling Document.find with nil is invalid."
+          summary: "Document.find expects the parameters to be 1 or more ids, and
+            will return a single document if 1 id is provided, otherwise an array
+            of documents if multiple ids are provided."
+          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_found:
-          Document not found for class %{klass} with id(s) %{identifiers}.
+          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
+            parameter must match a document in the database or this error will be
+            raised. The search was for the id(s): %{searched} (%{total} total)
+            and the following ids were not found: %{missing}."
+          resolution: "Search for an id that is in the database or set
+            the Mongoid.raise_not_found_error configuration option to false,
+            which will cause a nil to be returned instead of raising this error when
+            searching for a single id, or only the matched documents when searching
+            for multiples."
+        document_with_attributes_not_found:
+          message: "Document not found for class %{klass} with attributes %{attributes}."
+          summary: "When calling %{klass}.find_by with a hash of attributes, all
+            attributes provided must match a document in the database of this error
+            will be raised."
+          resolution: "Search for attributes that are in the database or set
+            the Mongoid.raise_not_found_error configuration option to false,
+            which will cause a nil to be returned instead of raising this error."
         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_time:
-          "'%{value}' is not a valid Time."
-        invalid_options:
-          "Invalid option :%{invalid} provided to relation :%{name}. Valid options
-          are: %{valid}."
-        invalid_type:
-          Field was defined as a(n) %{klass}, but received a %{other} with
-          the value %{value}.
-        unsupported_version:
-          MongoDB %{version} not supported, please upgrade
-          to %{mongo_version}.
-        validations:
-          Validation failed - %{errors}.
+          message: "Eager loading :%{name} is not supported since it is a
+            polymorphic belongs_to relation."
+          summary: "Mongoid cannot currently determine the classes it needs to
+            eager load when the relation is polymorphic. The parents reside in
+            different collections so a simple id lookup is not sufficient enough."
+          resolution: "Don't attempt to perform this action and have patience,
+            maybe this will be supported in the future."
         invalid_collection:
-          Access to the collection for %{klass} is not allowed since it
-          is an embedded document, please access a collection from
-          the root document.
+          message: "Access to the collection for %{klass} is not allowed."
+          summary: "%{klass}.collection was called, and %{klass} is an embedded
+            document - it resides within the collection of the root document of
+            the hierarchy."
+          resolution: "For access to the collection that the embedded document is
+            in, use %{klass}#_root.collection, or do not attempt to persist an
+            embedded document without a parent set."
+        invalid_config_option:
+          message: "Invalid configuration option: %{name}."
+          summary: "A invalid configuration option was provided in your
+            mongoid.yml, or a typo is potentially present. The valid configuration
+            options are: %{options}."
+          resolution: "Remove the invalid option or fix the typo. If you were
+            expecting the option to be there, please consult the following page
+            with repect to Mongoid's configuration:\n\n
+            \_\_http://mongoid.org/docs/installation.html"
+        invalid_database:
+          message: "Database should be a Mongo::DB, not %{name}."
+          summary: "When setting a master database in the Mongoid configuration
+            it must be an actual instance of a Mongo::DB, and not just a name
+            of the database. This check is performed when calling
+            Mongoid.master = object."
+          resolution: "Make sure that when setting the configuration
+            programatically that you are passing an actual db instance."
         invalid_field:
-          Defining a field named %{name} is not allowed. Do not define
-          fields that conflict with Mongoid internal attributes or method
-          names. Use Mongoid.destructive_fields to see what names this includes.
-        too_many_nested_attribute_records:
-          Accepting nested attributes for %{association} is limited
-          to %{limit} records.
-        embedded_in_must_have_inverse_of:
-          Options for embedded_in association must include inverse_of.
-        dependent_only_references_one_or_many:
-          The dependent => destroy|delete option that was supplied
-          is only valid on references_one or references_many associations.
-        association_cant_have_inverse_of:
-          Defining an inverse_of on this association is not allowed. Only
-          use this option on embedded_in or references_many as array.
-        calling_document_find_with_nil_is_invalid:
-          Calling Document#find with nil is invalid
-        unsaved_document:
-          "You cannot call create or create! through a relational association
-          relation (%{document}) who's parent (%{base}) is not already saved."
+          message: "Defining a field named '%{name}' is not allowed."
+          summary: "Defining this field would override the method '%{name}',
+            which would cause issues with expectations around the original
+            method and cause extremely hard to debug issues. The original
+            method was defined in:\n
+            \_\_Object: %{origin}\n
+            \_\_File: %{file}\n
+            \_\_Line: %{line}"
+          resolution: "Use Mongoid.destructive_fields to see what names are not
+            allowed, and don't use these names. These include names that also
+            conflict with core Ruby methods on Object, Module, Enumerable, or
+            included gems that inject methods into these or Mongoid internals."
+        invalid_field_option:
+          message: "Invalid option :%{option} provided for field :%{name}."
+          summary: "Mongoid requires that you only provide valid options on each
+            field definition in order to prevent unexpected behaviour later on."
+          resolution: "When defining the field :%{name} on '%{klass}', please provide
+            valid options for the field. These are currently: %{valid}. If you
+            meant to define a custom field option, please do so first like so:\n\n
+            \_\_Mongoid::Fields.option :%{option} do |model, field, value|\n
+            \_\_\_\_# Your logic here...\n
+            \_\_end\n
+            \_\_class %{klass}\n
+            \_\_\_\_include Mongoid::Document\n
+            \_\_\_\_field :%{name}, %{option}: true\n
+            \_\_end\n\n"
+        invalid_index:
+          message: "Invalid index specification on %{klass}: %{spec}, %{options}"
+          summary: "Indexes in Mongoid are defined as a hash of field name and
+            direction/2d pairs, with a hash for any additional options."
+          resolution: "Ensure that the index conforms to the correct syntax and
+            has the correct options.\n\n
+            Valid options are:\n
+            \_\_background: true|false\n
+            \_\_drop_dups: true|false\n
+            \_\_name: 'index_name'\n
+            \_\_sparse: true|false\n
+            \_\_unique: true|false\n\n
+            Valid types are: 1, -1, '2d'\n\n
+            Example:\n
+            \_\_class Band\n
+            \_\_\_\_include Mongoid::Document\n
+            \_\_\_\_index({ name: 1, label: -1 }, { sparse: true })\n
+            \_\_\_\_index({ location: '2d' }, { background: true })\n
+            \_\_end\n\n"
+        invalid_options:
+          message: "Invalid option :%{invalid} provided to relation :%{name}."
+          summary: "Mongoid checks the options that are passed to the relation
+            macros to ensure that no ill side effects occur by letting something
+            slip by."
+          resolution: "Valid options are: %{valid}, make sure these are the ones
+            you are using."
+        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
+            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:
+          message: "Invalid options passed to %{klass}.store_in: %{options}."
+          summary: "The :store_in macro takes only a hash of parameters with
+            the keys :database, :collection, or :session."
+          resolution: "Change the options passed to store_in to match the
+            documented API, and ensure all keys in the options hash are
+            symbols.\n\n
+            Example:\n
+            \_\_class Band\n
+            \_\_\_\_include Mongoid::Document\n
+            \_\_\_\_store_in collection: 'artists', database: 'secondary'\n
+            \_\_end\n\n"
+        invalid_time:
+          message: "'%{value}' is not a valid Time."
+          summary: "Mongoid tries to serialize the values for Date, DateTime, and
+            Time into proper UTC times to store in the database. The provided
+            value could not be parsed."
+          resolution: "Make sure to pass parsable values to the field setter
+            for Date, DateTime, and Time objects. When this is a String it needs
+            to be valid for Time.parse. Other objects must be valid to pass to
+            Time.local."
+        inverse_not_found:
+          message: "When adding a(n) %{klass} to %{base}#%{name}, Mongoid could
+            not determine the inverse foreign key to set. The attempted key was
+            '%{inverse}'."
+          summary: "When adding a document to a relation, Mongoid attempts
+            to link the newly added document to the base of the relation in
+            memory, as well as set the foreign key to link them on the
+            database side. In this case Mongoid could not determine what the
+            inverse foreign key was."
+          resolution: "If an inverse is not required, like a belongs_to or
+            has_and_belongs_to_many, ensure that :inverse_of => nil is set
+            on the relation. If the inverse is needed, most likely the
+            inverse cannot be figured out from the names of the relations and
+            you will need to explicitly tell Mongoid on the relation what
+            the inverse is.\n\n
+            Example:\n
+            \_\_class Lush\n
+            \_\_\_\_include Mongoid::Document\n
+            \_\_\_\_has_one :whiskey, class_name: \"Drink\", inverse_of: :alcoholic\n
+            \_\_end\n\n
+            \_\_class Drink\n
+            \_\_\_\_include Mongoid::Document\n
+            \_\_\_\_belongs_to :alcoholic, class_name: \"Lush\", inverse_of: :whiskey\n
+            \_\_end"
+        invalid_set_polymorphic_relation:
+          message: "The %{name} attribute can't be set to an instance of
+            %{other_klass} as %{other_klass} has multiple relations referencing
+            %{klass} as %{name}."
+          summary: "If the parent class of a polymorphic relation has multiple
+            definitions for the same relation, the values must be set from the
+            parent side and not the child side since Mongoid cannot determine
+            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."
         mixed_relations:
-          Referencing a(n) %{embedded} document from the %{root} document via a
-          relational association is not allowed since the %{embedded} is embedded.
+          message: "Referencing a(n) %{embedded} document from the %{root}
+            document via a relational association is not allowed since the
+            %{embedded} is embedded."
+          summary: "In order to properly access a(n) %{embedded} from %{root}
+            the reference would need to go through the root document of
+            %{embedded}. In a simple case this would require Mongoid to store
+            an extra foreign key for the root, in more complex cases where
+            %{embedded} is multiple levels deep a key would need to be stored
+            for each parent up the hierarchy."
+          resolution: "Consider not embedding %{embedded}, or do the key
+            storage and access in a custom manner in the application code."
+        mixed_session_configuration:
+          message: "Both uri and standard configuration options defined for
+            session: '%{name}'."
+          summary: "Instead of simply giving uri or standard options a
+            preference order, Mongoid assumes that you have made a mistake in
+            your configuration and requires that you provide one or the other,
+            but not both. The options that were provided were: %{config}."
+          resolution: "Provide either only a uri as configuration or only
+            standard options."
+        nested_attributes_metadata_not_found:
+          message: "Could not find metadata for relation '%{name}' on model:
+            %{klass}."
+          summary: "When defining nested attributes for a relation, Mongoid
+            needs to access the metadata for the relation '%{name}' in order
+            if add autosave functionality to it, if applicable. Either no
+            relation named '%{name}' could be found, or the relation had not
+            been defined yet."
+          resolution: "Make sure that there is a relation defined named
+            '%{name}' on %{klass} or that the relation definition comes before
+            the accepts_nested_attributes_for macro in the model - order
+            matters so that Mongoid has access to the metadata.\n\n
+            Example:\n
+            \_\_class Band\n
+            \_\_\_\_include Mongoid::Document\n
+            \_\_\_\_has_many :albums\n
+            \_\_\_\_accepts_nested_attributes_for :albums\n
+            \_\_end\n\n"
+        no_default_session:
+          message: "No default session configuration is defined."
+          summary: "The configuration provided settings for: %{keys}, but
+            Mongoid requires a :default to be defined at minimum."
+          resolution: "If configuring via a mongoid.yml, ensure that within
+            your :sessions section a :default session is defined.\n\n
+            Example:\n
+            \_\_development:\n
+            \_\_\_\_sessions:\n
+            \_\_\_\_\_\_default:\n
+            \_\_\_\_\_\_\_\_hosts:\n
+            \_\_\_\_\_\_\_\_\_\_- localhost:27017\n\n"
         no_environment:
-          "Mongoid attempted to find the appropriate environment but no Rails.env,
-          Sinatra::Base.environment, or RACK_ENV could be found."
+          message: "Could not load the configuration since no environment
+            was defined."
+          summary: "Mongoid attempted to find the appropriate environment
+            but no Rails.env, Sinatra::Base.environment, RACK_ENV, or
+            MONGOID_ENV could be found."
+          resolution: "Make sure some environment is set from the mentioned
+            options. Mongoid cannot load configuration from the yaml without
+            knowing which environment it is in, and we have considered
+            defaulting to development an undesireable side effect of this not
+            being defined."
+        no_map_reduce_output:
+          message: "No output location was specified for the map/reduce
+            operation."
+          summary: "When executing a map/reduce, you must provide the output
+            location of the results. The attempted command was: %{command}."
+          resolution: "Provide the location that the output of the operation
+            is to go by chaining an #out call to the map/reduce.\n\n
+            Example:\n
+            \_\_Band.map_reduce(map, reduce).out(inline: 1)\n\n
+            Valid options for the out function are:\n
+            \_\_inline:  1\n
+            \_\_merge:   'collection-name'\n
+            \_\_replace: 'collection-name'\n
+            \_\_reduce:  'collection-name'\n\n"
+        no_parent:
+          message: "Cannot persist embedded document %{klass} without a
+            parent document."
+          summary: "If the document is embedded, in order to be persisted it
+            must always have a reference to it's parent document. This is
+            most likely cause by either calling %{klass}.create or
+            %{klass}.create! without setting the parent document as an
+            attribute."
+          resolution: "Ensure that you've set the parent relation if
+            instantiating the embedded document direcly, or always create new
+            embedded documents via the parent relation."
+        no_session_config:
+          message: "No configuration could be found for a session named
+            '%{name}'."
+          summary: "When attempting to create the new session, Mongoid could
+            not find a session configuration for the name: '%{name}'. This is
+            necessary in order to know the host, port, and options needed
+            to connect."
+          resolution: "Double check your mongoid.yml to make sure under the
+            sessions key that a configuration exists for '%{name}'. If you
+            have set the configuration programatically, ensure that '%{name}'
+            exists in the configuration hash."
+        no_sessions_config:
+          message: "No sessions configuration provided."
+          summary: "Mongoid's configuration requires that you provide details
+            about each session that can be connected to, and requires in
+            the sessions config at least 1 default session to exist."
+          resolution: "Double check your mongoid.yml to make sure that you
+            have a top-level sessions key with at least 1 default session
+            configuration for it. You can regenerate a new mongoid.yml for
+            assistance via `rails g mongoid:config`.\n\n
+            Example:\n
+            \_\_development:\n
+            \_\_\_\_sessions:\n
+            \_\_\_\_\_\_default:\n
+            \_\_\_\_\_\_\_\_database: mongoid_dev\n
+            \_\_\_\_\_\_\_\_hosts:\n
+            \_\_\_\_\_\_\_\_\_\_- localhost:27017\n\n"
+        no_session_database:
+          message: "No database provided for session configuration: :%{name}."
+          summary: "Each session configuration must provide a database so Mongoid
+            knows where the default database to persist to. What was provided
+            was: %{config}."
+          resolution: "If configuring via a mongoid.yml, ensure that within
+            your :%{name} section a :database value for the session's default
+            database is defined.\n\n
+            Example:\n
+            \_\_development:\n
+            \_\_\_\_sessions:\n
+            \_\_\_\_\_\_%{name}:\n
+            \_\_\_\_\_\_\_\_database: my_app_db\n
+            \_\_\_\_\_\_\_\_hosts:\n
+            \_\_\_\_\_\_\_\_\_\_- localhost:27017\n\n"
+        no_session_hosts:
+          message: "No hosts provided for session configuration: :%{name}."
+          summary: "Each session configuration must provide hosts so Mongoid
+            knows where the database server is located. What was provided
+            was: %{config}."
+          resolution: "If configuring via a mongoid.yml, ensure that within
+            your :%{name} section a :hosts value for the session hosts is
+            defined.\n\n
+            Example:\n
+            \_\_development:\n
+            \_\_\_\_sessions:\n
+            \_\_\_\_\_\_%{name}:\n
+            \_\_\_\_\_\_\_\_database: my_app_db\n
+            \_\_\_\_\_\_\_\_hosts:\n
+            \_\_\_\_\_\_\_\_\_\_- localhost:27017\n\n"
+        readonly_attribute:
+          message: "Attempted to set the readonly attribute '%{name}' with
+            the value: %{value}."
+          summary: "Attributes flagged as readonly via Model.attr_readonly
+            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 it's value after the document is persisted."
         scope_overwrite:
-          "Cannot create scope :%{scope_name}, because of existing method
-          %{model_name}.%{scope_name}."
-        blank_on_locale: "can't be blank in %{location}"
+          message: "Cannot create scope :%{scope_name}, because of existing
+            method %{model_name}.%{scope_name}."
+          summary: "When defining a scope that conflicts with a method that
+            already exists on the model, this error will get raised if
+            Mongoid.scope_overwrite_exception is set to true."
+          resolution: "Change the name of the scope so it does not conflict
+            with the already defined method %{model_name}, or set the
+            configuration option Mongoid.scope_overwrite_exception to false,
+            which is it's default. In this case a warning will be logged."
+        taken:
+          "is already taken"
+        too_many_nested_attribute_records:
+          message: "Accepting nested attributes for %{association} is limited
+            to %{limit} records."
+          summary: "More documents were sent to be processed than the allowed
+            limit."
+          resolution: "The limit is set as an option to the macro, for example:
+            accepts_nested_attributes_for :%{association}, limit: %{limit}.
+            Consider raising this limit or making sure no more are sent than
+            the set value."
+        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
+            attributes hash, and is raised instead of getting a NoMethodError."
+          resolution: "You can set Mongoid.allow_dynamic_fields to true if you
+            expect to be writing values for undefined fields often."
+        unsaved_document:
+          message: "Attempted to save %{document} before the parent %{base}."
+          summary: "You cannot call create or create! through the
+            relation (%{document}) who's parent (%{base}) is
+            not already saved. This would case the database to be out of sync
+            since the child could potentially reference a nonexistant parent."
+          resolution: "Make sure to only use create or create! when the parent
+            document %{base} is persisted."
+        unsupported_version:
+          message: "MongoDB %{version} not supported, please upgrade to
+            %{mongo_version}."
+          summary: "Mongoid is relying on features that were introduced in
+            MongoDB %{mongo_version} and would cause unexpected behaviour or errors
+            on version %{version}."
+          resolution: "Upgrade your MongoDB instances or keep Mongoid on your
+            previous version."
+        unsupported_javascript:
+          message: "Executing Javascript $where selector on an embedded criteria
+            is not supported."
+          summary: "Mongoid only supports providing a hash of arguments to
+            #where criterion on embedded documents. Since %{klass} is embedded,
+            the expression %{javascript} is not allowed."
+          resolution: "Please provide a standard hash to #where when the criteria
+            is for an embedded relation."
+        validations:
+          message: "Validation of %{document} failed."
+          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,
+            Mongoid will raise an error when attempting to delete the
+            %{document} when the child '%{relation}' still has documents in it."
+          resolution: "Don't attempt to delete the parent %{document} when
+            it has children, or change the dependent option on the relation."