mongoid-rails2 1.9.3

data/MIT_LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Durran Jordan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,49 @@
+= Overview
+
+== About Mongoid
+
+Mongoid is an ODM (Object-Document-Mapper) framework for MongoDB in Ruby.
+
+== Project Tracking
+
+* {Mongoid on Pivotal Tracker}[http://www.pivotaltracker.com/projects/27482]
+* {Mongoid Google Group}[http://groups.google.com/group/mongoid]
+* {Mongoid on CI Joe}[http://ci.mongoid.org/]
+* {Mongoid Website and Documentation}[http://mongoid.org]
+
+== Compatibility
+
+Mongoid is developed against Ruby 1.8.6, 1.8.7, 1.9.1, 1.9.2
+
+= Documentation
+
+Please see the new Mongoid website for up-to-date documentation:
+{mongoid.org}[http://mongoid.org]
+
+= License
+
+Copyright (c) 2009 Durran Jordan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+= Credits
+
+Durran Jordan: durran at gmail dot com

data/lib/mongoid/associations/belongs_to_related.rb

@@ -0,0 +1,58 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Associations #:nodoc:
+    # Represents a relational association to a "parent" object.
+    class BelongsToRelated < Proxy
+
+      # Initializing a related association only requires looking up the object
+      # by its id.
+      #
+      # Options:
+      #
+      # document: The +Document+ that contains the relationship.
+      # options: The association +Options+.
+      def initialize(document, foreign_key, options, target = nil)
+        @options = options
+        @target = target || options.klass.find(foreign_key)
+        extends(options)
+      end
+
+      class << self
+        # Instantiate a new +BelongsToRelated+ or return nil if the foreign key is
+        # nil. It is preferrable to use this method over the traditional call
+        # to new.
+        #
+        # Options:
+        #
+        # document: The +Document+ that contains the relationship.
+        # options: The association +Options+.
+        def instantiate(document, options, target = nil)
+          foreign_key = document.send(options.foreign_key)
+          foreign_key.blank? ? nil : new(document, foreign_key, options, target)
+        end
+
+        # Returns the macro used to create the association.
+        def macro
+          :belongs_to_related
+        end
+
+        # Perform an update of the relationship of the parent and child. This
+        # will assimilate the child +Document+ into the parent's object graph.
+        #
+        # Options:
+        #
+        # target: The target(parent) object
+        # document: The +Document+ to update.
+        # options: The association +Options+
+        #
+        # Example:
+        #
+        # <tt>BelongsToRelated.update(person, game, options)</tt>
+        def update(target, document, options)
+          document.send("#{options.foreign_key}=", target ? target.id : nil)
+          instantiate(document, options, target)
+        end
+      end
+    end
+  end
+end

data/lib/mongoid/associations/embedded_in.rb

@@ -0,0 +1,72 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Associations #:nodoc:
+    # Represents an association that is embedded within another document in the
+    # database, either as one or many.
+    class EmbeddedIn < Proxy
+
+      # Creates the new association by setting the internal
+      # target as the passed in Document. This should be the
+      # parent.
+      #
+      # All method calls on this object will then be delegated
+      # to the internal document itself.
+      #
+      # Options:
+      #
+      # target: The parent +Document+
+      # options: The association options
+      def initialize(target, options)
+        @target, @options = target, options
+        extends(options)
+      end
+
+      # Returns the parent document. The id param is present for
+      # compatibility with rails, however this could be overwritten
+      # in the future.
+      def find(id)
+        @target
+      end
+
+      class << self
+        # Creates the new association by setting the internal
+        # document as the passed in Document. This should be the
+        # parent.
+        #
+        # Options:
+        #
+        # document: The parent +Document+
+        # options: The association options
+        def instantiate(document, options)
+          target = document._parent
+          target.nil? ? nil : new(target, options)
+        end
+
+        # Returns the macro used to create the association.
+        def macro
+          :embedded_in
+        end
+
+        # Perform an update of the relationship of the parent and child. This
+        # is initialized by setting a parent object as the association on the
+        # +Document+. Will properly set an embeds_one or an embeds_many.
+        #
+        # Returns:
+        #
+        # A new +EmbeddedIn+ association proxy.
+        def update(target, child, options)
+          child.parentize(target, determine_name(target, options))
+          child.notify
+          instantiate(child, options)
+        end
+
+        protected
+        def determine_name(target, options)
+          inverse = options.inverse_of
+          return inverse unless inverse.is_a?(Array)
+          inverse.detect { |name| target.respond_to?(name) }
+        end
+      end
+    end
+  end
+end

data/lib/mongoid/associations/embeds_many.rb

@@ -0,0 +1,254 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Associations #:nodoc:
+    # Represents embedding many documents within a parent document, which will
+    # be an array as the underlying storage mechanism.
+    class EmbedsMany < Proxy
+
+      attr_accessor :association_name, :klass
+
+      # Appends the object to the +Array+, setting its parent in
+      # the process.
+      def <<(*documents)
+        documents.flatten.each do |doc|
+          doc.parentize(@parent, @association_name)
+          @target << doc
+          doc._index = @target.size - 1
+          doc.notify
+        end
+      end
+
+      alias :concat :<<
+      alias :push :<<
+
+      # Builds a new Document and adds it to the association collection. The
+      # document created will be of the same class as the others in the
+      # association, and the attributes will be passed into the constructor.
+      #
+      # Returns:
+      #
+      # The newly created Document.
+      def build(attrs = {}, type = nil)
+        document = type ? type.instantiate : @klass.instantiate
+        document.parentize(@parent, @association_name)
+        document.write_attributes(attrs)
+        @target << document
+        document._index = @target.size - 1
+        document
+      end
+
+      # Clears the association, and notifies the parents of the removal.
+      def clear
+        unless @target.empty?
+          document = @target.first
+          document.notify_observers(document, true)
+          @target.clear
+        end
+      end
+
+      # Creates a new Document and adds it to the association collection. The
+      # document created will be of the same class as the others in the
+      # association, and the attributes will be passed into the constructor and
+      # the new object will then be saved.
+      #
+      # Returns:
+      #
+      # The newly created Document.
+      def create(attrs = {}, type = nil)
+        document = build(attrs, type)
+        document.save; document
+      end
+
+      # Creates a new Document and adds it to the association collection. The
+      # document created will be of the same class as the others in the
+      # association, and the attributes will be passed into the constructor and
+      # the new object will then be saved. If validation fails an error will
+      # get raised.
+      #
+      # Returns:
+      #
+      # The newly created Document.
+      def create!(attrs = {}, type = nil)
+        document = create(attrs, type)
+        errors = document.errors
+        raise Errors::Validations.new(errors) unless errors.empty?
+        document
+      end
+
+      # Delete all the documents in the association without running callbacks.
+      #
+      # Example:
+      #
+      # <tt>addresses.delete_all</tt>
+      #
+      # Returns:
+      #
+      # The number of documents deleted.
+      def delete_all(conditions = {})
+        remove(:delete, conditions)
+      end
+
+      # Delete all the documents in the association and run destroy callbacks.
+      #
+      # Example:
+      #
+      # <tt>addresses.destroy_all</tt>
+      #
+      # Returns:
+      #
+      # The number of documents destroyed.
+      def destroy_all(conditions = {})
+        remove(:destroy, conditions)
+      end
+
+      # Finds a document in this association.
+      #
+      # If :all is passed, returns all the documents
+      #
+      # If an id is passed, will return the document for that id.
+      #
+      # Returns:
+      #
+      # Array or single Document.
+      def find(param)
+        return @target if param == :all
+        return detect { |document| document.id == param }
+      end
+
+      # Creates the new association by finding the attributes in
+      # the parent document with its name, and instantiating a
+      # new document for each one found. These will then be put in an
+      # internal array.
+      #
+      # This then delegated all methods to the array class since this is
+      # essentially a proxy to an array itself.
+      #
+      # Options:
+      #
+      # parent: The parent document to the association.
+      # options: The association options.
+      def initialize(parent, options, target_array = nil)
+        @parent, @association_name = parent, options.name
+        @klass, @options = options.klass, options
+        if target_array
+          build_children_from_target_array(target_array)
+        else
+          build_children_from_attributes(parent.raw_attributes[@association_name])
+        end
+        extends(options)
+      end
+
+
+
+      # If the target array does not respond to the supplied method then try to
+      # find a named scope or criteria on the class and send the call there.
+      #
+      # If the method exists on the array, use the default proxy behavior.
+      def method_missing(name, *args, &block)
+        unless @target.respond_to?(name)
+          object = @klass.send(name, *args)
+          object.documents = @target
+          return object
+        end
+        super
+      end
+
+      # Used for setting associations via a nested attributes setter from the
+      # parent +Document+.
+      #
+      # Options:
+      #
+      # attributes: A +Hash+ of integer keys and +Hash+ values.
+      #
+      # Returns:
+      #
+      # The newly build target Document.
+      def nested_build(attributes)
+        attributes.values.each do |attrs|
+          build(attrs)
+        end
+      end
+
+      # Paginate the association. Will create a new criteria, set the documents
+      # on it and execute in an enumerable context.
+      #
+      # Options:
+      #
+      # options: A +Hash+ of pagination options.
+      #
+      # Returns:
+      #
+      # A +WillPaginate::Collection+.
+      def paginate(options)
+        criteria = Mongoid::Criteria.translate(@klass, options)
+        criteria.documents = @target
+        criteria.paginate(options)
+      end
+
+      protected
+      # Initializes each of the attributes in the hash.
+      def build_children_from_attributes(attributes)
+        @target = []
+        if attributes
+          attributes.each_with_index do |attrs, index|
+            klass = attrs.klass
+            child = klass ? klass.instantiate(attrs) : @klass.instantiate(attrs)
+            child.parentize(@parent, @association_name)
+            child._index = index
+            @target << child
+          end
+        end
+      end
+
+      # Initializes the target array from an existing array of documents.
+      def build_children_from_target_array(target_array)
+        @target = target_array
+        @target.each_with_index do |child, index|
+          child._index = index
+        end
+      end
+
+      # Removes documents based on a method.
+      def remove(method, conditions)
+        criteria = @klass.find(conditions || {})
+        criteria.documents = @target
+        count = criteria.size
+        criteria.each do |doc|
+          @target.delete(doc); doc.send(method)
+        end; count
+      end
+
+      class << self
+
+        # Preferred method of creating a new +EmbedsMany+ association. It will
+        # delegate to new.
+        #
+        # Options:
+        #
+        # document: The parent +Document+
+        # options: The association options
+        def instantiate(document, options, target_array = nil)
+          new(document, options, target_array)
+        end
+
+        # Returns the macro used to create the association.
+        def macro
+          :embeds_many
+        end
+
+        # Perform an update of the relationship of the parent and child. This
+        # is initialized by setting the has_many to the supplied +Enumerable+
+        # and setting up the parentization.
+        def update(children, parent, options)
+          parent.raw_attributes.delete(options.name)
+          children.assimilate(parent, options)
+          if children && children.first.is_a?(Mongoid::Document)
+            instantiate(parent, options, children)
+          else
+            instantiate(parent, options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mongoid/associations/embeds_one.rb

@@ -0,0 +1,96 @@
+# encoding: utf-8
+module Mongoid #:nodoc:
+  module Associations #:nodoc:
+    # Represents an association that is embedded in a parent document as a
+    # one-to-one relationship.
+    class EmbedsOne < Proxy
+
+      # Build a new object for the association.
+      def build(attrs = {}, type = nil)
+        @target = attrs.assimilate(@parent, @options, type); self
+      end
+
+      # Creates the new association by finding the attributes in
+      # the parent document with its name, and instantiating a
+      # new document for it.
+      #
+      # All method calls on this object will then be delegated
+      # to the internal document itself.
+      #
+      # Options:
+      #
+      # document: The parent +Document+
+      # attributes: The attributes of the target object.
+      # options: The association options.
+      #
+      # Returns:
+      #
+      # A new +HashOne+ association proxy.
+      def initialize(document, attrs, options)
+        @parent, @options  = document, options
+        @target = attrs.assimilate(@parent, @options, attrs.klass)
+        extends(options)
+      end
+
+      # Used for setting the association via a nested attributes setter on the
+      # parent +Document+. Called when using accepts_nested_attributes_for.
+      #
+      # Options:
+      #
+      # attributes: The attributes for the new association
+      #
+      # Returns:
+      #
+      # A new target document.
+      def nested_build(attributes)
+        build(attributes)
+      end
+
+      class << self
+        # Preferred method of instantiating a new +EmbedsOne+, since nil values
+        # will be handled properly.
+        #
+        # Options:
+        #
+        # document: The parent +Document+
+        # options: The association options.
+        #
+        # Returns:
+        #
+        # A new +EmbedsOne+ association proxy.
+        def instantiate(document, options)
+          attributes = document.raw_attributes[options.name]
+          return nil if attributes.blank?
+          new(document, attributes, options)
+        end
+
+        # Returns the macro used to create the association.
+        def macro
+          :embeds_one
+        end
+
+        # Perform an update of the relationship of the parent and child. This
+        # will assimilate the child +Document+ into the parent's object graph.
+        #
+        # Options:
+        #
+        # child: The child +Document+ or +Hash+.
+        # parent: The parent +Document+ to update.
+        # options: The association +Options+
+        #
+        # Example:
+        #
+        # <tt>EmbedsOne.update({:first_name => "Hank"}, person, options)</tt>
+        #
+        # Returns:
+        #
+        # A new +EmbedsOne+ association proxy.
+        def update(child, parent, options)
+          child.assimilate(parent, options)
+          instantiate(parent, options)
+        end
+      end
+
+    end
+  end
+end