fcoury-mongomapper 0.2.0

data/test/test_document.rb

@@ -0,0 +1,1002 @@
+require 'test_helper'
+
+class Address
+  include MongoMapper::EmbeddedDocument
+  key :city, String
+  key :state, String
+end
+
+class DocumentTest < Test::Unit::TestCase
+  context "The Document Class" do
+    setup do
+      @document = Class.new do
+        include MongoMapper::Document
+      end
+    end
+
+    should "track its descendants" do
+      MongoMapper::Document.descendants.should include(@document)
+    end
+
+    should "find its parent model" do
+      class A < Address
+        key :new_key, String
+      end
+
+      A.parent_model.should == Address
+    end
+
+    should "inherit keys" do
+      class A < Address
+        key :new_key, String
+      end
+
+      A.keys.should include("new_key")
+      Address.keys.should_not include("new_key")
+    end
+
+    should "be able to define a key" do
+      key = @document.key(:name, String)
+      key.name.should == 'name'
+      key.type.should == String
+      key.should be_instance_of(MongoMapper::Key)
+    end
+
+    should "be able to define a key with options" do
+      key = @document.key(:name, String, :required => true)
+      key.options[:required].should be(true)
+    end
+
+    should "know what keys have been defined" do
+      @document.key(:name, String)
+      @document.key(:age, Integer)
+      @document.keys['name'].name.should == 'name'
+      @document.keys['name'].type.should == String
+      @document.keys['age'].name.should == 'age'
+      @document.keys['age'].type.should == Integer
+    end
+    
+    should "allow redefining a key" do
+      @document.key(:foo, String)
+      @document.keys['foo'].type.should == String
+      @document.key(:foo, Integer)
+      @document.keys['foo'].type.should == Integer
+    end
+
+    should "use default database by default" do
+      @document.database.should == MongoMapper.database
+    end
+
+    should "have a connection" do
+      @document.connection.should be_instance_of(XGen::Mongo::Driver::Mongo)
+    end
+
+    should "allow setting different connection without affecting the default" do
+      conn = XGen::Mongo::Driver::Mongo.new
+      @document.connection conn
+      @document.connection.should == conn
+      @document.connection.should_not == MongoMapper.connection
+    end
+
+    should "allow setting a different database without affecting the default" do
+      @document.database AlternateDatabase
+      @document.database.name.should == AlternateDatabase
+
+      another_document = Class.new do
+        include MongoMapper::Document
+      end
+      another_document.database.should == MongoMapper.database
+    end
+
+    class Item; include MongoMapper::Document; end
+    should "default collection name to class name tableized" do
+      Item.collection.should be_instance_of(XGen::Mongo::Driver::Collection)
+      Item.collection.name.should == 'items'
+    end
+
+    should "allow setting the collection name" do
+      @document.collection('foobar')
+      @document.collection.should be_instance_of(XGen::Mongo::Driver::Collection)
+      @document.collection.name.should == 'foobar'
+    end
+  end # Document class
+
+  context "Database operations" do
+    setup do
+      @document = Class.new do
+        include MongoMapper::Document
+        collection 'users'
+
+        key :fname, String
+        key :lname, String
+        key :age, Integer
+      end
+
+      @document.collection.clear
+    end
+
+    context "Using key with type Array" do
+      setup do
+        @document.key :tags, Array
+      end
+
+      should "work" do
+        doc = @document.new
+        doc.tags.should == []
+        doc.tags = %w(foo bar)
+        doc.save
+        doc.tags.should == %w(foo bar)
+        @document.find(doc.id).tags.should == %w(foo bar)
+      end
+    end
+
+    context "Using key with type Hash" do
+      setup do
+        @document.key :foo, Hash
+      end
+
+      should "work with indifferent access" do
+        doc = @document.new
+        doc.foo = {:baz => 'bar'}
+        doc.save
+
+        doc = @document.find(doc.id)
+        doc.foo[:baz].should == 'bar'
+        doc.foo['baz'].should == 'bar'
+      end
+    end
+
+    context "Saving a document with an embedded document" do
+      setup do
+        @document.class_eval do
+          key :foo, Address
+        end
+      end
+
+      should "embed embedded document" do
+        address = Address.new(:city => 'South Bend', :state => 'IN')
+        doc = @document.new(:foo => address)
+        doc.save
+        doc.foo.city.should == 'South Bend'
+        doc.foo.state.should == 'IN'
+
+        from_db = @document.find(doc.id)
+        from_db.foo.city.should == 'South Bend'
+        from_db.foo.state.should == 'IN'
+      end
+    end
+
+    context "Creating a single document" do
+      setup do
+        @doc_instance = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+      end
+
+      should "create a document in correct collection" do
+        @document.count.should == 1
+      end
+
+      should "automatically set id" do
+        @doc_instance.id.should_not be_nil
+        @doc_instance.id.size.should == 24
+      end
+
+      should "return instance of document" do
+        @doc_instance.should be_instance_of(@document)
+        @doc_instance.fname.should == 'John'
+        @doc_instance.lname.should == 'Nunemaker'
+        @doc_instance.age.should == 27
+      end
+    end
+
+    context "Creating multiple documents" do
+      setup do
+        @doc_instances = @document.create([
+          {:fname => 'John', :lname => 'Nunemaker', :age => '27'},
+          {:fname => 'Steve', :lname => 'Smith', :age => '28'},
+        ])
+      end
+
+      should "create multiple documents" do
+        @document.count.should == 2
+      end
+
+      should "return an array of doc instances" do
+        @doc_instances.map do |doc_instance|
+          doc_instance.should be_instance_of(@document)
+        end
+      end
+    end
+
+    context "Updating a document" do
+      setup do
+        doc = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc_instance = @document.update(doc.id, {:age => 40})
+      end
+
+      should "update attributes provided" do
+        @doc_instance.age.should == 40
+      end
+
+      should "not update existing attributes that were not set to update" do
+        @doc_instance.fname.should == 'John'
+        @doc_instance.lname.should == 'Nunemaker'
+      end
+
+      should "not create new document" do
+        @document.count.should == 1
+      end
+    end
+
+    should "raise error when updating single doc if not provided id and attributes" do
+      doc = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+      lambda { @document.update }.should raise_error(ArgumentError)
+      lambda { @document.update(doc.id) }.should raise_error(ArgumentError)
+      lambda { @document.update(doc.id, [1]) }.should raise_error(ArgumentError)
+    end
+
+    context "Updating multiple documents" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+
+        @doc_instances = @document.update({
+          @doc1.id => {:age => 30},
+          @doc2.id => {:age => 30},
+        })
+      end
+
+      should "not create any new documents" do
+        @document.count.should == 2
+      end
+
+      should "should return an array of doc instances" do
+        @doc_instances.map do |doc_instance|
+          doc_instance.should be_instance_of(@document)
+        end
+      end
+
+      should "update the documents" do
+        @document.find(@doc1.id).age.should == 30
+        @document.find(@doc2.id).age.should == 30
+      end
+    end
+
+    should "raise error when updating multiple documents if not a hash" do
+      lambda { @document.update([1, 2]) }.should raise_error(ArgumentError)
+    end
+
+    context "Finding documents" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+      end
+
+      should "raise document not found if nothing provided" do
+        lambda { @document.find }.should raise_error(MongoMapper::DocumentNotFound)
+      end
+
+      context "with a single id" do
+        should "work" do
+          @document.find(@doc1.id).should == @doc1
+        end
+
+        should "raise error if document not found" do
+          lambda { @document.find(1) }.should raise_error(MongoMapper::DocumentNotFound)
+        end
+      end
+
+      context "with multiple id's" do
+        should "work as arguments" do
+          @document.find(@doc1.id, @doc2.id).should == [@doc1, @doc2]
+        end
+
+        should "work as array" do
+          @document.find([@doc1.id, @doc2.id]).should == [@doc1, @doc2]
+        end
+      end
+
+      context "with :all" do
+        should "find all documents" do
+          @document.find(:all).should == [@doc1, @doc2, @doc3]
+        end
+
+        should "be able to add conditions" do
+          @document.find(:all, :conditions => {:fname => 'John'}).should == [@doc1]
+        end
+      end
+
+      context "with #all" do
+        should "find all documents based on criteria" do
+          @document.all.should == [@doc1, @doc2, @doc3]
+          @document.all(:conditions => {:lname => 'Nunemaker'}).should == [@doc1, @doc3]
+        end
+      end
+
+      context "with :first" do
+        should "find first document" do
+          @document.find(:first).should == @doc1
+        end
+      end
+
+      context "with #first" do
+        should "find first document based on criteria" do
+          @document.first.should == @doc1
+          @document.first(:conditions => {:age => 28}).should == @doc2
+        end
+      end
+
+      context "with :last" do
+        should "find last document" do
+          @document.find(:last).should == @doc3
+        end
+      end
+
+      context "with #last" do
+        should "find last document based on criteria" do
+          @document.last.should == @doc3
+          @document.last(:conditions => {:age => 28}).should == @doc2
+        end
+      end
+    end # finding documents
+
+    context "Finding document by id" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+      end
+
+      should "be able to find by id" do
+        @document.find_by_id(@doc1.id).should == @doc1
+        @document.find_by_id(@doc2.id).should == @doc2
+      end
+
+      should "return nil if document not found" do
+        @document.find_by_id(1234).should be(nil)
+      end
+    end
+
+    context "Deleting a document" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @document.delete(@doc1.id)
+      end
+
+      should "remove document from collection" do
+        @document.count.should == 1
+      end
+
+      should "not remove other documents" do
+        @document.find(@doc2.id).should_not be(nil)
+      end
+    end
+
+    context "Deleting multiple documents" do
+      should "work with multiple arguments" do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+        @document.delete(@doc1.id, @doc2.id)
+
+        @document.count.should == 1
+      end
+
+      should "work with array as argument" do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+        @document.delete([@doc1.id, @doc2.id])
+
+        @document.count.should == 1
+      end
+    end
+
+    context "Deleting all documents" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+      end
+
+      should "remove all documents when given no conditions" do
+        @document.delete_all
+        @document.count.should == 0
+      end
+
+      should "only remove matching documents when given conditions" do
+        @document.delete_all({:fname => 'John'})
+        @document.count.should == 2
+      end
+
+      should "convert the conditions to mongo criteria" do
+        @document.delete_all(:age => [26, 27])
+        @document.count.should == 1
+      end
+    end
+
+    context "Destroying a document" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @document.destroy(@doc1.id)
+      end
+
+      should "remove document from collection" do
+        @document.count.should == 1
+      end
+
+      should "not remove other documents" do
+        @document.find(@doc2.id).should_not be(nil)
+      end
+    end
+
+    context "Destroying multiple documents" do
+      should "work with multiple arguments" do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+        @document.destroy(@doc1.id, @doc2.id)
+
+        @document.count.should == 1
+      end
+
+      should "work with array as argument" do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+        @document.destroy([@doc1.id, @doc2.id])
+
+        @document.count.should == 1
+      end
+    end
+
+    context "Destroying all documents" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+      end
+
+      should "remove all documents when given no conditions" do
+        @document.destroy_all
+        @document.count.should == 0
+      end
+
+      should "only remove matching documents when given conditions" do
+        @document.destroy_all(:fname => 'John')
+        @document.count.should == 2
+        @document.destroy_all(:age => 26)
+        @document.count.should == 1
+      end
+
+      should "convert the conditions to mongo criteria" do
+        @document.destroy_all(:age => [26, 27])
+        @document.count.should == 1
+      end
+    end
+
+    context "Counting documents in collection" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+      end
+
+      should "count all with no arguments" do
+        @document.count.should == 3
+      end
+
+      should "return 0 if there are no documents in the collection" do
+        @document.delete_all
+        @document.count.should == 0
+      end
+
+      should "return 0 if the collection does not exist" do
+        klass = Class.new do
+          include MongoMapper::Document
+          collection 'foobarbazwickdoesnotexist'
+        end
+
+        klass.count.should == 0
+      end
+
+      should "return count for matching documents if conditions provided" do
+        @document.count(:age => 27).should == 1
+      end
+
+      should "convert the conditions to mongo criteria" do
+        @document.count(:age => [26, 27]).should == 2
+      end
+    end
+
+    context "Paginating" do
+      setup do
+        @doc1 = @document.create({:fname => 'John', :lname => 'Nunemaker', :age => '27'})
+        @doc2 = @document.create({:fname => 'Steve', :lname => 'Smith', :age => '28'})
+        @doc3 = @document.create({:fname => 'Steph', :lname => 'Nunemaker', :age => '26'})
+      end
+
+      should "return the total pages" do
+        result = @document.paginate(:per_page => 2, :page => 1)
+        result.total_pages.should == 2
+      end
+
+      should "return the total of records" do
+        result = @document.paginate(:per_page => 2, :page => 1)
+        result.total_entries.should == 3
+      end
+
+      should "return the items" do
+        result = @document.paginate(:per_page => 2, :page => 1)
+        result.size.should == 2
+        result.subject.should == [@doc1, @doc2]
+      end
+
+      should "accept conditions" do
+        result = @document.paginate({
+          :conditions => {:lname => 'Nunemaker'},
+          :order      => "age DESC",
+          :per_page   => 2, 
+          :page       => 1,
+        })
+        result.first.age.should == 27
+      end
+    end
+
+    context "Indexing" do
+      setup do
+        @document.collection.drop_indexes
+      end
+
+      should "allow creating index for a key" do
+        lambda {
+          @document.ensure_index :fname
+        }.should change { @document.collection.index_information.size }.by(1)
+
+        index = @document.collection.index_information['fname_1']
+        index.should_not be_nil
+        index.should include(['fname', 1])
+      end
+
+      should "allow creating unique index for a key" do
+        @document.collection.expects(:create_index).with(:fname, true)
+        @document.ensure_index :fname, :unique => true
+      end
+
+      should "allow creating index on multiple keys" do
+        lambda {
+          @document.ensure_index [[:fname, 1], [:lname, -1]]
+        }.should change { @document.collection.index_information.size }.by(1)
+
+        index = @document.collection.index_information['lname_-1_fname_1']
+        index.should_not be_nil
+        index.should include(['fname', 1])
+        index.should include(['lname', -1])
+      end
+
+      should "work with :index shortcut when defining key" do
+        lambda {
+          @document.key :father, String, :index => true
+        }.should change { @document.collection.index_information.size }.by(1)
+
+        index = @document.collection.index_information['father_1']
+        index.should_not be_nil
+        index.should include(['father', 1])
+      end
+    end
+  end # Database operations
+
+  context "An instance of a document" do
+    setup do
+      @document = Class.new do
+        include MongoMapper::Document
+
+        key :name, String
+        key :age, Integer
+      end
+      @document.collection.clear
+    end
+
+    should "have access to the class's collection" do
+      doc = @document.new
+      doc.collection.should == @document.collection
+    end
+
+    should "automatically have an _id key" do
+      @document.keys.keys.should include('_id')
+    end
+
+    should "automatically have a created_at key" do
+      @document.keys.keys.should include('created_at')
+    end
+
+    should "automatically have an updated_at key" do
+      @document.keys.keys.should include('updated_at')
+    end
+
+    should "use default values if defined for keys" do
+      @document.key :active, Boolean, :default => true
+
+      @document.new.active.should be_true
+      @document.new(:active => false).active.should be_false
+    end
+
+    context "new?" do
+      should "be true if no id" do
+        @document.new.new?.should be(true)
+      end
+
+      should "be true if has id but id not in database" do
+        @document.new('_id' => 1).new?.should be(true)
+      end
+
+      should "be false if has id and id is in database" do
+        doc = @document.create(:name => 'John Nunemaker', :age => 27)
+        doc.new?.should be(false)
+      end
+    end
+
+    context "mass assigning keys" do
+      should "update values for keys provided" do
+        doc = @document.new(:name => 'foobar', :age => 10)
+        doc.attributes = {:name => 'new value', :age => 5}
+        doc.attributes[:name].should == 'new value'
+        doc.attributes[:age].should == 5
+      end
+
+      should "not update values for keys that were not provided" do
+        doc = @document.new(:name => 'foobar', :age => 10)
+        doc.attributes = {:name => 'new value'}
+        doc.attributes[:name].should == 'new value'
+        doc.attributes[:age].should == 10
+      end
+
+      should "ignore keys that do not exist" do
+        doc = @document.new(:name => 'foobar', :age => 10)
+        doc.attributes = {:name => 'new value', :foobar => 'baz'}
+        doc.attributes[:name].should == 'new value'
+        doc.attributes[:foobar].should be(nil)
+      end
+
+      should "typecast key values" do
+        doc = @document.new(:name => 1234, :age => '21')
+        doc.name.should == '1234'
+        doc.age.should == 21
+      end
+    end
+
+    context "requesting keys" do
+      should "default to empty hash" do
+        doc = @document.new
+        doc.attributes.should == {}
+      end
+
+      should "return all keys that aren't nil" do
+        doc = @document.new(:name => 'string', :age => nil)
+        doc.attributes.should == {'name' => 'string'}
+      end
+    end
+
+    context "key shorcuts" do
+      should "be able to read key with []" do
+        doc = @document.new(:name => 'string')
+        doc[:name].should == 'string'
+      end
+
+      should "be able to write key value with []=" do
+        doc = @document.new
+        doc[:name] = 'string'
+        doc[:name].should == 'string'
+      end
+    end
+
+    context "indifferent access" do
+      should "be enabled for keys" do
+        doc = @document.new(:name => 'string')
+        doc.attributes[:name].should == 'string'
+        doc.attributes['name'].should == 'string'
+      end
+    end
+
+    context "reading an attribute" do
+      should "work for defined keys" do
+        doc = @document.new(:name => 'string')
+        doc.name.should == 'string'
+      end
+
+      should "raise no method error for undefined keys" do
+        doc = @document.new
+        lambda { doc.fart }.should raise_error(NoMethodError)
+      end
+
+      should "know if reader defined" do
+        doc = @document.new
+        doc.reader?('name').should be(true)
+        doc.reader?(:name).should be(true)
+        doc.reader?('age').should be(true)
+        doc.reader?(:age).should be(true)
+        doc.reader?('foobar').should be(false)
+        doc.reader?(:foobar).should be(false)
+      end
+
+      should "be accessible for use in the model" do
+        @document.class_eval do
+          def name_and_age
+            "#{read_attribute(:name)} (#{read_attribute(:age)})"
+          end
+        end
+
+        doc = @document.new(:name => 'John', :age => 27)
+        doc.name_and_age.should == 'John (27)'
+      end
+    end
+
+    context "reading an attribute before typcasting" do
+      should "work for defined keys" do
+        doc = @document.new(:name => 12)
+        doc.name_before_typecast.should == 12
+      end
+
+      should "raise no method error for undefined keys" do
+        doc = @document.new
+        lambda { doc.foo_before_typecast }.should raise_error(NoMethodError)
+      end
+
+      should "be accessible for use in a document" do
+        @document.class_eval do
+          def untypcasted_name
+            read_attribute_before_typecast(:name)
+          end
+        end
+
+        doc = @document.new(:name => 12)
+        doc.name.should == '12'
+        doc.untypcasted_name.should == 12
+      end
+    end
+
+    context "writing an attribute" do
+      should "work for defined keys" do
+        doc = @document.new
+        doc.name = 'John'
+        doc.name.should == 'John'
+      end
+
+      should "raise no method error for undefined keys" do
+        doc = @document.new
+        lambda { doc.fart = 'poof!' }.should raise_error(NoMethodError)
+      end
+
+      should "typecast value" do
+        doc = @document.new
+        doc.name = 1234
+        doc.name.should == '1234'
+        doc.age = '21'
+        doc.age.should == 21
+      end
+
+      should "know if writer defined" do
+        doc = @document.new
+        doc.writer?('name').should be(true)
+        doc.writer?('name=').should be(true)
+        doc.writer?(:name).should be(true)
+        doc.writer?('age').should be(true)
+        doc.writer?('age=').should be(true)
+        doc.writer?(:age).should be(true)
+        doc.writer?('foobar').should be(false)
+        doc.writer?('foobar=').should be(false)
+        doc.writer?(:foobar).should be(false)
+      end
+
+      should "be accessible for use in the model" do
+        @document.class_eval do
+          def name_and_age=(new_value)
+            new_value.match(/([^\(\s]+) \((.*)\)/)
+            write_attribute :name, $1
+            write_attribute :age, $2
+          end
+        end
+
+        doc = @document.new
+        doc.name_and_age = 'Frank (62)'
+        doc.name.should == 'Frank'
+        doc.age.should == 62
+      end
+    end # writing an attribute
+
+    context "respond_to?" do
+      setup do
+        @doc = @document.new
+      end
+
+      should "work for readers" do
+        @doc.respond_to?(:name).should be_true
+        @doc.respond_to?('name').should be_true
+      end
+
+      should "work for writers" do
+        @doc.respond_to?(:name=).should be_true
+        @doc.respond_to?('name=').should be_true
+      end
+
+      should "work for readers before typecast" do
+        @doc.respond_to?(:name_before_typecast).should be_true
+        @doc.respond_to?('name_before_typecast').should be_true
+      end
+    end
+
+    context "equality" do
+      should "be equal if id and class are the same" do
+        (@document.new('_id' => 1) == @document.new('_id' => 1)).should be(true)
+      end
+
+      should "not be equal if class same but id different" do
+        (@document.new('_id' => 1) == @document.new('_id' => 2)).should be(false)
+      end
+
+      should "not be equal if id same but class different" do
+        @another_document = Class.new do
+          include MongoMapper::Document
+        end
+
+        (@document.new('_id' => 1) == @another_document.new('_id' => 1)).should be(false)
+      end
+    end
+
+    context "Saving a new document" do
+      setup do
+        @doc = @document.new(:name => 'John Nunemaker', :age => '27')
+        @doc.save
+      end
+
+      should "insert document into the collection" do
+        @document.count.should == 1
+      end
+
+      should "assign an id for the document" do
+        @doc.id.should_not be(nil)
+        @doc.id.size.should == 24
+      end
+
+      should "save attributes" do
+        @doc.name.should == 'John Nunemaker'
+        @doc.age.should == 27
+      end
+
+      should "update attributes in the database" do
+        from_db = @document.find(@doc.id)
+        from_db.should == @doc
+        from_db.name.should == 'John Nunemaker'
+        from_db.age.should == 27
+      end
+    end
+
+    context "Saving an existing document" do
+      setup do
+        @doc = @document.create(:name => 'John Nunemaker', :age => '27')
+        @doc.name = 'John Doe'
+        @doc.age = 30
+        @doc.save
+      end
+
+      should "not insert document into collection" do
+        @document.count.should == 1
+      end
+
+      should "update attributes" do
+        @doc.name.should == 'John Doe'
+        @doc.age.should == 30
+      end
+
+      should "update attributes in the database" do
+        from_db = @document.find(@doc.id)
+        from_db.name.should == 'John Doe'
+        from_db.age.should == 30
+      end
+    end
+
+    context "Calling update attributes on a new document" do
+      setup do
+        @doc = @document.new(:name => 'John Nunemaker', :age => '27')
+        @doc.update_attributes(:name => 'John Doe', :age => 30)
+      end
+
+      should "insert document into the collection" do
+        @document.count.should == 1
+      end
+
+      should "assign an id for the document" do
+        @doc.id.should_not be(nil)
+        @doc.id.size.should == 24
+      end
+
+      should "save attributes" do
+        @doc.name.should == 'John Doe'
+        @doc.age.should == 30
+      end
+
+      should "update attributes in the database" do
+        from_db = @document.find(@doc.id)
+        from_db.should == @doc
+        from_db.name.should == 'John Doe'
+        from_db.age.should == 30
+      end
+    end
+
+    context "Updating an existing document using update attributes" do
+      setup do
+        @doc = @document.create(:name => 'John Nunemaker', :age => '27')
+        @doc.update_attributes(:name => 'John Doe', :age => 30)
+      end
+
+      should "not insert document into collection" do
+        @document.count.should == 1
+      end
+
+      should "update attributes" do
+        @doc.name.should == 'John Doe'
+        @doc.age.should == 30
+      end
+
+      should "update attributes in the database" do
+        from_db = @document.find(@doc.id)
+        from_db.name.should == 'John Doe'
+        from_db.age.should == 30
+      end
+    end
+
+    context "Destroying a document that exists" do
+      setup do
+        @doc = @document.create(:name => 'John Nunemaker', :age => '27')
+        @doc.destroy
+      end
+
+      should "remove the document from the collection" do
+        @document.count.should == 0
+      end
+
+      should "raise error if assignment is attempted" do
+        lambda { @doc.name = 'Foo' }.should raise_error(TypeError)
+      end
+    end
+
+    context "Destroying a document that is a new" do
+      setup do
+        setup do
+          @doc = @document.new(:name => 'John Nunemaker', :age => '27')
+          @doc.destroy
+        end
+
+        should "not affect collection count" do
+          @document.collection.count.should == 0
+        end
+
+        should "raise error if assignment is attempted" do
+          lambda { @doc.name = 'Foo' }.should raise_error(TypeError)
+        end
+      end
+    end
+
+    context "timestamping" do
+      should "set created_at and updated_at on create" do
+        doc = @document.new(:name => 'John Nunemaker', :age => 27)
+        doc.created_at.should be(nil)
+        doc.updated_at.should be(nil)
+        doc.save
+        doc.created_at.should_not be(nil)
+        doc.updated_at.should_not be(nil)
+      end
+
+      should "set updated_at on update but leave created_at alone" do
+        doc = @document.create(:name => 'John Nunemaker', :age => 27)
+        old_created_at = doc.created_at
+        old_updated_at = doc.updated_at
+        doc.name = 'John Doe'
+        doc.save
+        doc.created_at.should == old_created_at
+        doc.updated_at.should_not == old_updated_at
+      end
+    end
+  end # instance of a document
+end # DocumentTest