mongoid 2.4.10 → 3.0.0

data/lib/mongoid/extensions/float.rb

@@ -0,0 +1,56 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Float
+
+      # Convert the float into a time.
+      #
+      # @example Convert the float into a time.
+      #   1335532685.117847.__mongoize_time__
+      #
+      # @return [ Time ] The float as a time.
+      #
+      # @since 3.0.0
+      def __mongoize_time__
+        ::Time.at(self)
+      end
+
+      # Is the float a number?
+      #
+      # @example Is the object a number?.
+      #   object.numeric?
+      #
+      # @return [ true ] Always true.
+      #
+      # @since 3.0.0
+      def numeric?
+        true
+      end
+
+      module ClassMethods
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Float.mongoize("123.11")
+        #
+        # @param [ Object ] object The object to mongoize.
+        #
+        # @return [ String ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          unless object.blank?
+            __numeric__(object) rescue 0.0
+          else
+            nil
+          end
+        end
+      end
+    end
+  end
+end
+
+::Float.__send__(:include, Mongoid::Extensions::Float)
+::Float.__send__(:extend, Mongoid::Extensions::Float::ClassMethods)

data/lib/mongoid/extensions/hash.rb

@@ -0,0 +1,123 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Hash
+
+      # Evolves each value in the hash to an object id if it is convertable.
+      #
+      # @example Convert the hash values.
+      #   { field: id }.__evolve_object_id__
+      #
+      # @return [ Hash ] The converted hash.
+      #
+      # @since 3.0.0
+      def __evolve_object_id__
+        update_values(&:__evolve_object_id__)
+      end
+
+      # Mongoizes each value in the hash to an object id if it is convertable.
+      #
+      # @example Convert the hash values.
+      #   { field: id }.__mongoize_object_id__
+      #
+      # @return [ Hash ] The converted hash.
+      #
+      # @since 3.0.0
+      def __mongoize_object_id__
+        update_values(&:__mongoize_object_id__)
+      end
+
+      # Consolidate the key/values in the hash under an atomic $set.
+      #
+      # @example Consolidate the hash.
+      #   { name: "Placebo" }.__consolidate__
+      #
+      # @return [ Hash ] A new consolidated hash.
+      #
+      # @since 3.0.0
+      def __consolidate__
+        consolidated = {}
+        each_pair do |key, value|
+          if key =~ /\$/
+            (consolidated[key] ||= {}).merge!(value)
+          else
+            (consolidated["$set"] ||= {}).merge!(key => value)
+          end
+        end
+        consolidated
+      end
+
+      # Get the id attribute from this hash, whether it's prefixed with an
+      # underscore or is a symbol.
+      #
+      # @example Extract the id.
+      #   { :_id => 1 }.extract_id
+      #
+      # @return [ Object ] The value of the id.
+      #
+      # @since 2.3.2
+      def extract_id
+        self["_id"] || self["id"] || self[:id] || self[:_id]
+      end
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   object.mongoize
+      #
+      # @return [ Hash ] The object.
+      #
+      # @since 3.0.0
+      def mongoize
+        ::Hash.mongoize(self)
+      end
+
+      # Can the size of this object change?
+      #
+      # @example Is the hash resizable?
+      #   {}.resizable?
+      #
+      # @return [ true ] true.
+      #
+      # @since 3.0.0
+      def resizable?
+        true
+      end
+
+      module ClassMethods
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Hash.mongoize([ 1, 2, 3 ])
+        #
+        # @param [ Object ] object The object to mongoize.
+        #
+        # @return [ Hash ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          return if object.nil?
+          evolve(object).update_values { |value| value.mongoize }
+        end
+
+        # Can the size of this object change?
+        #
+        # @example Is the hash resizable?
+        #   {}.resizable?
+        #
+        # @return [ true ] true.
+        #
+        # @since 3.0.0
+        def resizable?
+          true
+        end
+      end
+    end
+  end
+end
+
+::Hash.__send__(:include, Mongoid::Extensions::Hash)
+::Hash.__send__(:extend, Mongoid::Extensions::Hash::ClassMethods)

data/lib/mongoid/extensions/integer.rb

@@ -0,0 +1,66 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Integer
+
+      # Returns the integer as a time.
+      #
+      # @example Convert the integer to a time.
+      #   1335532685.__mongoize_time__
+      #
+      # @return [ Time ] The converted time.
+      #
+      # @since 3.0.0
+      def __mongoize_time__
+        ::Time.at(self)
+      end
+
+      # Is the integer a number?
+      #
+      # @example Is the object a number?.
+      #   object.numeric?
+      #
+      # @return [ true ] Always true.
+      #
+      # @since 3.0.0
+      def numeric?
+        true
+      end
+
+      # Is the object not to be converted to bson on criteria creation?
+      #
+      # @example Is the object unconvertable?
+      #   object.unconvertable_to_bson?
+      #
+      # @return [ true ] If the object is unconvertable.
+      #
+      # @since 2.2.1
+      def unconvertable_to_bson?
+        true
+      end
+
+      module ClassMethods
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   BigDecimal.mongoize("123.11")
+        #
+        # @return [ String ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          unless object.blank?
+            __numeric__(object).to_i rescue 0
+          else
+            nil
+          end
+        end
+      end
+    end
+  end
+end
+
+::Integer.__send__(:include, Mongoid::Extensions::Integer)
+::Integer.__send__(:extend, Mongoid::Extensions::Integer::ClassMethods)

data/lib/mongoid/extensions/module.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Module
+
+      # Redefine the method. Will undef the method if it exists or simply
+      # just define it.
+      #
+      # @example Redefine the method.
+      #   Object.re_define_method("exists?") do
+      #     self
+      #   end
+      #
+      # @param [ String, Symbol ] name The name of the method.
+      # @param [ Proc ] block The method body.
+      #
+      # @return [ Method ] The new method.
+      #
+      # @since 3.0.0
+      def re_define_method(name, &block)
+        undef_method(name) if method_defined?(name)
+        define_method(name, &block)
+      end
+    end
+  end
+end
+
+::Module.__send__(:include, Mongoid::Extensions::Module)

data/lib/mongoid/extensions/nil_class.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module NilClass
+
+      # Get the name of a nil collection.
+      #
+      # @example Get the nil name.
+      #   nil.collectionize
+      #
+      # @return [ String ] A blank string.
+      #
+      # @since 1.0.0
+      def collectionize
+        to_s.collectionize
+      end
+    end
+  end
+end
+
+::NilClass.__send__(:include, Mongoid::Extensions::NilClass)

data/lib/mongoid/extensions/object.rb

@@ -0,0 +1,238 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Object
+
+      # Evolve a plain object into an object id.
+      #
+      # @example Evolve the object.
+      #   object.__evolve_object_id__
+      #
+      # @return [ Object ] self.
+      #
+      # @since 3.0.0
+      def __evolve_object_id__
+        self
+      end
+      alias :__mongoize_object_id__ :__evolve_object_id__
+
+      # Convert the object to args for a find query.
+      #
+      # @example Convert the object to args.
+      #   object.__find_args__
+      #
+      # @return [ Object ] self.
+      #
+      # @since 3.0.0
+      def __find_args__
+        self
+      end
+
+      # Mongoize a plain object into a time.
+      #
+      # @example Mongoize the object.
+      #   object.__mongoize_time__
+      #
+      # @return [ Object ] self.
+      #
+      # @since 3.0.0
+      def __mongoize_time__
+        self
+      end
+
+      # Get the value of the object as a mongo friendy sort value.
+      #
+      # @example Get the object as sort criteria.
+      #   object.__sortable__
+      #
+      # @return [ Object ] self.
+      #
+      # @since 3.0.0
+      def __sortable__
+        self
+      end
+
+      # Do or do not, there is no try. -- Yoda.
+      #
+      # @example Do or do not.
+      #   object.do_or_do_not(:use, "The Force")
+      #
+      # @param [ String, Symbol ] name The method name.
+      # @param [ Array ] *args The arguments.
+      #
+      # @return [ Object, nil ] The result of the method call or nil if the
+      #   method does not exist.
+      #
+      # @since 2.0.0.rc.1
+      def do_or_do_not(name, *args)
+        send(name, *args) if name && respond_to?(name)
+      end
+
+      # Get the value for an instance variable or nil if it doesn't exist.
+      #
+      # @example Get the value for an instance var.
+      #   document.ivar("person")
+      #
+      # @param [ String ] name The name of the variable.
+      #
+      # @return [ Object, nil ] The value or nil.
+      #
+      # @since 2.0.0.rc.1
+      def ivar(name)
+        if instance_variable_defined?("@#{name}")
+          return instance_variable_get("@#{name}")
+        else
+          false
+        end
+      end
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   object.mongoize
+      #
+      # @return [ Object ] The object.
+      #
+      # @since 3.0.0
+      def mongoize
+        self
+      end
+
+      # Is the object multi args.
+      #
+      # @example Is the object multi args?
+      #   object.multi_arged?
+      #
+      # @return [ false ] false.
+      #
+      # @since 3.0.0
+      def multi_arged?
+        false
+      end
+
+      # Is the object a number?
+      #
+      # @example Is the object a number?.
+      #   object.numeric?
+      #
+      # @return [ false ] Always false.
+      #
+      # @since 3.0.0
+      def numeric?
+        false
+      end
+
+      # Remove the instance variable for the provided name.
+      #
+      # @example Remove the instance variable
+      #   document.remove_ivar("person")
+      #
+      # @param [ String ] name The name of the variable.
+      #
+      # @return [ true, false ] If the variable was defined.
+      #
+      # @since 2.1.0
+      def remove_ivar(name)
+        if instance_variable_defined?("@#{name}")
+          return remove_instance_variable("@#{name}")
+        else
+          false
+        end
+      end
+
+      # Is the object's size changable? Only returns true for arrays and hashes
+      # currently.
+      #
+      # @example Is the object resizable?
+      #   object.resizable?
+      #
+      # @return [ false ] false.
+      #
+      # @since 3.0.0
+      def resizable?
+        false
+      end
+
+      # Get the substitutable version of an object.
+      #
+      # @example Get the substitutable.
+      #   object.substitutable
+      #
+      # @return [ Object ] self.
+      #
+      # @since 2.0.0
+      def substitutable
+        self
+      end
+
+      # You must unlearn what you have learned. -- Yoda
+      #
+      # @example You must perform this execution.
+      #   object.you_must(:use, "The Force")
+      #
+      # @param [ String, Symbol ] name The method name.
+      # @param [ Array ] *args The arguments.
+      #
+      # @return [ Object, nil ] The result of the method call or nil if the
+      #   method does not exist. Nil if the object is frozen.
+      #
+      # @since 2.2.1
+      def you_must(name, *args)
+        frozen? ? nil : do_or_do_not(name, *args)
+      end
+
+      module ClassMethods
+
+        # Convert the provided object to a foreign key, given the metadata key
+        # contstraint.
+        #
+        # @example Convert the object to a fk.
+        #   Object.__mongoize_fk__(constraint, object)
+        #
+        # @param [ Constraint ] constraint The constraint.
+        # @param [ Object ] object The object to convert.
+        #
+        # @return [ Object ] The converted object.
+        #
+        # @since 3.0.0
+        def __mongoize_fk__(constraint, object)
+          return nil if !object || object == ""
+          constraint.convert(object)
+        end
+
+        # Convert the object from it's mongo friendly ruby type to this type.
+        #
+        # @example Demongoize the object.
+        #   Object.demongoize(object)
+        #
+        # @param [ Object ] object The object to demongoize.
+        #
+        # @return [ Object ] The object.
+        #
+        # @since 3.0.0
+        def demongoize(object)
+          object
+        end
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Object.mongoize("123.11")
+        #
+        # @param [ Object ] object The object to mongoize.
+        #
+        # @return [ Object ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          object.mongoize
+        end
+      end
+    end
+  end
+end
+
+::Object.__send__(:include, Mongoid::Extensions::Object)
+::Object.__send__(:extend, Mongoid::Extensions::Object::ClassMethods)

data/lib/mongoid/extensions/object_id.rb

@@ -0,0 +1,54 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module ObjectId
+
+      # Evolve the object id.
+      #
+      # @example Evolve the object id.
+      #   object_id.__evolve_object_id__
+      #
+      # @return [ Moped::BSON::ObjectId ] self.
+      #
+      # @since 3.0.0
+      def __evolve_object_id__
+        self
+      end
+      alias :__mongoize_object_id__ :__evolve_object_id__
+
+      module ClassMethods
+
+        # Evolve the object into a mongo-friendly value to query with.
+        #
+        # @example Evolve the object.
+        #   ObjectId.evolve(id)
+        #
+        # @param [ Object ] object The object to evolve.
+        #
+        # @return [ Moped::BSON::ObjectId ] The object id.
+        #
+        # @since 3.0.0
+        def evolve(object)
+          object.__evolve_object_id__
+        end
+
+        # Convert the object into a mongo-friendly value to store.
+        #
+        # @example Convert the object.
+        #   ObjectId.mongoize(id)
+        #
+        # @param [ Object ] object The object to convert.
+        #
+        # @return [ Moped::BSON::ObjectId ] The object id.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          object.__mongoize_object_id__
+        end
+      end
+    end
+  end
+end
+
+Moped::BSON::ObjectId.__send__(:include, Mongoid::Extensions::ObjectId)
+Moped::BSON::ObjectId.__send__(:extend, Mongoid::Extensions::ObjectId::ClassMethods)

data/lib/mongoid/extensions/range.rb

@@ -0,0 +1,79 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Range
+
+      # Get the range as arguments for a find.
+      #
+      # @example Get the range as find args.
+      #   range.__find_args__
+      #
+      # @return [ Array ] The range as an array.
+      #
+      # @since 3.0.0
+      def __find_args__
+        to_a
+      end
+
+      # Turn the object from the ruby type we deal with to a Mongo friendly
+      # type.
+      #
+      # @example Mongoize the object.
+      #   range.mongoize
+      #
+      # @return [ Hash ] The object mongoized.
+      #
+      # @since 3.0.0
+      def mongoize
+        ::Range.mongoize(self)
+      end
+
+      # Is this a resizable object.
+      #
+      # @example Is this resizable?
+      #   range.resizable?
+      #
+      # @return [ true ] True.
+      #
+      # @since 3.0.0
+      def resizable?
+        true
+      end
+
+      module ClassMethods
+
+        # Convert the object from it's mongo friendly ruby type to this type.
+        #
+        # @example Demongoize the object.
+        #   Range.demongoize({ "min" => 1, "max" => 5 })
+        #
+        # @param [ Hash ] object The object to demongoize.
+        #
+        # @return [ Range ] The range.
+        #
+        # @since 3.0.0
+        def demongoize(object)
+          object.nil? ? nil : ::Range.new(object["min"], object["max"])
+        end
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Range.mongoize(1..3)
+        #
+        # @param [ Range ] object The object to mongoize.
+        #
+        # @return [ Hash ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          object.nil? ? nil : { "min" => object.first, "max" => object.last }
+        end
+      end
+    end
+  end
+end
+
+::Range.__send__(:include, Mongoid::Extensions::Range)
+::Range.__send__(:extend, Mongoid::Extensions::Range::ClassMethods)

data/lib/mongoid/extensions/regexp.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+module Mongoid
+  module Extensions
+    module Regexp
+
+      module ClassMethods
+
+        # Turn the object from the ruby type we deal with to a Mongo friendly
+        # type.
+        #
+        # @example Mongoize the object.
+        #   Regexp.mongoize(/^[abc]/)
+        #
+        # @param [ Regexp, String ] object The object to mongoize.
+        #
+        # @return [ Regexp ] The object mongoized.
+        #
+        # @since 3.0.0
+        def mongoize(object)
+          ::Regexp.new(object)
+        end
+      end
+    end
+  end
+end
+
+::Regexp.__send__(:extend, Mongoid::Extensions::Regexp::ClassMethods)