mongoid 8.1.13 → 9.0.0

metadata.gz.sig

@@ -0,0 +1 @@
+R`�#4�ml�k>e�?��/���

data/lib/mongoid/association/referenced/eager.rb

@@ -1,163 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Association
-    module Referenced
-      module Eager
-
-        # Base class for eager load preload functions.
-        class Base
-
-          # Instantiate the eager load class.
-          #
-          # @example Create the new belongs to eager load preloader.
-          #   BelongsTo.new(association, parent_docs)
-          #
-          # @param [ Array<Association> ] associations Associations to eager load
-          # @param [ Array<Document> ] docs Documents to preload the associations
-          #
-          # @return [ Base ] The eager load preloader
-          def initialize(associations, docs)
-            @associations = associations
-            @docs = docs
-            @grouped_docs = {}
-          end
-
-          # Run the preloader.
-          #
-          # @example Preload the associations into the documents.
-          #   loader.run
-          #
-          # @return [ Array ] The list of documents given.
-          def run
-            @loaded = []
-            while shift_association
-              preload
-              @loaded << @docs.collect { |d| d.send(@association.name) if d.respond_to?(@association.name) }
-            end
-            @loaded.flatten
-          end
-
-          protected
-
-          # Preload the current association.
-          #
-          # This method should be implemented in the subclass
-          #
-          # @example Preload the current association into the documents.
-          #   loader.preload
-          def preload
-            raise NotImplementedError
-          end
-
-          # Retrieves the documents referenced by the association, and
-          # yields each one sequentially to the provided block. If the
-          # association is not polymorphic, all documents are retrieved in
-          # a single query. If the association is polymorphic, one query is
-          # issued per association target class.
-          def each_loaded_document(&block)
-            each_loaded_document_of_class(@association.klass, keys_from_docs, &block)
-          end
-
-          # Retrieves the documents of the specified class, that have the
-          # foreign key included in the specified list of keys.
-          #
-          # When the documents are retrieved, the set of inclusions applied
-          # is the set of inclusions applied to the host document minus the
-          # association that is being eagerly loaded.
-          private def each_loaded_document_of_class(cls, keys)
-            # Note: keys should not include nil elements.
-            # Upstream code is responsible for eliminating nils from keys.
-            return cls.none if keys.empty?
-
-            criteria = cls.criteria
-            criteria = criteria.apply_scope(@association.scope)
-            criteria = criteria.any_in(key => keys)
-            criteria.inclusions = criteria.inclusions - [@association]
-            criteria.each do |doc|
-              yield doc
-            end
-          end
-
-          # Set the pre-loaded document into its parent.
-          #
-          # @example Set docs into parent with pk = "foo"
-          #   loader.set_on_parent("foo", docs)
-          #
-          # @param [ ObjectId ] id parent`s id
-          # @param [ Document | Array ] element to push into the parent
-          def set_on_parent(id, element)
-            grouped_docs[id].each do |d|
-              set_relation(d, element)
-            end
-          end
-
-          # Return a hash with the current documents grouped by key.
-          #
-          # Documents that do not have a value for the association being loaded
-          # are not returned.
-          #
-          # @example Return a hash with the current documents grouped by key.
-          #   loader.grouped_docs
-          #
-          # @return [ Hash ] hash with grouped documents.
-          def grouped_docs
-            @grouped_docs[@association.name] ||= @docs.group_by do |doc|
-              doc.send(group_by_key) if doc.respond_to?(group_by_key)
-            end.reject do |k, v|
-              k.nil?
-            end
-          end
-
-          # Group the documents and return the keys.
-          #
-          # This method omits nil keys (i.e. keys from documents that do not
-          # have a value for the association being loaded).
-          #
-          # @example
-          #   loader.keys_from_docs
-          #
-          # @return [ Array ] keys, ids
-          def keys_from_docs
-            grouped_docs.keys
-          end
-
-          # Return the key to group the current documents.
-          #
-          # This method should be implemented in the subclass
-          #
-          # @example Return the key for group
-          #   loader.group_by_key
-          #
-          # @return [ Symbol ] Key to group by the current documents.
-          def group_by_key
-            raise NotImplementedError
-          end
-
-          # Set the pre-loaded document into its parent.
-          #
-          # @example Set docs into parent using the current association name.
-          #   loader.set_relation(doc, docs)
-          #
-          # @param [ Document ] doc The object to set the association on
-          # @param [ Document | Array ] element to set into the parent
-          def set_relation(doc, element)
-            doc.set_relation(@association.name, element) unless doc.blank?
-          end
-
-          private
-
-          # Shift the current association metadata
-          #
-          # @example Shift the current association.
-          #   loader.shift_association
-          #
-          # @return [ Association ] The association object.
-          def shift_association
-            @association = @associations.shift
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/association/referenced/has_one/nested_builder.rb

@@ -1,113 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Association
-    module Referenced
-      module NestedAttributes
-        class One < NestedBuilder
-
-          attr_accessor :destroy
-
-          # Builds the association depending on the attributes and the options
-          # passed to the macro.
-          #
-          # @example Build a 1-1 nested document.
-          #   one.build(person, as: :admin)
-          #
-          # @note This attempts to perform 3 operations, either one of an update of
-          #   the existing association, a replacement of the association with a new
-          #   document, or a removal of the association.
-          #
-          # @param [ Document ] parent The parent document.
-          #
-          # @return [ Document ] The built document.
-          def build(parent)
-            return if reject?(parent, attributes)
-            @existing = parent.send(association.name)
-            if update?
-              attributes.delete_id
-              existing.assign_attributes(attributes)
-            elsif replace?
-              parent.send(association.setter, Factory.build(association.klass, attributes))
-            elsif delete?
-              parent.send(association.setter, nil)
-            end
-          end
-
-          # Create the new builder for nested attributes on one-to-one
-          # associations.
-          #
-          # @example Instantiate the builder.
-          #   One.new(association, attributes)
-          #
-          # @param [ Association ] association The association metadata.
-          # @param [ Hash ] attributes The attributes hash to attempt to set.
-          # @param [ Hash ] options The options defined.
-          def initialize(association, attributes, options)
-            @attributes = attributes.with_indifferent_access
-            @association = association
-            @options = options
-            @destroy = @attributes.delete(:_destroy)
-          end
-
-          private
-
-          # Is the id in the attribtues acceptable for allowing an update to
-          # the existing association?
-          #
-          # @api private
-          #
-          # @example Is the id acceptable?
-          #   one.acceptable_id?
-          #
-          # @return [ true | false ] If the id part of the logic will allow an update.
-          def acceptable_id?
-            id = convert_id(existing.class, attributes[:_id])
-            existing._id == id || id.nil? || (existing._id != id && update_only?)
-          end
-
-          # Can the existing association be deleted?
-          #
-          # @example Can the existing object be deleted?
-          #   one.delete?
-          #
-          # @return [ true | false ] If the association should be deleted.
-          def delete?
-            destroyable? && !attributes[:_id].nil?
-          end
-
-          # Can the existing association potentially be destroyed?
-          #
-          # @example Is the object destroyable?
-          #   one.destroyable?({ :_destroy => "1" })
-          #
-          # @return [ true | false ] If the association can potentially be
-          #   destroyed.
-          def destroyable?
-            [ 1, "1", true, "true" ].include?(destroy) && allow_destroy?
-          end
-
-          # Is the document to be replaced?
-          #
-          # @example Is the document to be replaced?
-          #   one.replace?
-          #
-          # @return [ true | false ] If the document should be replaced.
-          def replace?
-            !existing && !destroyable? && !attributes.blank?
-          end
-
-          # Should the document be updated?
-          #
-          # @example Should the document be updated?
-          #   one.update?
-          #
-          # @return [ true | false ] If the object should have its attributes updated.
-          def update?
-            existing && !destroyable? && acceptable_id?
-          end
-        end
-      end
-    end
-  end
-end

data/lib/mongoid/contextual/geo_near.rb

@@ -1,236 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Contextual
-    class GeoNear
-      extend Forwardable
-      include Enumerable
-      include Command
-
-      def_delegator :results, :[]
-      def_delegators :entries, :==, :empty?
-
-      # Get the average distance for all documents from the point in the
-      # command.
-      #
-      # @example Get the average distance.
-      #   geo_near.average_distance
-      #
-      # @return [ Float | nil ] The average distance.
-      def average_distance
-        average = stats["avgDistance"]
-        (average.nil? || average.nan?) ? nil : average
-      end
-
-      # Iterates over each of the documents in the $geoNear, excluding the
-      # extra information that was passed back from the database.
-      #
-      # @example Iterate over the results.
-      #   geo_near.each do |doc|
-      #     p doc
-      #   end
-      #
-      # @return [ Enumerator ] The enumerator.
-      def each
-        if block_given?
-          documents.each do |doc|
-            yield doc
-          end
-        else
-          to_enum
-        end
-      end
-
-      # Provide a distance multiplier to be used for each returned distance.
-      #
-      # @example Provide the distance multiplier.
-      #   geo_near.distance_multiplier(13113.1)
-      #
-      # @param [ Integer | Float ] value The distance multiplier.
-      #
-      # @return [ GeoNear ] The GeoNear wrapper.
-      def distance_multiplier(value)
-        command[:distanceMultiplier] = value
-        self
-      end
-
-      # Initialize the new map/reduce directive.
-      #
-      # @example Initialize the new map/reduce.
-      #   MapReduce.new(criteria, map, reduce)
-      #
-      # @param [ Mongo::Collection ] collection The collection to run the
-      #   operation on.
-      # @param [ Criteria ] criteria The Mongoid criteria.
-      # @param [ String ] near
-      def initialize(collection, criteria, near)
-        @collection, @criteria = collection, criteria
-        command[:geoNear] = collection.name.to_s
-        command[:near] = near
-        apply_criteria_options
-      end
-
-      # Get a pretty string representation of the command.
-      #
-      # @example Inspect the geoNear.
-      #   geo_near.inspect
-      #
-      # @return [ String ] The inspection string.
-      def inspect
-%Q{#<Mongoid::Contextual::GeoNear
-  selector:   #{criteria.selector.inspect}
-  class:      #{criteria.klass}
-  near:       #{command[:near]}
-  multiplier: #{command[:distanceMultiplier] || "N/A"}
-  max:        #{command[:maxDistance] || "N/A"}
-  min:        #{command[:minDistance] || "N/A"}
-  unique:     #{command[:unique].nil? ? true : command[:unique]}
-  spherical:  #{command[:spherical] || false}>
-}
-      end
-
-      # Specify the maximum distance to find documents for, or get the value of
-      # the document with the furthest distance.
-      #
-      # @example Set the max distance.
-      #   geo_near.max_distance(0.5)
-      #
-      # @example Get the max distance.
-      #   geo_near.max_distance
-      #
-      # @param [ Integer | Float ] value The maximum distance.
-      #
-      # @return [ GeoNear | Float ] The GeoNear command or the value.
-      def max_distance(value = nil)
-        if value
-          command[:maxDistance] = value
-          self
-        else
-          stats["maxDistance"]
-        end
-      end
-
-      # Specify the minimum distance to find documents for.
-      #
-      # @example Set the min distance.
-      #   geo_near.min_distance(0.5)
-      #
-      # @param [ Integer | Float ] value The minimum distance.
-      #
-      # @return [ GeoNear ] The GeoNear command.
-      def min_distance(value)
-        command[:minDistance] = value
-        self
-      end
-
-      # Tell the command to calculate based on spherical distances.
-      #
-      # @example Add the spherical flag.
-      #   geo_near.spherical
-      #
-      # @return [ GeoNear ] The command.
-      def spherical
-        command[:spherical] = true
-        self
-      end
-
-      # Tell the command whether or not the returned results should be unique.
-      #
-      # @example Set the unique flag.
-      #   geo_near.unique(false)
-      #
-      # @param [ true | false ] value Whether to return unique documents.
-      #
-      # @return [ GeoNear ] The command.
-      def unique(value = true)
-        command[:unique] = value
-        self
-      end
-
-      # Execute the $geoNear, returning the raw output.
-      #
-      # @example Run the $geoNear
-      #   geo_near.execute
-      #
-      # @return [ Hash ] The raw output
-      def execute
-        results
-      end
-
-      # Get the stats for the command run.
-      #
-      # @example Get the stats.
-      #   geo_near.stats
-      #
-      # @return [ Hash ] The stats from the command run.
-      def stats
-        results["stats"]
-      end
-
-      # Get the execution time of the command.
-      #
-      # @example Get the execution time.
-      #   geo_near.time
-      #
-      # @return [ Float ] The execution time.
-      def time
-        stats["time"]
-      end
-
-      # Is this context's criteria considered empty?
-      #
-      # @example Is this context's criteria considered empty?
-      #   geo_near.empty_and_chainable?
-      #
-      # @return [ true ] Always true.
-      def empty_and_chainable?
-        true
-      end
-
-      private
-
-      # Apply criteria specific options - query, limit.
-      #
-      # @api private
-      #
-      # @example Apply the criteria options
-      #   geo_near.apply_criteria_options
-      #
-      # @return [ nil ] Nothing.
-      def apply_criteria_options
-        command[:query] = criteria.selector
-        if limit = criteria.options[:limit]
-          command[:num] = limit
-        end
-      end
-
-      # Get the result documents from the $geoNear.
-      #
-      # @api private
-      #
-      # @example Get the documents.
-      #   geo_near.documents
-      #
-      # @return [ Array | Cursor ] The documents.
-      def documents
-        results["results"].map do |attributes|
-          doc = Factory.from_db(criteria.klass, attributes["obj"], criteria)
-          doc.attributes["geo_near_distance"] = attributes["dis"]
-          doc
-        end
-      end
-
-      # Execute the $geoNear command and get the results.
-      #
-      # @api private
-      #
-      # @example Get the results.
-      #   geo_near.results
-      #
-      # @return [ Hash ] The results of the command.
-      def results
-        @results ||= client.command(command).first
-      end
-    end
-  end
-end

data/lib/mongoid/errors/in_memory_regexp_timeout.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Errors
-    # This error is raised when evaluating a query in memory exceeds
-    # Mongoid::Config.in_memory_regexp_time_limit.
-    #
-    # What the limit bounds depends on the Ruby in use. Where per-Regexp
-    # timeouts are available it is the time spent executing regular
-    # expressions; elsewhere it is the elapsed time of the whole in-memory
-    # evaluation. The message is worded to hold either way.
-    class InMemoryRegexpTimeout < MongoidError
-      # Create the new error.
-      #
-      # @example Create the new in-memory regexp timeout error.
-      #   InMemoryRegexpTimeout.new(5.0)
-      #
-      # @param [ Float ] limit The limit that was exceeded, in seconds. Not
-      #   always the configured one: a global Regexp.timeout stricter than the
-      #   configuration takes its place.
-      def initialize(limit)
-        super(compose_message('in_memory_regexp_timeout', limit: limit))
-      end
-    end
-  end
-end

data/lib/mongoid/errors/invalid_session_use.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Errors
-
-    # This error is raised when a session is attempted to be used with a model whose client cannot use it, if
-    #   sessions are nested, or if the mongodb deployment doesn't support sessions.
-    class InvalidSessionUse < MongoidError
-
-      # Create the error.
-      #
-      # @example Create the error.
-      #   InvalidSessionUse.new(:invalid_session_use)
-      #
-      # @param [ :invalid_session_use | :invalid_session_nesting ] error_type The type of session misuse.
-      def initialize(error_type)
-        super(compose_message(error_type.to_s))
-      end
-    end
-  end
-end

data/lib/mongoid/errors/invalid_storage_parent.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Errors
-
-    # Raised when calling store_in in a sub-class of Mongoid::Document
-    #
-    # @deprecated
-    class InvalidStorageParent < MongoidError
-
-      # Create the new error.
-      #
-      # @example Create the new error.
-      #    InvalidStorageParent.new(Person)
-      #
-      # @param [ Class ] klass The model class.
-      def initialize(klass)
-        super(
-          compose_message(
-            "invalid_storage_parent",
-            { klass: klass }
-          )
-        )
-      end
-    end
-  end
-end

data/lib/mongoid/field_readable.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-# rubocop:todo all
-
-module Mongoid
-  # Reads the value of a field name from a document without dispatching the
-  # name as an arbitrary method.
-  #
-  # Field names may come from application input, where a name like +destroy+
-  # or +attributes+ would delete the document or disclose its contents.
-  # Declared field and association names are validated when they are declared
-  # (see Mongoid.destructive_fields), so a name that resolves to one of them
-  # is safe to send to a document. Any other name is read from the attributes
-  # hash, which is what the database-backed query contexts do.
-  #
-  # @api private
-  module FieldReadable
-    private
-
-    # Read the value of the given field name from the given document.
-    #
-    # @param [ Document ] document The document to read from.
-    # @param [ String | Symbol ] name The name of the field.
-    #
-    # @return [ Object | nil ] The value of the field, or nil when the name
-    #   is neither a declared field nor present in the attributes.
-    def read_field_value(document, name)
-      name = name.to_s
-      # A blank name cannot name a field. Return nil, which is what reading
-      # one has always done.
-      return nil if name.blank?
-
-      if (meth = readable_method_for(document.class, name))
-        document.public_send(meth)
-      else
-        document.attributes[document.class.database_field_name(name)]
-      end
-    end
-
-    # Resolve the given name to a method that is declared by the given class,
-    # and therefore safe to send to one of its instances.
-    #
-    # @param [ Class ] klass The document class.
-    # @param [ String ] name The name of the field.
-    #
-    # @return [ String | nil ] The method to send, or nil when the name is
-    #   not declared by the class.
-    def readable_method_for(klass, name)
-      # Fields, associations, and field aliases each define a reader of their
-      # own name. Note that associations must be resolved before aliases: a
-      # belongs_to aliases its own name to its foreign key, and reading
-      # `band` must give the document, not the id.
-      return name if klass.relations.key?(name) ||
-                     klass.fields.key?(name) ||
-                     klass.aliased_fields.key?(name)
-
-      # An association may also be named by its `store_as`, which has no
-      # reader of its own, or by its ids accessor, which does.
-      if (assoc = klass.relations[klass.aliased_associations[name]])
-        return (assoc.store_as == name) ? assoc.name.to_s : name
-      end
-
-      # Localized fields also get a _translations reader, which does not
-      # appear in the fields hash.
-      base = name.delete_suffix(Fields::TRANSLATIONS_SFX)
-      return nil if base == name
-
-      name if klass.fields[klass.database_field_name(base)]&.localized?
-    end
-  end
-end