mark_mapper 0.0.1

data/spec/functional/protected_spec.rb

@@ -0,0 +1,199 @@
+require 'spec_helper'
+
+describe 'A document with protected attributes' do
+  before do
+    @doc_class = Doc do
+      key :name, String
+      key :admin, Boolean, :default => false
+
+      attr_protected :admin
+    end
+
+    @doc = @doc_class.create(:name => 'Steve Sloan')
+  end
+
+  it "should have protected attributes class method" do
+    @doc_class.protected_attributes.should == [:admin].to_set
+  end
+
+  it "should default protected attributes to nil" do
+    Doc().protected_attributes.should be_nil
+  end
+
+  it "should have protected attributes instance method" do
+    @doc.protected_attributes.should equal(@doc_class.protected_attributes)
+  end
+
+  it "should raise error if there are accessible attributes" do
+    doc = Doc('Post')
+    doc.attr_accessible :name
+    lambda { doc.attr_protected :admin }.
+      should raise_error(/Declare either attr_protected or attr_accessible for Post/)
+  end
+
+  it "should know if using protected attributes" do
+    @doc_class.protected_attributes?.should be(true)
+    Doc().protected_attributes?.should be(false)
+  end
+
+  it "should work with :protected shortcut when defining key" do
+    Doc() do
+      key :user_id, ObjectId, :protected => true
+    end.protected_attributes.should == [:user_id].to_set
+  end
+
+  it "should assign protected attribute through accessor" do
+    @doc.admin = true
+    @doc.admin.should be_truthy
+  end
+
+  it "should ignore protected attribute on #initialize" do
+    doc = @doc_class.new(:name => 'John', :admin => true)
+    doc.admin.should be_falsey
+    doc.name.should == 'John'
+  end
+
+  it "should not ignore protected attributes on #initialize from the database" do
+    doc = @doc_class.new(:name => 'John')
+    doc.admin = true
+    doc.save!
+
+    doc = @doc_class.first(:name => 'John')
+    doc.admin.should be_truthy
+    doc.name.should == 'John'
+  end
+
+  it "should not ignore protected attributes on #reload" do
+    doc = @doc_class.new(:name => 'John')
+    doc.admin = true
+    doc.save!
+
+    doc.reload
+    doc.admin.should be_truthy
+    doc.name.should == 'John'
+  end
+
+  it "should ignore protected attribute on #update_attribute" do
+    @doc.update_attribute('admin', true)
+    @doc.admin.should be_truthy
+  end
+
+  it "should ignore protected attribute on #update_attributes" do
+    @doc.update_attributes(:name => 'Ren Hoek', :admin => true)
+    @doc.name.should == 'Ren Hoek'
+    @doc.admin.should be_falsey
+  end
+
+  it "should ignore protected attribute on #update_attributes!" do
+    @doc.update_attributes!(:name => 'Stimpson J. Cat', :admin => true)
+    @doc.name.should == 'Stimpson J. Cat'
+    @doc.admin.should be_falsey
+  end
+
+  it "should ignore protecteds attribute on #attributes=" do
+    @doc.attributes = {:name => 'Stimpson J. Cat', :admin => true}
+    @doc.name.should == 'Stimpson J. Cat'
+    @doc.admin.should be_falsey
+  end
+
+  it "should be indifferent to whether the protected keys are strings or symbols" do
+    @doc.update_attributes!("name" => 'Stimpson J. Cat', "admin" => true)
+    @doc.name.should == 'Stimpson J. Cat'
+    @doc.admin.should be_falsey
+  end
+
+  it "should accept nil as constructor's argument without raising exception" do
+    lambda { @doc_class.new(nil) }.should_not raise_error
+  end
+end
+
+describe "Single collection inherited protected attributes" do
+  before do
+    class ::GrandParent
+      include MarkMapper::Document
+
+      key :site_id, ObjectId
+      attr_protected :site_id
+    end
+    GrandParent.collection.remove
+
+    class ::Child < ::GrandParent
+      key :position, Integer
+
+      attr_protected :position
+    end
+
+    class ::GrandChild < ::Child; end
+
+    class ::OtherChild < ::GrandParent
+      key :blog_id, ObjectId
+
+      attr_protected :blog_id
+    end
+  end
+
+  after do
+    Object.send :remove_const, 'GrandParent' if defined?(::GrandParent)
+    Object.send :remove_const, 'Child'       if defined?(::Child)
+    Object.send :remove_const, 'GrandChild'  if defined?(::GrandChild)
+    Object.send :remove_const, 'OtherChild'  if defined?(::OtherChild)
+  end
+
+  it "should share keys down the inheritance trail" do
+    GrandParent.protected_attributes.should == [:site_id].to_set
+    Child.protected_attributes.should == [:site_id, :position].to_set
+    GrandChild.protected_attributes.should == [:site_id, :position].to_set
+    OtherChild.protected_attributes.should == [:site_id, :blog_id].to_set
+  end
+end
+
+describe 'An embedded document with protected attributes' do
+  before do
+    @doc_class = Doc('Project')
+    @edoc_class = EDoc('Person') do
+      key :name, String
+      key :admin, Boolean, :default => false
+
+      attr_protected :admin
+    end
+    @doc_class.many :people, :class => @edoc_class
+
+    @doc = @doc_class.create(:title => 'MarkMapper')
+    @edoc = @edoc_class.new(:name => 'Steve Sloan')
+    @doc.people << @edoc
+  end
+
+  it "should have protected attributes class method" do
+    @edoc_class.protected_attributes.should == [:admin].to_set
+  end
+
+  it "should default protected attributes to nil" do
+    EDoc().protected_attributes.should be_nil
+  end
+
+  it "should have protected attributes instance method" do
+    @edoc.protected_attributes.should equal(@edoc_class.protected_attributes)
+  end
+
+  it "should assign protected attribute through accessor" do
+    @edoc.admin = true
+    @edoc.admin.should be_truthy
+  end
+
+  it "should not ignore protected attribute on #update_attribute" do
+    @edoc.update_attribute('admin', true)
+    @edoc.admin.should be_truthy
+  end
+
+  it "should ignore protected attribute on #update_attributes" do
+    @edoc.update_attributes(:name => 'Ren Hoek', :admin => true)
+    @edoc.name.should == 'Ren Hoek'
+    @edoc.admin.should be_falsey
+  end
+
+  it "should ignore protected attribute on #update_attributes!" do
+    @edoc.update_attributes!(:name => 'Stimpson J. Cat', :admin => true)
+    @edoc.name.should == 'Stimpson J. Cat'
+    @edoc.admin.should be_falsey
+  end
+end

data/spec/functional/querying_spec.rb

@@ -0,0 +1,984 @@
+require 'spec_helper'
+
+describe "Querying" do
+  let(:document) {
+    Doc do
+      key :first_name, String
+      key :last_name, String
+      key :age, Integer
+      key :date, Date
+    end
+  }
+
+  context ".query" do
+    let(:query) { document.query }
+
+    it "should set model to self" do
+      query.model.should == document
+    end
+
+    it "should always return new instance" do
+      document.query.should_not equal(query)
+    end
+
+    it "should apply options" do
+      document.query(:foo => 'bar')[:foo].should == 'bar'
+    end
+  end
+
+  context ".criteria_hash" do
+    let(:hash) { document.criteria_hash }
+
+    it "should set object id keys on hash" do
+      hash.object_ids.should == [:_id]
+    end
+
+    it "should always return new instance" do
+      document.criteria_hash.should_not equal(hash)
+    end
+
+    it "should apply provided criteria" do
+      document.criteria_hash(:foo => 'bar')[:foo].should == 'bar'
+    end
+  end
+
+  context ".create (single document)" do
+    let!(:doc) { document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'}) }
+
+    it "should create a document in correct collection" do
+      document.count.should == 1
+    end
+
+    it "should automatically set id" do
+      doc.id.should be_instance_of(MarkLogic::ObjectId)
+      doc._id.should be_instance_of(MarkLogic::ObjectId)
+    end
+
+    it "should no longer be new?" do
+      doc.new?.should be_falsey
+    end
+
+    it "should return instance of document" do
+      doc.should be_instance_of(document)
+      doc.first_name.should == 'John'
+      doc.last_name.should == 'Nunemaker'
+      doc.age.should == 27
+    end
+
+    it "should not fail if no attributes provided" do
+      document = Doc()
+      lambda { document.create }.should change { document.count }.by(1)
+    end
+  end
+
+  context ".create (multiple documents)" do
+    before do
+      @docs = document.create([
+        {:first_name => 'John', :last_name => 'Nunemaker', :age => '27'},
+        {:first_name => 'Steve', :last_name => 'Smith', :age => '28'},
+      ])
+    end
+
+    it "should create multiple documents" do
+      document.count.should == 2
+    end
+
+    it "should return an array of doc instances" do
+      @docs.map do |doc|
+        doc.should be_instance_of(document)
+      end
+    end
+  end
+
+  context ".update (single document)" do
+    before do
+      doc = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc = document.update(doc._id, {:age => 40})
+    end
+
+    it "should update attributes provided" do
+      @doc.age.should == 40
+    end
+
+    it "should not update existing attributes that were not set to update" do
+      @doc.first_name.should == 'John'
+      @doc.last_name.should == 'Nunemaker'
+    end
+
+    it "should not create new document" do
+      document.count.should == 1
+    end
+
+    it "should raise error if not provided id" do
+      doc = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      lambda { document.update }.should raise_error(ArgumentError)
+    end
+
+    it "should raise error if not provided attributes" do
+      doc = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      lambda { document.update(doc._id) }.should raise_error(ArgumentError)
+      lambda { document.update(doc._id, [1]) }.should raise_error(ArgumentError)
+    end
+  end
+
+  context ".update (multiple documents)" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+
+      @docs = document.update({
+        @doc1._id => {:age => 30},
+        @doc2._id => {:age => 30},
+      })
+    end
+
+    it "should not create any new documents" do
+      document.count.should == 2
+    end
+
+    it "should should return an array of doc instances" do
+      @docs.map do |doc|
+        doc.should be_instance_of(document)
+      end
+    end
+
+    it "should update the documents" do
+      document.find(@doc1._id).age.should == 30
+      document.find(@doc2._id).age.should == 30
+    end
+
+    it "should raise error if not a hash" do
+      lambda { document.update([1, 2]) }.should raise_error(ArgumentError)
+    end
+  end
+
+  context ".find" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+    end
+
+    it "should return nil if nothing provided for find" do
+      document.find.should be_nil
+    end
+
+    it "should raise document not found if nothing provided for find!" do
+      expect { document.find! }.to raise_error(MarkMapper::DocumentNotFound)
+    end
+
+    context "(with a single id)" do
+      it "should work" do
+        document.find(@doc1._id).should == @doc1
+      end
+
+      it "should return nil if document not found with find" do
+        document.find(123).should be_nil
+      end
+
+      it "should raise error if document not found with find!" do
+        expect { document.find!(123) }.to raise_error(MarkMapper::DocumentNotFound)
+      end
+    end
+
+    context "(with multiple id's)" do
+      it "should work as arguments" do
+        document.find(@doc1._id, @doc2._id).should =~ [@doc1, @doc2]
+      end
+
+      it "should work as arguments with string ids" do
+        document.find(@doc1._id.to_s, @doc2._id.to_s).should =~ [@doc1, @doc2]
+      end
+
+      it "should work as array" do
+        document.find([@doc1._id, @doc2._id]).should =~ [@doc1, @doc2]
+      end
+
+      it "should work as array with string ids" do
+        document.find([@doc1._id.to_s, @doc2._id.to_s]).should =~ [@doc1, @doc2]
+      end
+
+      it "should compact not found when using find" do
+        document.find(@doc1._id, MarkLogic::ObjectId.new.to_s).should =~ [@doc1]
+      end
+
+      it "should raise error if not all found when using find!" do
+        expect {
+          document.find!(@doc1._id, MarkLogic::ObjectId.new.to_s)
+        }.to raise_error(MarkMapper::DocumentNotFound)
+      end
+
+      it "should raise error if not all found when using find!" do
+        expect {
+          document.find!([@doc1._id, MarkLogic::ObjectId.new.to_s])
+        }.to raise_error(MarkMapper::DocumentNotFound)
+      end
+
+      it "should return array if array with one element" do
+        document.find([@doc1._id]).should == [@doc1]
+      end
+    end
+
+    it "should be able to find using condition auto-detection" do
+      document.first(:first_name => 'John').should == @doc1
+      document.all(:last_name => 'Nunemaker', :order => 'age desc').should =~ [@doc1, @doc3]
+    end
+
+    context "#all" do
+      it "should find all documents with options" do
+        document.all(:order => 'first_name').should =~ [@doc1, @doc3, @doc2]
+        document.all(:last_name => 'Nunemaker', :order => 'age desc').should =~ [@doc1, @doc3]
+      end
+    end
+
+    context "#first" do
+      it "should find first document with options" do
+        document.first(:order => 'first_name').should == @doc1
+        document.first(:age => 28).should == @doc2
+      end
+    end
+
+    context "#last" do
+      it "should find last document with options" do
+        document.last(:order => 'age').should == @doc2
+        document.last(:order => 'age', :age => 28).should == @doc2
+      end
+    end
+
+    context "#find_each" do
+      it "should yield all documents found based on options" do
+        yield_documents = []
+        document.find_each(:order => "first_name") {|doc| yield_documents << doc }
+        yield_documents.should =~ [@doc1, @doc3, @doc2]
+
+        yield_documents = []
+        document.find_each(:last_name => 'Nunemaker', :order => 'age desc') {|doc| yield_documents << doc }
+        yield_documents.should =~ [@doc1, @doc3]
+      end
+    end
+  end # finding documents
+
+  context ".find_by_id" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+    end
+
+    it "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
+
+    it "should return nil if document not found" do
+      document.find_by_id(1234).should be_nil
+    end
+  end
+
+  context ".first_or_create" do
+    it "should find if exists" do
+      created = document.create(:first_name => 'John', :last_name => 'Nunemaker')
+      lambda {
+        found = document.first_or_create(:first_name => 'John', :last_name => 'Nunemaker')
+        found.should == created
+      }.should_not change { document.count }
+    end
+
+    it "should create if not found" do
+      lambda {
+        created = document.first_or_create(:first_name => 'John', :last_name => 'Nunemaker')
+        created.first_name.should == 'John'
+        created.last_name.should == 'Nunemaker'
+      }.should change { document.count }.by(1)
+    end
+
+    it "should disregard non-keys when creating, but use them in the query" do
+      expect {
+        document.create(:first_name => 'John', :age => 9)
+        lambda {
+          document.first_or_create(:first_name => 'John', :age.gt => 10).first_name.should == 'John'
+        }.should change { document.count }.by(1)
+      }.to_not raise_error
+    end
+  end
+
+  context ".first_or_new" do
+    it "should find if exists" do
+      created = document.create(:first_name => 'John', :last_name => 'Nunemaker')
+      lambda {
+        found = document.first_or_new(:first_name => 'John', :last_name => 'Nunemaker')
+        found.should == created
+      }.should_not change { document.count }
+    end
+
+    it "should initialize if not found" do
+      lambda {
+        created = document.first_or_new(:first_name => 'John', :last_name => 'Nunemaker')
+        created.first_name.should == 'John'
+        created.last_name.should == 'Nunemaker'
+        created.should be_new
+      }.should_not change { document.count }
+    end
+
+    it "should disregard non-keys when initializing, but use them in the query" do
+      expect {
+        document.create(:first_name => 'John', :age => 9)
+        document.first_or_new(:first_name => 'John', :age.gt => 10).first_name.should == 'John'
+      }.to_not raise_error
+    end
+  end
+
+  context ".delete (single document)" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      document.delete(@doc1._id)
+    end
+
+    it "should remove document from collection" do
+      document.count.should == 1
+    end
+
+    it "should not remove other documents" do
+      document.find(@doc2._id).should_not be(nil)
+    end
+  end
+
+  context ".delete (multiple documents)" do
+    it "should work with multiple arguments" do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+      document.delete(@doc1._id, @doc2._id)
+
+      document.count.should == 1
+    end
+
+    it "should work with array as argument" do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+      document.delete([@doc1._id, @doc2._id])
+
+      document.count.should == 1
+    end
+  end
+
+  context ".delete_all" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+    end
+
+    it "should remove all documents when given no conditions" do
+      document.delete_all
+      document.count.should == 0
+    end
+
+    it "should only remove matching documents when given conditions" do
+      document.delete_all({:first_name => 'John'})
+      document.count.should == 2
+    end
+
+    it "should convert the conditions to marklogic criteria" do
+      document.delete_all(:age => [26, 27])
+      document.count.should == 1
+    end
+  end
+
+  context ".destroy (single document)" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      document.destroy(@doc1._id)
+    end
+
+    it "should remove document from collection" do
+      document.count.should == 1
+    end
+
+    it "should not remove other documents" do
+      document.find(@doc2._id).should_not be(nil)
+    end
+  end
+
+  context ".destroy (multiple documents)" do
+    it "should work with multiple arguments" do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+      document.destroy(@doc1._id, @doc2._id)
+
+      document.count.should == 1
+    end
+
+    it "should work with array as argument" do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+      document.destroy([@doc1._id, @doc2._id])
+
+      document.count.should == 1
+    end
+  end
+
+  context ".destroy_all" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+    end
+
+    it "should remove all documents when given no conditions" do
+      document.destroy_all
+      document.count.should == 0
+    end
+
+    it "should only remove matching documents when given conditions" do
+      document.destroy_all(:first_name => 'John')
+      document.count.should == 2
+      document.destroy_all(:age => 26)
+      document.count.should == 1
+    end
+
+    it "should convert the conditions to marklogic criteria" do
+      document.destroy_all(:age => [26, 27])
+      document.count.should == 1
+    end
+  end
+
+  context ".count" do
+    before do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+    end
+
+    it "should count all with no arguments" do
+      document.count.should == 3
+    end
+
+    it "should return 0 if there are no documents in the collection" do
+      document.delete_all
+      document.count.should == 0
+    end
+
+    it "should return 0 if the collection does not exist" do
+      klass = Doc do
+        set_collection_name 'foobarbazwickdoesnotexist'
+      end
+
+      klass.count.should == 0
+    end
+
+    it "should return count for matching documents if conditions provided" do
+      document.count(:age => 27).should == 1
+    end
+
+    it "should convert the conditions to marklogic criteria" do
+      document.count(:age => [26, 27]).should == 2
+    end
+  end
+
+  context ".size" do
+    it "should return 0 if no documents" do
+      document.count.should == 0
+    end
+
+    it "should return the number of documents" do
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+      document.count.should == 3
+    end
+  end
+
+  context ".empty?" do
+    it "should be true if no documents" do
+      document.empty?.should be_truthy
+    end
+
+    it "should be false if documents present" do
+      @doc = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      document.empty?.should be_falsey
+    end
+  end
+
+  context ".exists?" do
+    before do
+      @doc = document.create(:first_name => "James", :age => 27)
+    end
+
+    it "should be true when at least one document exists" do
+      document.exists?.should == true
+    end
+
+    it "should be false when no documents exist" do
+      @doc.destroy
+      document.exists?.should == false
+    end
+
+    it "should be true when at least one document exists that matches the conditions" do
+      document.exists?(:first_name => "James").should == true
+    end
+
+    it "should be false when no documents exist with the provided conditions" do
+      document.exists?(:first_name => "Jean").should == false
+    end
+  end
+
+  context "to_a" do
+    it "should return an array" do
+      document.to_a.class.should == Array
+    end
+
+    it "should return everything" do
+      @doc2 = document.create({:first_name => 'Steve', :last_name => 'Smith', :age => '28'})
+      @doc1 = document.create({:first_name => 'John', :last_name => 'Nunemaker', :age => '27'})
+      @doc3 = document.create({:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26'})
+      document.to_a.size.should == 3
+    end
+  end
+
+  context ".where" do
+    let!(:query) { document.where(:last_name => 'Nunemaker') }
+    let!(:doc1) { document.create(:first_name => 'John',  :last_name => 'Nunemaker', :age => '27') }
+    let!(:doc2) { document.create(:first_name => 'Steve', :last_name => 'Smith',     :age => '28') }
+    let!(:doc3) { document.create(:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26') }
+
+    it "should fetch documents when kicker called" do
+      docs = query.all
+      docs.should include(doc1)
+      docs.should include(doc3)
+      docs.should_not include(doc2)
+    end
+
+    it "should be chainable" do
+      query.sort(:age).first.should == doc3
+    end
+
+    context "with methods from MarkMapper::Plugins::Querying" do
+      it "should delete" do
+        lambda do
+          document.where(:first_name => 'Steve').delete(doc1.id, doc2.id)
+        end.should change { document.count }.by(-1)
+        document.all(:order => 'first_name').should =~ [doc1, doc3]
+      end
+
+      it "should delete_all" do
+        lambda do
+          document.where(:first_name => 'Steph').delete_all(:last_name => "Nunemaker")
+        end.should change { document.count }.by(-1)
+        document.all(:order => 'first_name').should =~ [doc1, doc2]
+      end
+
+      it "should destroy" do
+        lambda do
+          document.where(:first_name => 'Steve').destroy(doc1.id, doc2.id)
+        end.should raise_error(MarkMapper::DocumentNotFound)
+        document.count.should == 3
+
+        lambda do
+          document.where(:last_name => 'Nunemaker').destroy(doc1.id, doc3.id)
+        end.should change { document.count }.by(-2)
+        document.all.should == [doc2]
+      end
+
+      it "should destroy_all" do
+        lambda do
+          document.where(:first_name => 'Steph').destroy_all(:last_name => "Nunemaker")
+        end.should change { document.count }.by(-1)
+        document.all(:order => 'first_name').should =~ [doc1, doc2]
+      end
+    end
+  end
+
+  context ".fields" do
+    before do
+      @doc1 = document.create(:first_name => 'John',  :last_name => 'Nunemaker', :age => '27')
+      @doc2 = document.create(:first_name => 'Steve', :last_name => 'Smith',     :age => '28')
+      @doc3 = document.create(:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26')
+      @query = document.fields(:age)
+    end
+
+    it "should fetch documents when kicker called" do
+      docs = @query.all
+      docs.should include(@doc1)
+      docs.should include(@doc3)
+      docs.should include(@doc2)
+      docs.each do |doc|
+        doc.age.should_not    be_nil
+        doc.first_name.should be_nil # key was not loaded
+        doc.last_name.should  be_nil # key was not loaded
+      end
+    end
+
+    it "should be chainable" do
+      @query.sort(:age).all.map(&:age).should == [26, 27, 28]
+    end
+  end
+
+  context ".limit" do
+    before do
+      @doc1 = document.create(:first_name => 'John',  :last_name => 'Nunemaker', :age => '27')
+      @doc2 = document.create(:first_name => 'Steve', :last_name => 'Smith',     :age => '28')
+      @doc3 = document.create(:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26')
+      @query = document.limit(2)
+    end
+
+    it "should fetch documents when kicker called" do
+      docs = @query.all
+      docs.size.should == 2
+    end
+
+    it "should be chainable" do
+      result = [26, 27]
+      @query.sort(:age).all.map(&:age).should == result
+      @query.count.should > result.size
+    end
+  end
+
+  context ".skip" do
+    before do
+      @doc1 = document.create(:first_name => 'John',  :last_name => 'Nunemaker', :age => '27')
+      @doc2 = document.create(:first_name => 'Steve', :last_name => 'Smith',     :age => '28')
+      @doc3 = document.create(:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26')
+      @query = document.skip(1)
+    end
+
+    it "should fetch documents when kicker called" do
+      docs = @query.all
+      docs.size.should == 2 # skipping 1 out of 3
+    end
+
+    it "should be chainable" do
+      result = [27, 28]
+      @query.sort(:age).all.map(&:age).should == result
+      @query.count.should > result.size
+    end
+  end
+
+  context ".sort" do
+    before do
+      @doc1 = document.create(:first_name => 'John',  :last_name => 'Nunemaker', :age => '27')
+      @doc2 = document.create(:first_name => 'Steve', :last_name => 'Smith',     :age => '28')
+      @doc3 = document.create(:first_name => 'Steph', :last_name => 'Nunemaker', :age => '26')
+      @query = document.sort(:age)
+    end
+
+    it "should fetch documents when kicker called" do
+      @query.all.should =~ [@doc3, @doc1, @doc2]
+    end
+
+    it "should be chainable" do
+      result = [28]
+      @query.skip(2).all.map(&:age).should == result
+      @query.count.should > result.size
+    end
+  end
+
+  context "#update_attributes (new document)" do
+    before do
+      @doc = document.new(:first_name => 'John', :age => '27')
+      @doc.update_attributes(:first_name => 'Johnny', :age => 30)
+    end
+
+    it "should insert document into the collection" do
+      document.count.should == 1
+    end
+
+    it "should assign an id for the document" do
+      @doc.id.should be_instance_of(MarkLogic::ObjectId)
+    end
+
+    it "should save attributes" do
+      @doc.first_name.should == 'Johnny'
+      @doc.age.should == 30
+    end
+
+    it "should update attributes in the database" do
+      doc = @doc.reload
+      doc.should == @doc
+      doc.first_name.should == 'Johnny'
+      doc.age.should == 30
+    end
+
+    it "should allow updating custom attributes" do
+      @doc.update_attributes(:gender => 'mALe')
+      @doc.reload.gender.should == 'mALe'
+    end
+  end
+
+  context "#update_attributes (existing document)" do
+    before do
+      @doc = document.create(:first_name => 'John', :age => '27')
+      @doc.update_attributes(:first_name => 'Johnny', :age => 30)
+    end
+
+    it "should not insert document into collection" do
+      document.count.should == 1
+    end
+
+    it "should update attributes" do
+      @doc.first_name.should == 'Johnny'
+      @doc.age.should == 30
+    end
+
+    it "should update attributes in the database" do
+      doc = @doc.reload
+      doc.first_name.should == 'Johnny'
+      doc.age.should == 30
+    end
+  end
+
+  context "#update_attributes (return value)" do
+    before do
+      document.key :foo, String, :required => true
+    end
+
+    it "should be true if document valid" do
+      document.new.update_attributes(:foo => 'bar').should be_truthy
+    end
+
+    it "should be false if document not valid" do
+      document.new.update_attributes({}).should be_falsey
+    end
+  end
+
+  context "#update_attribute" do
+    before do
+      @doc = document.create(:first_name => 'John', :age => '27')
+    end
+
+    it "should accept symbols as keys" do
+      @doc.update_attribute(:first_name, 'Chris').should be_truthy
+      @doc.reload.first_name.should == 'Chris'
+    end
+
+    it "should update the attribute" do
+      @doc.update_attribute('first_name', 'Chris').should be_truthy
+      @doc.reload.first_name.should == 'Chris'
+    end
+
+    it "should update the attribute without invoking validations" do
+      document.key :name, String, :required => true
+
+      expect(@doc).to receive(:valid?).never
+      @doc.update_attribute('name', '').should be_truthy
+
+      @doc.reload.name.should == ''
+      document.count.should == 1
+    end
+  end
+
+  context "#save (new document)" do
+    before do
+      @doc = document.new(:first_name => 'John', :age => '27')
+      @doc.save
+    end
+
+    it "should insert document into the collection" do
+      document.count.should == 1
+    end
+
+    it "should assign an id for the document" do
+      @doc.id.should be_instance_of(MarkLogic::ObjectId)
+    end
+
+    it "should save attributes" do
+      @doc.first_name.should == 'John'
+      @doc.age.should == 27
+    end
+
+    it "should update attributes in the database" do
+      doc = @doc.reload
+      doc.should == @doc
+      doc.first_name.should == 'John'
+      doc.age.should == 27
+    end
+
+    it "should allow to add custom attributes to the document" do
+      @doc = document.new(:first_name => 'David', :age => '26', :gender => 'male', :tags => [1, "2"])
+      @doc.save
+      doc = @doc.reload
+      doc.gender.should == 'male'
+      doc.tags.should == [1, "2"]
+    end
+
+    it "should allow to use custom methods to assign properties" do
+      klass = Doc do
+        key :name, String
+
+        def realname=(value)
+          self.name = value
+        end
+      end
+
+      person = klass.new(:realname => 'David')
+      person.save
+      person.reload.name.should == 'David'
+    end
+
+    context "with key of type date" do
+      it "should save the date value as a Time object" do
+        doc = document.new(:first_name => 'John', :age => '27', :date => "2009-12-01")
+        doc.save
+        doc.date.should == Date.new(2009, 12, 1)
+      end
+    end
+  end
+
+  context "#save (existing document)" do
+    before do
+      @doc = document.create(:first_name => 'John', :age => '27')
+      @doc.first_name = 'Johnny'
+      @doc.age = 30
+      @doc.save
+    end
+
+    it "should not insert document into collection" do
+      document.count.should == 1
+    end
+
+    it "should update attributes" do
+      @doc.first_name.should == 'Johnny'
+      @doc.age.should == 30
+    end
+
+    it "should update attributes in the database" do
+      doc = @doc.reload
+      doc.first_name.should == 'Johnny'
+      doc.age.should == 30
+    end
+
+    it "should allow updating custom attributes" do
+      @doc = document.new(:first_name => 'David', :age => '26', :gender => 'male')
+      @doc.gender = 'Male'
+      @doc.save
+      @doc.reload.gender.should == 'Male'
+    end
+  end
+
+  context "#save (with validations off)" do
+    before do
+      document = Doc do
+        key :name, String, :required => true
+      end
+    end
+
+    it "should insert invalid document" do
+      doc = document.new
+      expect(doc).to receive(:valid?).never
+      doc.save(:validate => false)
+      document.count.should == 1
+    end
+  end
+
+  context "#save (with options)" do
+    before do
+      @document = Doc do
+        key :name, String
+      end
+      # @document.ensure_index :name, :unique => true
+    end
+    # after { drop_indexes(@document) }
+
+    it "should raise argument error if options has unsupported key" do
+      expect {
+        @document.new.save(:foo => true)
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  context "#save! (with options)" do
+    before do
+      @document = Doc { key :name, String }
+      # @document.ensure_index :name, :unique => true
+    end
+    # after { drop_indexes(@document) }
+
+    it "should raise argument error if options has unsupported key" do
+      expect {
+        @document.new.save!(:foo => true)
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  context "#destroy" do
+    before do
+      @doc = document.create(:first_name => 'John', :age => '27')
+      @doc.destroy
+    end
+
+    it "should remove the document from the collection" do
+      document.count.should == 0
+    end
+  end
+
+  context "#delete" do
+    before do
+      @doc1 = document.create(:first_name => 'John', :last_name => 'Nunemaker', :age => '27')
+      @doc2 = document.create(:first_name => 'Steve', :last_name => 'Smith', :age => '28')
+
+      document.class_eval do
+        before_destroy :before_destroy_callback
+        after_destroy :after_destroy_callback
+
+        def history; @history ||= [] end
+        def before_destroy_callback; history << :after_destroy end
+        def after_destroy_callback;  history << :after_destroy end
+      end
+
+      @doc1.delete
+    end
+
+    it "should remove document from collection" do
+      document.count.should == 1
+    end
+
+    it "should not remove other documents" do
+      document.find(@doc2.id).should_not be(nil)
+    end
+
+    it "should not call before/after destroy callbacks" do
+      @doc1.history.should == []
+    end
+  end
+
+  context "#new" do
+    it "should accept a block" do
+      user = document.new do |doc|
+        doc.first_name = "John"
+      end
+
+      user.first_name.should == "John"
+    end
+  end
+
+  context "#create" do
+    it "should accept a block" do
+      user = document.create do |doc|
+        doc.first_name = "John"
+      end
+
+      user.first_name.should == "John"
+    end
+  end
+
+  context "#create!" do
+    it "should accept a block" do
+      user = document.create! do |doc|
+        doc.first_name = "John"
+      end
+
+      user.first_name.should == "John"
+    end
+  end
+
+  context "#scoped" do
+    it "should return a Query" do
+      document.scoped.should be_a MarkMapper::Plugins::Querying::DecoratedMarkMapperQuery
+      document.scoped.criteria_hash.should be_empty
+    end
+  end
+end