mongoid 6.4.2 → 7.0.3

checksums.yaml.gz.sig

@@ -1,2 +0,0 @@
-�]�h:Ǜ^����TA�����9���%l���=�c�o�E��p'=�eO�ï���첈.�*�_��H�ݻ��ɓf�Q\>�o��
-�����r7�7+��z����9woI��kJ��Z%�sn����[Sh�NK�}4�l�<0G���O�x8��gOpp�ht��oc3��l�J�`�N�'�t���[h]+�g��`�P�2ޭ�M���3!z8R�r�6�M������L���N�[��z��,j ��;Ӑ

data/lib/mongoid/relations/accessors.rb

@@ -1,267 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Relations
-
-    # This module contains all the behaviour related to accessing relations
-    # through the getters and setters, and how to delegate to builders to
-    # create new ones.
-    module Accessors
-      extend ActiveSupport::Concern
-
-      # Builds the related document and creates the relation unless the
-      # document is nil, then sets the relation on this document.
-      #
-      # @example Build the relation.
-      #   person.__build__(:addresses, { :_id => 1 }, metadata)
-      #
-      # @param [ String, Symbol ] name The name of the relation.
-      # @param [ Hash, BSON::ObjectId ] object The id or attributes to use.
-      # @param [ Metadata ] metadata The relation's metadata.
-      #
-      # @return [ Proxy ] The relation.
-      #
-      # @since 2.0.0.rc.1
-      def __build__(name, object, metadata)
-        relation = create_relation(object, metadata)
-        set_relation(name, relation)
-      end
-
-      # Create a relation from an object and metadata.
-      #
-      # @example Create the relation.
-      #   person.create_relation(document, metadata)
-      #
-      # @param [ Document, Array<Document> ] object The relation target.
-      # @param [ Metadata ] metadata The relation metadata.
-      #
-      # @return [ Proxy ] The relation.
-      #
-      # @since 2.0.0.rc.1
-      def create_relation(object, metadata)
-        type = @attributes[metadata.inverse_type]
-        target = metadata.builder(self, object).build(type)
-        target ? metadata.relation.new(self, target, metadata) : nil
-      end
-
-      # Resets the criteria inside the relation proxy. Used by many to many
-      # relations to keep the underlying ids array in sync.
-      #
-      # @example Reset the relation criteria.
-      #   person.reset_relation_criteria(:preferences)
-      #
-      # @param [ Symbol ] name The name of the relation.
-      #
-      # @since 3.0.14
-      def reset_relation_criteria(name)
-        if instance_variable_defined?("@_#{name}")
-          send(name).reset_unloaded
-        end
-      end
-
-      # Set the supplied relation to an instance variable on the class with the
-      # provided name. Used as a helper just for code cleanliness.
-      #
-      # @example Set the proxy on the document.
-      #   person.set(:addresses, addresses)
-      #
-      # @param [ String, Symbol ] name The name of the relation.
-      # @param [ Proxy ] relation The relation to set.
-      #
-      # @return [ Proxy ] The relation.
-      #
-      # @since 2.0.0.rc.1
-      def set_relation(name, relation)
-        instance_variable_set("@_#{name}", relation)
-      end
-
-      private
-
-      # Get the relation. Extracted out from the getter method to avoid
-      # infinite recursion when overriding the getter.
-      #
-      # @api private
-      #
-      # @example Get the relation.
-      #   document.get_relation(:name, metadata)
-      #
-      # @param [ Symbol ] name The name of the relation.
-      # @param [ Metadata ] metadata The relation metadata.
-      # @param [ true, false ] reload If the relation is to be reloaded.
-      #
-      # @return [ Proxy ] The relation.
-      #
-      # @since 3.0.16
-      def get_relation(name, metadata, object, reload = false)
-        if !reload && (value = ivar(name)) != false
-          value
-        else
-          _building do
-            _loading do
-              if object && needs_no_database_query?(object, metadata)
-                __build__(name, object, metadata)
-              else
-                __build__(name, attributes[metadata.key], metadata)
-              end
-            end
-          end
-        end
-      end
-
-      def needs_no_database_query?(object, metadata)
-        object.is_a?(Document) && !object.embedded? &&
-          object._id == attributes[metadata.key]
-      end
-
-      # Is the current code executing without autobuild functionality?
-      #
-      # @example Is autobuild disabled?
-      #   document.without_autobuild?
-      #
-      # @return [ true, false ] If autobuild is disabled.
-      #
-      # @since 3.0.0
-      def without_autobuild?
-        Threaded.executing?(:without_autobuild)
-      end
-
-      # Yield to the block with autobuild functionality turned off.
-      #
-      # @example Execute without autobuild.
-      #   document.without_autobuild do
-      #     document.name
-      #   end
-      #
-      # @return [ Object ] The result of the yield.
-      #
-      # @since 3.0.0
-      def without_autobuild
-        Threaded.begin_execution("without_autobuild")
-        yield
-      ensure
-        Threaded.exit_execution("without_autobuild")
-      end
-
-      module ClassMethods
-
-        # Adds the existence check for relations.
-        #
-        # @example Add the existence check.
-        #   Person.existence_check(:name, meta)
-        #
-        # @example Check if a relation exists.
-        #   person = Person.new
-        #   person.has_game?
-        #   person.game?
-        #
-        # @param [ String, Symbol ] name The name of the relation.
-        #
-        # @return [ Class ] The model being set up.
-        #
-        # @since 3.0.0
-        def existence_check(name)
-          module_eval <<-END, __FILE__, __LINE__ + 1
-            def #{name}?
-              without_autobuild { !__send__(:#{name}).blank? }
-            end
-            alias :has_#{name}? :#{name}?
-          END
-          self
-        end
-
-        # Defines the getter for the relation. Nothing too special here: just
-        # return the instance variable for the relation if it exists or build
-        # the thing.
-        #
-        # @example Set up the getter for the relation.
-        #   Person.getter("addresses", metadata)
-        #
-        # @param [ String, Symbol ] name The name of the relation.
-        # @param [ Metadata ] metadata The metadata for the relation.
-        #
-        # @return [ Class ] The class being set up.
-        #
-        # @since 2.0.0.rc.1
-        def getter(name, metadata)
-          re_define_method(name) do |reload = false|
-            value = get_relation(name, metadata, nil, reload)
-            if value.nil? && metadata.autobuilding? && !without_autobuild?
-              value = send("build_#{name}")
-            end
-            value
-          end
-          self
-        end
-
-        # Defines the getter for the ids of documents in the relation. Should
-        # be specify only for referenced many relations.
-        #
-        # @example Set up the ids getter for the relation.
-        #   Person.ids_getter("addresses", metadata)
-        #
-        # @param [ String, Symbol ] name The name of the relation.
-        #
-        # @return [ Class ] The class being set up.
-        def ids_getter(name, metadata)
-          ids_method = "#{name.to_s.singularize}_ids"
-          re_define_method(ids_method) do
-            send(name).only(:id).map(&:id)
-          end
-          self
-        end
-
-        # Defines the setter for the relation. This does a few things based on
-        # some conditions. If there is an existing association, a target
-        # substitution will take place, otherwise a new relation will be
-        # created with the supplied target.
-        #
-        # @example Set up the setter for the relation.
-        #   Person.setter("addresses", metadata)
-        #
-        # @param [ String, Symbol ] name The name of the relation.
-        # @param [ Metadata ] metadata The metadata for the relation.
-        #
-        # @return [ Class ] The class being set up.
-        #
-        # @since 2.0.0.rc.1
-        def setter(name, metadata)
-          re_define_method("#{name}=") do |object|
-            without_autobuild do
-              if value = get_relation(name, metadata, object)
-                if value.respond_to?(:substitute)
-                  set_relation(name, value.substitute(object.substitutable))
-                else
-                  value = __build__(name, value, metadata)
-                  set_relation(name, value.substitute(object.substitutable))
-                end
-              else
-                __build__(name, object.substitutable, metadata)
-              end
-            end
-          end
-          self
-        end
-
-        # Defines the setter method that allows you to set documents
-        # in this relation by their ids. The defined setter, finds
-        # documents with given ids and invokes regular relation setter
-        # with found documents. Ids setters should be defined only for
-        # referenced many relations.
-        #
-        # @example Set up the id_setter for the relation.
-        #   Person.ids_setter("addesses", metadata)
-        #
-        #  @param [ String, Symbol ] name The name of the relation.
-        #  @param [ Metadata ] metadata The metadata for the relation.
-        #
-        #  @return [ Class ] The class being set up.
-        def ids_setter(name, metadata)
-          ids_method = "#{name.to_s.singularize}_ids="
-          re_define_method(ids_method) do |ids|
-            send(metadata.setter, metadata.klass.find(ids.reject(&:blank?)))
-          end
-          self
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/relations/auto_save.rb

@@ -1,94 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Relations
-
-    # This module contains the behaviour for auto-saving relations in
-    # different collections.
-    module AutoSave
-      extend ActiveSupport::Concern
-
-      # Used to prevent infinite loops in associated autosaves.
-      #
-      # @example Is the document autosaved?
-      #   document.autosaved?
-      #
-      # @return [ true, false ] Has the document already been autosaved?
-      #
-      # @since 3.0.0
-      def autosaved?
-        Threaded.autosaved?(self)
-      end
-
-      # Begin the associated autosave.
-      #
-      # @example Begin autosave.
-      #   document.__autosaving__
-      #
-      # @since 3.1.3
-      def __autosaving__
-        Threaded.begin_autosave(self)
-        yield
-      ensure
-        Threaded.exit_autosave(self)
-      end
-
-      # Check if there is changes for auto-saving
-      #
-      # @example Return true if there is changes on self or in
-      #           autosaved relations.
-      #   document.changed_for_autosave?
-      #
-      # @since 3.1.3
-      def changed_for_autosave?(doc)
-        doc.new_record? || doc.changed? || doc.marked_for_destruction?
-      end
-
-      module ClassMethods
-
-        # Set up the autosave behaviour for references many and references one
-        # relations. When the option is set to true, these relations will get
-        # saved automatically when the parent saved, if they are dirty.
-        #
-        # @example Set up autosave options.
-        #   Person.autosave(metadata)
-        #
-        # @param [ Metadata ] metadata The relation metadata.
-        #
-        # @since 2.0.0.rc.1
-        def autosave(metadata)
-          if metadata.autosave? && !metadata.embedded?
-            save_method = :"autosave_documents_for_#{metadata.name}"
-            define_method(save_method) do
-              if before_callback_halted?
-                self.before_callback_halted = false
-              else
-                __autosaving__ do
-                  if relation = ivar(metadata.name)
-                    if :belongs_to == metadata.macro
-                      if changed_for_autosave?(relation)
-                        relation.with(persistence_context) do |_relation|
-                          _relation.save
-                        end
-                      end
-                    else
-                      Array(relation).each do |doc|
-                        if changed_for_autosave?(doc)
-                          doc.with(persistence_context) do |d|
-                            d.save
-                          end
-                        end
-                      end
-                    end
-                  end
-                end
-              end
-            end
-
-            after_save save_method, unless: :autosaved?
-          end
-        end
-
-      end
-    end
-  end
-end

data/lib/mongoid/relations/bindings/embedded/in.rb

@@ -1,59 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Relations
-    module Bindings
-      module Embedded
-
-        # Binding class for embedded_in relations.
-        class In < Binding
-
-          # Binds the base object to the inverse of the relation. This is so we
-          # are referenced to the actual objects themselves on both sides.
-          #
-          # This case sets the metadata on the inverse object as well as the
-          # document itself.
-          #
-          # @example Bind the documents.
-          #   name.person.bind(:continue => true)
-          #   name.person = Person.new
-          #
-          # @option options [ true, false ] :continue Continue binding the inverse.
-          # @option options [ true, false ] :binding Are we in build mode?
-          #
-          # @since 2.0.0.rc.1
-          def bind_one
-            base.__metadata = metadata.inverse_metadata(target) unless base.__metadata
-            base.parentize(target)
-            binding do
-              if base.embedded_many?
-                target.do_or_do_not(metadata.inverse(target)).push(base)
-              else
-                target.do_or_do_not(metadata.inverse_setter(target), base)
-              end
-            end
-          end
-
-          # Unbinds the base object and the inverse, caused by setting the
-          # reference to nil.
-          #
-          # @example Unbind the document.
-          #   name.person.unbind(:continue => true)
-          #   name.person = nil
-          #
-          # @option options [ true, false ] :continue Do we continue unbinding?
-          #
-          # @since 2.0.0.rc.1
-          def unbind_one
-            binding do
-              if base.embedded_many?
-                target.do_or_do_not(metadata.inverse(target)).delete(base)
-              else
-                target.do_or_do_not(metadata.inverse_setter(target), nil)
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/relations/bindings/referenced/in.rb

@@ -1,65 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Relations
-    module Bindings
-      module Referenced
-
-        # Binding class for all referenced_in relations.
-        class In < Binding
-
-          # Binds the base object to the inverse of the relation. This is so we
-          # are referenced to the actual objects themselves on both sides.
-          #
-          # This case sets the metadata on the inverse object as well as the
-          # document itself.
-          #
-          # @example Bind the documents.
-          #   game.person.bind(:continue => true)
-          #   game.person = Person.new
-          #
-          # @since 2.0.0.rc.1
-          def bind_one
-            binding do
-              check_inverses!(target)
-              bind_foreign_key(base, record_id(target))
-              bind_polymorphic_inverse_type(base, target.class.name)
-              if inverse = metadata.inverse(target)
-                if set_base_metadata
-                  if base.referenced_many?
-                    target.__send__(inverse).push(base)
-                  else
-                    target.set_relation(inverse, base)
-                  end
-                end
-              end
-            end
-          end
-
-          # Unbinds the base object and the inverse, caused by setting the
-          # reference to nil.
-          #
-          # @example Unbind the document.
-          #   game.person.unbind(:continue => true)
-          #   game.person = nil
-          #
-          # @since 2.0.0.rc.1
-          def unbind_one
-            binding do
-              inverse = metadata.inverse(target)
-              bind_foreign_key(base, nil)
-              bind_polymorphic_inverse_type(base, nil)
-              if inverse
-                set_base_metadata
-                if base.referenced_many?
-                  target.__send__(inverse).delete(base)
-                else
-                  target.set_relation(inverse, nil)
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/relations/bindings/referenced/many_to_many.rb

@@ -1,70 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Relations
-    module Bindings
-      module Referenced
-
-        # Binding class for all references_and_referenced_in_many relations.
-        class ManyToMany < Binding
-
-          # Binds a single document with the inverse relation. Used
-          # specifically when appending to the proxy.
-          #
-          # @example Bind one document.
-          #   person.preferences.bind_one(preference)
-          #
-          # @param [ Document ] doc The single document to bind.
-          #
-          # @since 2.0.0.rc.1
-          def bind_one(doc)
-            binding do
-              inverse_keys = doc.you_must(metadata.inverse_foreign_key)
-              if inverse_keys
-                record_id = inverse_record_id(doc)
-                unless inverse_keys.include?(record_id)
-                  doc.you_must(metadata.inverse_foreign_key_setter, inverse_keys.push(record_id))
-                end
-                doc.reset_relation_criteria(metadata.inverse)
-              end
-              base._synced[metadata.foreign_key] = true
-              doc._synced[metadata.inverse_foreign_key] = true
-            end
-          end
-
-          # Unbind a single document.
-          #
-          # @example Unbind the document.
-          #   person.preferences.unbind_one(document)
-          #
-          # @since 2.0.0.rc.1
-          def unbind_one(doc)
-            binding do
-              base.send(metadata.foreign_key).delete_one(record_id(doc))
-              inverse_keys = doc.you_must(metadata.inverse_foreign_key)
-              if inverse_keys
-                inverse_keys.delete_one(inverse_record_id(doc))
-                doc.reset_relation_criteria(metadata.inverse)
-              end
-              base._synced[metadata.foreign_key] = true
-              doc._synced[metadata.inverse_foreign_key] = true
-            end
-          end
-
-          # Find the inverse id referenced by inverse_keys
-          def inverse_record_id(doc)
-            inverse_metadata = determine_inverse_metadata(doc)
-            if inverse_metadata
-              base.__send__(inverse_metadata.primary_key)
-            else
-              base._id
-            end
-          end
-
-          def determine_inverse_metadata(doc)
-            doc.relations[base.class.name.demodulize.underscore.pluralize]
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/relations/bindings.rb

@@ -1,9 +0,0 @@
-# encoding: utf-8
-require "mongoid/relations/binding"
-require "mongoid/relations/bindings/embedded/in"
-require "mongoid/relations/bindings/embedded/many"
-require "mongoid/relations/bindings/embedded/one"
-require "mongoid/relations/bindings/referenced/in"
-require "mongoid/relations/bindings/referenced/many"
-require "mongoid/relations/bindings/referenced/many_to_many"
-require "mongoid/relations/bindings/referenced/one"

data/lib/mongoid/relations/builder.rb

@@ -1,57 +0,0 @@
-# encoding: utf-8
-module Mongoid
-  module Relations
-
-    # Superclass for all builder objects. Builders are responsible for either
-    # looking up a relation's target from the database, or creating them from a
-    # supplied attributes hash.
-    class Builder
-      include Threaded::Lifecycle
-
-      attr_reader :base, :metadata, :object
-
-      # Instantiate the new builder for a relation.
-      #
-      # @example Create the builder.
-      #   Builder.new(metadata, { :field => "value })
-      #
-      # @param [ Document ] base The base document.
-      # @param [ Metdata ] metadata The metadata for the relation.
-      # @param [ Hash, BSON::ObjectId ] object The attributes to build from or
-      #   id to query with.
-      #
-      # @since 2.0.0.rc.1
-      def initialize(base, metadata, object)
-        @base, @metadata, @object = base, metadata, object
-      end
-
-      protected
-
-      # Get the class from the metadata.
-      #
-      # @example Get the class.
-      #   builder.klass
-      #
-      # @return [ Class ] The class from the metadata.
-      #
-      # @since 2.3.2
-      def klass
-        @klass ||= metadata.klass
-      end
-
-      # Do we need to perform a database query? It will be so if the object we
-      # have is not a document.
-      #
-      # @example Should we query the database?
-      #   builder.query?
-      #
-      # @return [ true, false ] Whether a database query should happen.
-      #
-      # @since 2.0.0.rc.1
-      def query?
-        obj = object.__array__.first
-        !obj.is_a?(Mongoid::Document) && !obj.nil?
-      end
-    end
-  end
-end