mongo_doc 0.6.9 → 0.6.10

data/README.textile

@@ -1,6 +1,6 @@
 h1. MongoDoc
 
-Version: Hurricane (0.6.9) 2010/07/12
+Version: Hurricane (0.6.10) 2010/07/16
 
 h2. Notes
 

data/VERSION

@@ -1 +1 @@
-0.6.9
+0.6.10

data/features/references.feature

@@ -9,10 +9,20 @@ Feature: References
     And an Address document named 'office' :
       | City              |
       | New New York City |
+    And an Address document named 'old_office' :
+      | City          |
+      | New York City |
 
-  Scenario: Automatically dereferenced
+  Scenario: Automatically dereferences in references association
     When I save the document 'office'
     And 'Fry' references 'office' as 'address'
     And I save the document 'Fry'
     And the document 'Fry' is reloaded
     Then 'Fry' refers to 'office' as 'address'
+
+  Scenario: Automatically dereferences in references_many association
+    When I save the document 'old_office'
+    And 'Fry' references 'old_office' through 'previous_addresses'
+    And I save the document 'Fry'
+    And the document 'Fry' is reloaded
+    Then 'Fry' has 'previous_addresses' that include 'old_office'

data/features/step_definitions/documents.rb

@@ -44,6 +44,7 @@ class Person
 
   attr_accessor :name
   references :address
+  references_many :addresses, :as => :previous_addresses
 
   timestamps!
 end

data/features/step_definitions/field_steps.rb

@@ -9,8 +9,20 @@ When /^'(\w+)' references '(\w+)' as '(\w+)'$/ do |parent, child, field|
   parent_doc.send("#{field}=", child_doc)
 end
 
+When /^'(\w+)' references '(\w+)' through '(\w+)'$/ do |parent, child, field|
+  parent_doc = instance_variable_get("@#{parent}")
+  child_doc = instance_variable_get("@#{child}")
+  parent_doc.send("#{field.singularize}_ids") << child_doc._id
+end
+
 Then /^'(\w+)' refers to '(\w+)' as '(\w+)'$/ do |name, other, field|
   doc = instance_variable_get("@#{name}")
   other_doc = instance_variable_get("@#{other}")
   doc.send("#{field}").should == other_doc
 end
+
+Then /^'(\w+)' has '(\w+)' that include '(\w+)'$/ do |name, field, included|
+  doc = instance_variable_get("@#{name}")
+  included_doc = instance_variable_get("@#{included}")
+  doc.send("#{field}").should include(included_doc)
+end

data/lib/mongo_doc/document.rb

@@ -8,6 +8,7 @@ require 'mongo_doc/index'
 require 'mongo_doc/scope'
 require 'mongo_doc/timestamps'
 require 'mongo_doc/references'
+require 'mongo_doc/references_many'
 require 'active_model/naming'
 require 'active_model/translation'
 require 'active_model/deprecated_error_methods'
@@ -35,6 +36,7 @@ module MongoDoc
         extend Scope
         extend Timestamps
         extend References
+        extend ReferencesMany
         include ::ActiveModel::Validations
         extend ::ActiveModel::Naming
         extend Validations

data/lib/mongo_doc/references_many.rb

@@ -0,0 +1,46 @@
+module MongoDoc
+  module ReferencesMany
+    # Declare an array of references to other +Document+s.
+    #
+    # * classname:: name of +Document+ type as an +underscore+ symbol or string
+    # * options:: +:as+ specifies the name of the attribute
+    def references_many(classname, options = {})
+      klass = classname.to_s.camelize.singularize
+      objects_name = (options[:as] || klass.demodulize.downcase.pluralize).to_s
+      ids_name = "#{objects_name.singularize}_ids"
+
+      _keys << ids_name unless _keys.include?(ids_name)
+
+      module_eval(<<-RUBY, __FILE__, __LINE__)
+        def #{objects_name}=(array)           # def addresses=(array)
+          @#{objects_name} = array            #   @addresses = array
+          self.#{ids_name} = array.map(&:_id) #   self.address_ids = array.map(&:_id)
+        end                                   # end
+
+        def #{objects_name}                          # def addresses
+          @#{objects_name} ||= if #{ids_name}.empty? #   @addresses ||= if address_ids.empty?
+              []                                     #     []
+            else                                     #   else
+              "#{klass}".constantize.                #     "Address".constantize.
+                find(*#{ids_name}).entries           #       find(*address_ids).entries
+            end                                      #   end
+        end
+
+        def #{ids_name}=(array)                           # def address_ids=(array)
+          @#{objects_name} = nil                          #   @addresses = nil
+          @#{ids_name} = ReferencesMany.cast_array(array) #   @address_ids = ReferencesMany.cast_array(array)
+        end                                               # end
+
+        def #{ids_name}       # def address_ids
+          @#{ids_name} ||= [] #  @address_ids ||= []
+        end                   # end
+      RUBY
+    end
+
+    def self.cast_array(array)
+      array.nil? ? [] : array.map do |item|
+        String === item ? ::BSON::ObjectID.cast_from_string(item) : item
+      end
+    end
+  end
+end

data/lib/mongo_doc.rb

@@ -3,7 +3,7 @@ require 'active_support'
 require 'active_support/core_ext'
 
 module MongoDoc
-  VERSION = '0.6.9'
+  VERSION = '0.6.10'
 end
 
 require 'mongo_doc/connection'

data/mongo_doc.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{mongo_doc}
-  s.version = "0.6.9"
+  s.version = "0.6.10"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Les Hill"]
-  s.date = %q{2010-07-12}
+  s.date = %q{2010-07-16}
   s.description = %q{ODM for MongoDB}
   s.email = %q{leshill@gmail.com}
   s.extra_rdoc_files = [
@@ -54,7 +54,6 @@ Gem::Specification.new do |s|
      "features/step_definitions/objects.rb",
      "features/step_definitions/partial_update_steps.rb",
      "features/step_definitions/query_steps.rb",
-     "features/step_definitions/reference_steps.rb",
      "features/step_definitions/removing_documents_steps.rb",
      "features/step_definitions/scope_steps.rb",
      "features/step_definitions/string_casting_steps.rb",
@@ -104,6 +103,7 @@ Gem::Specification.new do |s|
      "lib/mongo_doc/railties/config.rb",
      "lib/mongo_doc/railties/db_prepare.task",
      "lib/mongo_doc/references.rb",
+     "lib/mongo_doc/references_many.rb",
      "lib/mongo_doc/root.rb",
      "lib/mongo_doc/scope.rb",
      "lib/mongo_doc/timestamps.rb",
@@ -165,6 +165,7 @@ Gem::Specification.new do |s|
      "spec/mongodb.yml",
      "spec/mongodb_pairs.yml",
      "spec/new_record_spec.rb",
+     "spec/references_many_spec.rb",
      "spec/references_spec.rb",
      "spec/root_spec.rb",
      "spec/scope_spec.rb",
@@ -207,6 +208,7 @@ Gem::Specification.new do |s|
      "spec/index_spec.rb",
      "spec/matchers_spec.rb",
      "spec/new_record_spec.rb",
+     "spec/references_many_spec.rb",
      "spec/references_spec.rb",
      "spec/root_spec.rb",
      "spec/scope_spec.rb",

data/spec/references_many_spec.rb

@@ -0,0 +1,108 @@
+require 'spec_helper'
+
+describe MongoDoc::ReferencesMany do
+  class Address
+    include MongoDoc::Document
+
+    attr_accessor :state
+  end
+
+  context "Simple Reference" do
+    class Person
+      include MongoDoc::Document
+
+      references_many :addresses
+    end
+
+    subject { Person.new }
+
+    context "Object accessor" do
+      it { should respond_to(:addresses) }
+      it { should respond_to(:addresses=) }
+
+      it "is not part of the persistent key set" do
+        Person._keys.should_not include('addresses')
+      end
+    end
+
+    context "Object Id accessor" do
+      it { should respond_to(:address_ids) }
+      it { should respond_to(:address_ids=) }
+
+      it "is part of the persistent key set" do
+        Person._keys.should include('address_ids')
+      end
+    end
+  end
+
+  context "Named Reference" do
+    class Person
+      include MongoDoc::Document
+
+      references_many :addresses, :as => :known_addresses
+    end
+
+    subject { Person.new }
+
+    context "Object accessor" do
+      it { should respond_to(:known_addresses) }
+      it { should respond_to(:known_addresses=) }
+
+      it "is not part of the persistent key set" do
+        Person._keys.should_not include('known_addresses')
+      end
+    end
+
+    context "Object Id accessor" do
+      it { should respond_to(:known_address_ids) }
+      it { should respond_to(:known_address_ids=) }
+
+      it "is part of the persistent key set" do
+        Person._keys.should include('known_address_ids')
+      end
+    end
+  end
+
+  describe "setting the ids" do
+    class Person
+      include MongoDoc::Document
+
+      references_many :address
+    end
+
+    let(:address) { Address.new(:_id => BSON::ObjectID.new) }
+    let(:person) { Person.new }
+
+    context "to" do
+      before do
+        person.addresses = [address]
+      end
+
+      context "nil" do
+        before do
+          person.address_ids = nil
+        end
+
+        it "sets the ids to []" do
+          person.address_ids.should == []
+        end
+
+        it "resets the objects to nil" do
+          person.addresses.should == []
+        end
+      end
+
+      it "[] resets the objects to []" do
+        person.address_ids = []
+        person.addresses.should == []
+      end
+    end
+
+    context "to strings" do
+      it "converts the strings to ids" do
+        person.address_ids = [address._id.to_s]
+        person.address_ids.should == [address._id]
+      end
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: mongo_doc
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 19
   prerelease: false
   segments: 
   - 0
   - 6
-  - 9
-  version: 0.6.9
+  - 10
+  version: 0.6.10
 platform: ruby
 authors: 
 - Les Hill
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-12 00:00:00 -04:00
+date: 2010-07-16 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -183,7 +183,6 @@ files:
 - features/step_definitions/objects.rb
 - features/step_definitions/partial_update_steps.rb
 - features/step_definitions/query_steps.rb
-- features/step_definitions/reference_steps.rb
 - features/step_definitions/removing_documents_steps.rb
 - features/step_definitions/scope_steps.rb
 - features/step_definitions/string_casting_steps.rb
@@ -233,6 +232,7 @@ files:
 - lib/mongo_doc/railties/config.rb
 - lib/mongo_doc/railties/db_prepare.task
 - lib/mongo_doc/references.rb
+- lib/mongo_doc/references_many.rb
 - lib/mongo_doc/root.rb
 - lib/mongo_doc/scope.rb
 - lib/mongo_doc/timestamps.rb
@@ -294,6 +294,7 @@ files:
 - spec/mongodb.yml
 - spec/mongodb_pairs.yml
 - spec/new_record_spec.rb
+- spec/references_many_spec.rb
 - spec/references_spec.rb
 - spec/root_spec.rb
 - spec/scope_spec.rb
@@ -364,6 +365,7 @@ test_files:
 - spec/index_spec.rb
 - spec/matchers_spec.rb
 - spec/new_record_spec.rb
+- spec/references_many_spec.rb
 - spec/references_spec.rb
 - spec/root_spec.rb
 - spec/scope_spec.rb