openlogic-couchrest_model 1.0.0

data/spec/unit/core_extensions/time_parsing.rb

@@ -0,0 +1,77 @@
+# encoding: utf-8
+require File.expand_path('../../../spec_helper', __FILE__)
+
+describe "Time Parsing core extension" do
+
+  describe "Time" do
+
+    it "should respond to .parse_iso8601" do
+      Time.respond_to?("parse_iso8601").should be_true
+    end
+
+    describe ".parse_iso8601" do
+
+      describe "parsing" do
+
+        before :each do
+          # Time.parse should not be called for these tests!
+          Time.stub!(:parse).and_return(nil)
+        end
+
+        it "should parse JSON time" do
+          txt = "2011-04-01T19:05:30Z"
+          Time.parse_iso8601(txt).should eql(Time.utc(2011, 04, 01, 19, 05, 30))
+        end
+
+        it "should parse JSON time as UTC without Z" do
+          txt = "2011-04-01T19:05:30"
+          Time.parse_iso8601(txt).should eql(Time.utc(2011, 04, 01, 19, 05, 30))
+        end
+
+        it "should parse basic time as UTC" do
+          txt = "2011-04-01 19:05:30"
+          Time.parse_iso8601(txt).should eql(Time.utc(2011, 04, 01, 19, 05, 30))
+        end
+
+        it "should parse JSON time with zone" do
+          txt = "2011-04-01T19:05:30 +02:00"
+          Time.parse_iso8601(txt).should eql(Time.new(2011, 04, 01, 19, 05, 30, "+02:00"))
+        end
+
+        it "should parse JSON time with zone 2" do
+          txt = "2011-04-01T19:05:30-0200"
+          Time.parse_iso8601(txt).should eql(Time.new(2011, 04, 01, 19, 05, 30, "-02:00"))
+        end
+
+        it "should parse dodgy time with zone" do
+          txt = "2011-04-01 19:05:30 +0200"
+          Time.parse_iso8601(txt).should eql(Time.new(2011, 04, 01, 19, 05, 30, "+02:00"))
+        end
+
+        it "should parse dodgy time with zone 2" do
+          txt = "2011-04-01 19:05:30+0230"
+          Time.parse_iso8601(txt).should eql(Time.new(2011, 04, 01, 19, 05, 30, "+02:30"))
+        end
+
+        it "should parse dodgy time with zone 3" do
+          txt = "2011-04-01 19:05:30 0230"
+          Time.parse_iso8601(txt).should eql(Time.new(2011, 04, 01, 19, 05, 30, "+02:30"))
+        end
+
+      end
+
+      describe "resorting back to normal parse" do
+        before :each do
+          Time.should_receive(:parse)
+        end
+        it "should work with weird time" do
+          txt = "16/07/1981 05:04:00"
+          Time.parse_iso8601(txt)
+        end
+
+      end
+    end
+
+  end
+
+end

data/spec/unit/design_doc_spec.rb

@@ -0,0 +1,241 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe CouchRest::Model::DesignDoc do
+
+  before :all do
+    reset_test_db!
+  end
+
+  describe "CouchRest Extension" do
+
+    it "should have created a checksum! method" do
+      ::CouchRest::Design.new.should respond_to(:checksum!)
+    end
+
+    it "should calculate a consistent checksum for model" do
+      WithTemplateAndUniqueID.design_doc.checksum!.should eql('caa2b4c27abb82b4e37421de76d96ffc')
+    end
+
+    it "should calculate checksum for complex model" do
+      Article.design_doc.checksum!.should eql('70dff8caea143bf40fad09adf0701104')
+    end
+
+    it "should cache the generated checksum value" do
+      Article.design_doc.checksum!
+      Article.design_doc['couchrest-hash'].should_not be_blank
+    end
+  end
+
+  describe "class methods" do
+
+    describe ".design_doc" do
+      it "should provide Design document" do
+        Article.design_doc.should be_a(::CouchRest::Design)
+      end
+    end
+
+    describe ".design_doc_id" do
+      it "should provide a reasonable id" do
+        Article.design_doc_id.should eql("_design/Article")
+      end
+    end
+
+    describe ".design_doc_slug" do
+      it "should provide slug part of design doc" do
+        Article.design_doc_slug.should eql('Article')
+      end
+    end
+
+    describe ".design_doc_uri" do
+      it "should provide complete url" do
+        Article.design_doc_uri.should eql("#{COUCHHOST}/#{TESTDB}/_design/Article")
+      end
+      it "should provide complete url for new DB" do
+        db = mock("Database")
+        db.should_receive(:root).and_return('db')
+        Article.design_doc_uri(db).should eql("db/_design/Article")
+      end
+    end
+
+    describe ".stored_design_doc" do
+      it "should load a stored design from the database" do
+        Article.by_date
+        Article.stored_design_doc['_rev'].should_not be_blank
+      end
+      it "should return nil if not already stored" do
+        WithDefaultValues.stored_design_doc.should be_nil
+      end
+    end
+
+    describe ".save_design_doc" do
+      it "should call up the design updater" do
+        Article.should_receive(:update_design_doc).with('db', false)
+        Article.save_design_doc('db')
+      end
+    end
+
+    describe ".save_design_doc!" do
+      it "should call save_design_doc with force" do
+        Article.should_receive(:save_design_doc).with('db', true)
+        Article.save_design_doc!('db')
+      end
+    end
+
+  end
+
+  describe "basics" do
+
+    before :all do
+      reset_test_db!
+    end
+
+    it "should have been instantiated with views" do
+      d = Article.design_doc
+      d['views']['all']['map'].should include('Article')
+    end
+
+    it "should not have been saved yet" do
+      lambda { Article.database.get(Article.design_doc.id) }.should raise_error(RestClient::ResourceNotFound)
+    end
+
+    describe "after requesting a view" do
+      before :each do
+        Article.all
+      end
+      it "should have saved the design doc after view request" do
+        Article.database.get(Article.design_doc.id).should_not be_nil
+      end
+    end
+
+    describe "model with simple views" do
+      before(:all) do
+        Article.all.map{|a| a.destroy(true)}
+        Article.database.bulk_delete
+        written_at = Time.now - 24 * 3600 * 7
+        @titles = ["this and that", "also interesting", "more fun", "some junk"]
+        @titles.each do |title|
+          a = Article.new(:title => title)
+          a.date = written_at
+          a.save
+          written_at += 24 * 3600
+        end
+      end
+
+      it "will send request for the saved design doc on view request" do
+        reset_test_db!
+        Article.should_receive(:stored_design_doc).and_return(nil)
+        Article.by_date
+      end
+
+      it "should have generated a design doc" do
+        Article.design_doc["views"]["by_date"].should_not be_nil
+      end
+      it "should save the design doc when view requested" do
+        Article.by_date
+        doc = Article.database.get Article.design_doc.id
+        doc['views']['by_date'].should_not be_nil
+      end
+      it "should save design doc if a view changed" do
+        Article.by_date
+        orig = Article.stored_design_doc
+        design = Article.design_doc
+        view = design['views']['by_date']['map']
+        design['views']['by_date']['map'] = view + '  ' # little bit of white space
+        Article.by_date
+        Article.stored_design_doc['_rev'].should_not eql(orig['_rev'])
+        orig['views']['by_date']['map'].should_not eql(Article.design_doc['views']['by_date']['map'])
+      end
+      it "should not save design doc if not changed" do
+        Article.by_date
+        orig = Article.stored_design_doc['_rev']
+        Article.by_date
+        Article.stored_design_doc['_rev'].should eql(orig)
+      end
+      it "should recreate the design doc if database deleted" do
+        Article.database.recreate!
+        lambda { Article.by_date }.should_not raise_error(RestClient::ResourceNotFound)
+      end
+    end
+
+    describe "when auto_update_design_doc false" do
+      # We really do need a new class for each of example. If we try
+      # to use the same class the examples interact with each in ways
+      # that can hide failures because the design document gets cached
+      # at the class level.
+      let(:model_class) {
+        class_name = "#{example.metadata[:full_description].gsub(/\s+/,'_').camelize}Model"
+        doc = CouchRest::Document.new("_id" => "_design/#{class_name}")
+        doc["language"] = "javascript"
+        doc["views"] = {"all" => {"map" => 
+                                  "function(doc) {
+                                 if (doc['type'] == 'Article') {
+                                   emit(doc['_id'],1);
+                                 }
+                               }"},
+                         "by_name" => {"map" => 
+                                       "function(doc) {
+                                     if ((doc['type'] == '#{class_name}') && (doc['name'] != null)) {
+                                       emit(doc['name'], null);
+                                     }",
+                                      "reduce" => 
+                                      "function(keys, values, rereduce) {
+                                        return sum(values);
+                                      }"}}
+        
+        DB.save_doc doc
+
+        eval <<-KLASS
+          class ::#{class_name} < CouchRest::Model::Base
+            use_database DB
+            self.auto_update_design_doc = false
+            design do 
+              view :by_name
+            end
+            property :name, String
+          end
+        KLASS
+
+        class_name.constantize
+      }
+
+      it "will not update stored design doc if view changed" do
+        model_class.by_name
+        orig = model_class.stored_design_doc
+        design = model_class.design_doc
+        view = design['views']['by_name']['map']
+        design['views']['by_name']['map'] = view + '  '
+        model_class.by_name
+        model_class.stored_design_doc['_rev'].should eql(orig['_rev'])
+      end
+
+      it "will update stored design if forced" do
+        model_class.by_name
+        orig = model_class.stored_design_doc
+        design = model_class.design_doc
+        view = design['views']['by_name']['map']
+        design['views']['by_name']['map'] = view + '  '
+        model_class.save_design_doc!
+        model_class.stored_design_doc['_rev'].should_not eql(orig['_rev'])
+      end
+
+      it "is able to use predefined views" do 
+        model_class.by_name(key: "special").all
+      end
+    end
+  end
+
+  describe "lazily refreshing the design document" do
+    before(:all) do
+      @db = reset_test_db!
+      WithTemplateAndUniqueID.new('slug' => '1').save
+    end
+    it "should not save the design doc twice" do
+      WithTemplateAndUniqueID.all
+      rev = WithTemplateAndUniqueID.design_doc['_rev']
+      WithTemplateAndUniqueID.design_doc['_rev'].should eql(rev)
+    end
+  end
+
+
+end

data/spec/unit/designs/view_spec.rb

@@ -0,0 +1,831 @@
+require File.expand_path("../../../spec_helper", __FILE__)
+
+class DesignViewModel < CouchRest::Model::Base
+  use_database DB
+  property :name
+  property :title
+
+  design do
+    view :by_name
+    view :by_just_name, :map => "function(doc) { emit(doc['name'], null); }"
+  end
+end
+
+describe "Design View" do
+
+  describe "(unit tests)" do
+
+    before :each do
+      @klass = CouchRest::Model::Designs::View
+    end
+
+    describe ".new" do
+
+      describe "with invalid parent model" do
+        it "should burn" do
+          lambda { @klass.new(String) }.should raise_exception
+        end
+      end
+
+      describe "with CouchRest Model" do
+
+        it "should setup attributes" do
+          @obj = @klass.new(DesignViewModel, {}, 'test_view')
+          @obj.model.should eql(DesignViewModel)
+          @obj.name.should eql('test_view')
+          @obj.query.should be_empty
+        end
+
+        it "should complain if there is no name" do
+          lambda { @klass.new(DesignViewModel, {}, nil) }.should raise_error
+        end
+
+      end
+
+      describe "with previous view instance" do
+
+        before :each do
+          first = @klass.new(DesignViewModel, {}, 'test_view')
+          @obj = @klass.new(first, {:foo => :bar})
+        end
+
+        it "should copy attributes" do
+          @obj.model.should eql(DesignViewModel)
+          @obj.name.should eql('test_view')
+          @obj.query.should eql({:foo => :bar})
+        end
+
+      end
+
+    end
+
+    describe ".create" do
+
+      before :each do
+        @design_doc = {}
+        DesignViewModel.stub!(:design_doc).and_return(@design_doc)
+      end
+
+      it "should add a basic view" do
+        @klass.create(DesignViewModel, 'test_view', :map => 'foo')
+        @design_doc['views']['test_view'].should_not be_nil
+      end
+
+      it "should auto generate mapping from name" do
+        lambda { @klass.create(DesignViewModel, 'by_title') }.should_not raise_error
+        str = @design_doc['views']['by_title']['map']
+        str.should include("((doc['#{DesignViewModel.model_type_key}'] == 'DesignViewModel') && (doc['title'] != null))")
+        str.should include("emit(doc['title'], 1);")
+        str = @design_doc['views']['by_title']['reduce']
+        str.should include("return sum(values);")
+      end
+
+      it "should auto generate mapping from name with and" do
+        @klass.create(DesignViewModel, 'by_title_and_name')
+        str = @design_doc['views']['by_title_and_name']['map']
+        str.should include("(doc['title'] != null) && (doc['name'] != null)")
+        str.should include("emit([doc['title'], doc['name']], 1);")
+        str = @design_doc['views']['by_title_and_name']['reduce']
+        str.should include("return sum(values);")
+      end
+
+    end
+
+    describe "instance methods" do
+
+      before :each do
+        @obj = @klass.new(DesignViewModel, {}, 'test_view')
+      end
+
+      describe "#rows" do
+        it "should execute query" do
+          @obj.should_receive(:execute).and_return(true)
+          @obj.should_receive(:result).twice.and_return({'rows' => []})
+          @obj.rows.should be_empty
+        end
+
+        it "should wrap rows in ViewRow class" do
+          @obj.should_receive(:execute).and_return(true)
+          @obj.should_receive(:result).twice.and_return({'rows' => [{:foo => :bar}]})
+          CouchRest::Model::Designs::ViewRow.should_receive(:new).with({:foo => :bar}, @obj.model)
+          @obj.rows
+        end
+      end
+
+      describe "#all" do
+        it "should ensure docs included and call docs" do
+          @obj.should_receive(:include_docs!)
+          @obj.should_receive(:docs)
+          @obj.all
+        end
+      end
+
+      describe "#docs" do
+        it "should provide docs from rows" do
+          @obj.should_receive(:rows).and_return([])
+          @obj.docs
+        end
+        it "should cache the results" do
+          @obj.should_receive(:rows).once.and_return([])
+          @obj.docs
+          @obj.docs
+        end
+      end
+
+      describe "#first" do
+        it "should provide the first result of loaded query" do
+          @obj.should_receive(:result).and_return(true)
+          @obj.should_receive(:all).and_return([:foo])
+          @obj.first.should eql(:foo)
+        end
+        it "should perform a query if no results cached" do
+          view = mock('SubView')
+          @obj.should_receive(:result).and_return(nil)
+          @obj.should_receive(:limit).with(1).and_return(view)
+          view.should_receive(:all).and_return([:foo])
+          @obj.first.should eql(:foo)
+        end
+      end
+
+      describe "#last" do
+        it "should provide the last result of loaded query" do
+          @obj.should_receive(:result).and_return(true)
+          @obj.should_receive(:all).and_return([:foo, :bar])
+          @obj.first.should eql(:foo)
+        end
+        it "should perform a query if no results cached" do
+          view = mock('SubView')
+          @obj.should_receive(:result).and_return(nil)
+          @obj.should_receive(:limit).with(1).and_return(view)
+          view.should_receive(:descending).and_return(view)
+          view.should_receive(:all).and_return([:foo, :bar])
+          @obj.last.should eql(:bar)
+        end
+      end
+
+      describe "#length" do
+        it "should provide a length from the docs array" do
+          @obj.should_receive(:docs).and_return([1, 2, 3])
+          @obj.length.should eql(3)
+        end
+      end
+
+      describe "#count" do
+        it "should raise an error if view prepared for group" do
+          @obj.should_receive(:query).and_return({:group => true})
+          lambda { @obj.count }.should raise_error(/group/)
+        end
+
+        it "should return first row value if reduce possible" do
+          view = mock("SubView")
+          row = mock("Row")
+          @obj.should_receive(:can_reduce?).and_return(true)
+          @obj.should_receive(:reduce).and_return(view)
+          view.should_receive(:skip).with(0).and_return(view)
+          view.should_receive(:limit).with(1).and_return(view)
+          view.should_receive(:rows).and_return([row])
+          row.should_receive(:value).and_return(2)
+          @obj.count.should eql(2)
+        end
+        it "should return 0 if no rows and reduce possible" do
+          view = mock("SubView")
+          @obj.should_receive(:can_reduce?).and_return(true)
+          @obj.should_receive(:reduce).and_return(view)
+          view.should_receive(:skip).with(0).and_return(view)
+          view.should_receive(:limit).with(1).and_return(view)
+          view.should_receive(:rows).and_return([])
+          @obj.count.should eql(0)
+        end
+
+        it "should perform limit request for total_rows" do
+          view = mock("SubView")
+          @obj.should_receive(:limit).with(0).and_return(view)
+          view.should_receive(:total_rows).and_return(4)
+          @obj.should_receive(:can_reduce?).and_return(false)
+          @obj.count.should eql(4)
+        end
+      end
+
+      describe "#empty?" do
+        it "should check the #all method for any results" do
+          all = mock("All")
+          all.should_receive(:empty?).and_return('win')
+          @obj.should_receive(:all).and_return(all)
+          @obj.empty?.should eql('win')
+        end
+      end
+
+      describe "#each" do
+        it "should call each method on all" do
+          @obj.should_receive(:all).and_return([])
+          @obj.each
+        end
+        it "should call each and pass block" do
+          set = [:foo, :bar]
+          @obj.should_receive(:all).and_return(set)
+          result = []
+          @obj.each do |s|
+            result << s
+          end
+          result.should eql(set)
+        end
+      end
+
+      describe "#offset" do
+        it "should excute" do
+          @obj.should_receive(:execute).and_return({'offset' => 3})
+          @obj.offset.should eql(3)
+        end
+      end
+
+      describe "#total_rows" do
+        it "should excute" do
+          @obj.should_receive(:execute).and_return({'total_rows' => 3})
+          @obj.total_rows.should eql(3)
+        end
+      end
+
+      describe "#values" do
+        it "should request each row and provide value" do
+          row = mock("Row")
+          row.should_receive(:value).twice.and_return('foo')
+          @obj.should_receive(:rows).and_return([row, row])
+          @obj.values.should eql(['foo', 'foo'])
+        end
+      end
+
+      describe "#[]" do
+        it "should execute and provide requested field" do
+          @obj.should_receive(:execute).and_return({'total_rows' => 2})
+          @obj['total_rows'].should eql(2)
+        end
+      end
+
+      describe "#info" do
+        it "should raise error" do
+          lambda { @obj.info }.should raise_error
+        end
+      end
+
+      describe "#database" do
+        it "should update query with value" do
+          @obj.should_receive(:update_query).with({:database => 'foo'})
+          @obj.database('foo')
+        end
+      end
+
+      describe "#key" do
+        it "should update query with value" do
+          @obj.should_receive(:update_query).with({:key => 'foo'})
+          @obj.key('foo')
+        end
+        it "should raise error if startkey set" do
+          @obj.query[:startkey] = 'bar'
+          lambda { @obj.key('foo') }.should raise_error
+        end
+        it "should raise error if endkey set" do
+          @obj.query[:endkey] = 'bar'
+          lambda { @obj.key('foo') }.should raise_error
+        end
+        it "should raise error if both startkey and endkey set" do
+          @obj.query[:startkey] = 'bar'
+          @obj.query[:endkey] = 'bar'
+          lambda { @obj.key('foo') }.should raise_error
+        end
+        it "should raise error if keys set" do
+          @obj.query[:keys] = 'bar'
+          lambda { @obj.key('foo') }.should raise_error
+        end
+      end
+
+      describe "#startkey" do
+        it "should update query with value" do
+          @obj.should_receive(:update_query).with({:startkey => 'foo'})
+          @obj.startkey('foo')
+        end
+        it "should raise and error if key set" do
+          @obj.query[:key] = 'bar'
+          lambda { @obj.startkey('foo') }.should raise_error(/View#startkey/)
+        end
+        it "should raise and error if keys set" do
+          @obj.query[:keys] = 'bar'
+          lambda { @obj.startkey('foo') }.should raise_error(/View#startkey/)
+        end
+      end
+
+      describe "#startkey_doc" do
+        it "should update query with value" do
+          @obj.should_receive(:update_query).with({:startkey_docid => 'foo'})
+          @obj.startkey_doc('foo')
+        end
+        it "should update query with object id if available" do
+          doc = mock("Document")
+          doc.should_receive(:id).and_return(44)
+          @obj.should_receive(:update_query).with({:startkey_docid => 44})
+          @obj.startkey_doc(doc)
+        end
+      end
+
+      describe "#endkey" do
+        it "should update query with value" do
+          @obj.should_receive(:update_query).with({:endkey => 'foo'})
+          @obj.endkey('foo')
+        end
+        it "should raise and error if key set" do
+          @obj.query[:key] = 'bar'
+          lambda { @obj.endkey('foo') }.should raise_error(/View#endkey/)
+        end
+        it "should raise and error if keys set" do
+          @obj.query[:keys] = 'bar'
+          lambda { @obj.endkey('foo') }.should raise_error(/View#endkey/)
+        end
+      end
+
+      describe "#endkey_doc" do
+        it "should update query with value" do
+          @obj.should_receive(:update_query).with({:endkey_docid => 'foo'})
+          @obj.endkey_doc('foo')
+        end
+        it "should update query with object id if available" do
+          doc = mock("Document")
+          doc.should_receive(:id).and_return(44)
+          @obj.should_receive(:update_query).with({:endkey_docid => 44})
+          @obj.endkey_doc(doc)
+        end
+      end
+
+      describe "#keys" do
+        it "should update the query" do
+          @obj.should_receive(:update_query).with({:keys => ['foo', 'bar']})
+          @obj.keys(['foo', 'bar'])
+        end
+        it "should raise and error if key set" do
+          @obj.query[:key] = 'bar'
+          lambda { @obj.keys('foo') }.should raise_error(/View#keys/)
+        end
+        it "should raise and error if startkey or endkey set" do
+          @obj.query[:startkey] = 'bar'
+          lambda { @obj.keys('foo') }.should raise_error(/View#keys/)
+          @obj.query.delete(:startkey)
+          @obj.query[:endkey] = 'bar'
+          lambda { @obj.keys('foo') }.should raise_error(/View#keys/)
+        end
+      end
+
+      describe "#keys (without parameters)" do
+        it "should request each row and provide key value" do
+          row = mock("Row")
+          row.should_receive(:key).twice.and_return('foo')
+          @obj.should_receive(:rows).and_return([row, row])
+          @obj.keys.should eql(['foo', 'foo'])
+        end
+      end
+
+      describe "#descending" do
+        it "should update query" do
+          @obj.should_receive(:update_query).with({:descending => true})
+          @obj.descending
+        end
+        it "should reverse start and end keys if given" do
+          @obj = @obj.startkey('a').endkey('z')
+          @obj = @obj.descending
+          @obj.query[:endkey].should eql('a')
+          @obj.query[:startkey].should eql('z')
+        end
+        it "should reverse even if start or end nil" do
+          @obj = @obj.startkey('a')
+          @obj = @obj.descending
+          @obj.query[:endkey].should eql('a')
+          @obj.query[:startkey].should be_nil
+        end
+        it "should reverse start_doc and end_doc keys if given" do
+          @obj = @obj.startkey_doc('a').endkey_doc('z')
+          @obj = @obj.descending
+          @obj.query[:endkey_docid].should eql('a')
+          @obj.query[:startkey_docid].should eql('z')
+        end
+      end
+
+      describe "#limit" do
+        it "should update query with value" do
+          @obj.should_receive(:update_query).with({:limit => 3})
+          @obj.limit(3)
+        end
+      end
+
+      describe "#skip" do
+        it "should update query with value" do 
+          @obj.should_receive(:update_query).with({:skip => 3})
+          @obj.skip(3)
+        end
+        it "should update query with default value" do 
+          @obj.should_receive(:update_query).with({:skip => 0})
+          @obj.skip
+        end
+      end
+
+      describe "#reduce" do
+        it "should update query" do
+          @obj.should_receive(:can_reduce?).and_return(true)
+          @obj.should_receive(:update_query).with({:reduce => true, :include_docs => nil})
+          @obj.reduce
+        end
+        it "should raise error if query cannot be reduced" do
+          @obj.should_receive(:can_reduce?).and_return(false)
+          lambda { @obj.reduce }.should raise_error
+        end
+      end
+
+      describe "#group" do
+        it "should update query" do
+          @obj.should_receive(:query).and_return({:reduce => true})
+          @obj.should_receive(:update_query).with({:group => true})
+          @obj.group
+        end
+        it "should raise error if query not prepared for reduce" do
+          @obj.should_receive(:query).and_return({:reduce => false})
+          lambda { @obj.group }.should raise_error
+        end
+      end
+
+      describe "#group" do
+        it "should update query" do
+          @obj.should_receive(:query).and_return({:reduce => true})
+          @obj.should_receive(:update_query).with({:group => true})
+          @obj.group
+        end
+        it "should raise error if query not prepared for reduce" do
+          @obj.should_receive(:query).and_return({:reduce => false})
+          lambda { @obj.group }.should raise_error
+        end
+      end
+
+      describe "#group_level" do
+        it "should update query" do
+          @obj.should_receive(:group).and_return(@obj)
+          @obj.should_receive(:update_query).with({:group_level => 3})
+          @obj.group_level(3)
+        end
+      end
+
+      describe "#include_docs" do
+        it "should call include_docs! on new view" do
+          @obj.should_receive(:update_query).and_return(@obj)
+          @obj.should_receive(:include_docs!)
+          @obj.include_docs
+        end
+      end
+
+      describe "#reset!" do
+        it "should empty all cached data" do
+          @obj.should_receive(:result=).with(nil)
+          @obj.instance_exec { @rows = 'foo'; @docs = 'foo' }
+          @obj.reset!
+          @obj.instance_exec { @rows }.should be_nil
+          @obj.instance_exec { @docs }.should be_nil
+        end
+      end
+
+      #### PROTECTED METHODS
+
+      describe "#include_docs!" do
+        it "should set query value" do
+          @obj.should_receive(:result).and_return(false)
+          @obj.should_not_receive(:reset!)
+          @obj.send(:include_docs!)
+          @obj.query[:include_docs].should be_true
+        end
+        it "should reset if result and no docs" do
+          @obj.should_receive(:result).and_return(true)
+          @obj.should_receive(:include_docs?).and_return(false)
+          @obj.should_receive(:reset!)
+          @obj.send(:include_docs!)
+          @obj.query[:include_docs].should be_true
+        end
+        it "should raise an error if view is reduced" do
+          @obj.query[:reduce] = true
+          lambda { @obj.send(:include_docs!) }.should raise_error
+        end
+      end
+
+      describe "#include_docs?" do
+        it "should return true if set" do
+          @obj.should_receive(:query).and_return({:include_docs => true})
+          @obj.send(:include_docs?).should be_true
+        end
+        it "should return false if not set" do
+          @obj.should_receive(:query).and_return({})
+          @obj.send(:include_docs?).should be_false
+          @obj.should_receive(:query).and_return({:include_docs => false})
+          @obj.send(:include_docs?).should be_false
+        end
+      end
+
+      describe "#update_query" do
+        it "returns a new instance of view" do
+          @obj.send(:update_query).object_id.should_not eql(@obj.object_id)
+        end
+
+        it "returns a new instance of view with extra parameters" do
+          new_obj = @obj.send(:update_query, {:foo => :bar})
+          new_obj.query[:foo].should eql(:bar)
+        end
+      end
+
+      describe "#design_doc" do
+        it "should call design_doc on model" do
+          @obj.model.should_receive(:design_doc)
+          @obj.send(:design_doc)
+        end
+      end
+
+      describe "#can_reduce?" do
+        it "should check and prove true" do
+          @obj.should_receive(:name).and_return('test_view')
+          @obj.should_receive(:design_doc).and_return({'views' => {'test_view' => {'reduce' => 'foo'}}})
+          @obj.send(:can_reduce?).should be_true
+        end
+        it "should check and prove false" do
+          @obj.should_receive(:name).and_return('test_view')
+          @obj.should_receive(:design_doc).and_return({'views' => {'test_view' => {'reduce' => nil}}})
+          @obj.send(:can_reduce?).should be_false
+        end
+      end
+
+      describe "#execute" do
+        before :each do
+          # disable real execution!
+          @design_doc = mock("DesignDoc")
+          @design_doc.stub!(:view_on)
+          @obj.model.stub!(:save_design_doc)
+          @obj.model.stub!(:design_doc).and_return(@design_doc)
+        end
+
+        it "should return previous result if set" do
+          @obj.result = "foo"
+          @obj.send(:execute).should eql('foo')
+        end
+
+        it "should raise issue if no database" do
+          @obj.should_receive(:query).and_return({:database => nil})
+          model = mock("SomeModel")
+          model.should_receive(:database).and_return(nil)
+          @obj.should_receive(:model).and_return(model)
+          lambda { @obj.send(:execute) }.should raise_error
+        end
+
+        it "should delete the reduce option if not going to be used" do
+          @obj.should_receive(:can_reduce?).and_return(false)
+          @obj.query.should_receive(:delete).with(:reduce)
+          @obj.send(:execute)
+        end
+
+        it "should call to save the design document" do
+          @obj.should_receive(:can_reduce?).and_return(false)
+          @obj.model.should_receive(:save_design_doc).with(DB)
+          @obj.send(:execute)
+        end
+
+        it "should populate the results" do
+          @obj.should_receive(:can_reduce?).and_return(true)
+          @design_doc.should_receive(:view_on).and_return('foos')
+          @obj.send(:execute)
+          @obj.result.should eql('foos')
+        end
+
+        it "should remove nil values from query" do
+          @obj.should_receive(:can_reduce?).and_return(true)
+          @obj.stub!(:use_database).and_return('database')
+          @obj.query = {:reduce => true, :limit => nil, :skip => nil}
+          @design_doc.should_receive(:view_on).with('database', 'test_view', {:reduce => true})
+          @obj.send(:execute)
+        end
+
+
+      end
+
+      describe "pagination methods" do
+
+        describe "#page" do
+          it "should call limit and skip" do
+            @obj.should_receive(:limit).with(25).and_return(@obj)
+            @obj.should_receive(:skip).with(25).and_return(@obj)
+            @obj.page(2)
+          end
+        end
+
+        describe "#per" do
+          it "should raise an error if page not called before hand" do
+            lambda { @obj.per(12) }.should raise_error
+          end
+          it "should not do anything if number less than or eql 0" do
+            view = @obj.page(1)
+            view.per(0).should eql(view)
+          end
+          it "should set limit and update skip" do
+            view = @obj.page(2).per(10)
+            view.query[:skip].should eql(10)
+            view.query[:limit].should eql(10)
+          end
+        end
+
+        describe "#total_count" do
+          it "set limit and skip to nill and perform count" do
+            @obj.should_receive(:limit).with(nil).and_return(@obj)
+            @obj.should_receive(:skip).with(nil).and_return(@obj)
+            @obj.should_receive(:count).and_return(5)
+            @obj.total_count.should eql(5)
+            @obj.total_count.should eql(5) # Second to test caching
+          end
+        end
+
+        describe "#num_pages" do
+          it "should use total_count and limit_value" do
+            @obj.should_receive(:total_count).and_return(200)
+            @obj.should_receive(:limit_value).and_return(25)
+            @obj.num_pages.should eql(8)
+          end
+        end
+
+        describe "#current_page" do
+          it "should use offset and limit" do
+            @obj.should_receive(:offset_value).and_return(25)
+            @obj.should_receive(:limit_value).and_return(25)
+            @obj.current_page.should eql(2)
+          end
+        end
+      end
+    end
+  end
+
+  describe "ViewRow" do
+
+    before :all do
+      @klass = CouchRest::Model::Designs::ViewRow
+    end
+
+    describe "intialize" do
+      it "should store reference to model" do
+        obj = @klass.new({}, "model")
+        obj.model.should eql('model')
+      end
+      it "should copy details from hash" do
+        obj = @klass.new({:foo => :bar, :test => :example}, "")
+        obj[:foo].should eql(:bar)
+        obj[:test].should eql(:example)
+      end
+    end
+
+    describe "running" do
+      before :each do
+      end
+
+      it "should provide id" do
+        obj = @klass.new({'id' => '123456'}, 'model')
+        obj.id.should eql('123456')
+      end
+
+      it "should provide key" do
+        obj = @klass.new({'key' => 'thekey'}, 'model')
+        obj.key.should eql('thekey')
+      end
+
+      it "should provide the value" do
+        obj = @klass.new({'value' => 'thevalue'}, 'model')
+        obj.value.should eql('thevalue')
+      end
+
+      it "should provide the raw document" do
+        obj = @klass.new({'doc' => 'thedoc'}, 'model')
+        obj.raw_doc.should eql('thedoc')
+      end
+
+      it "should instantiate a new document" do
+        hash = {'doc' => {'_id' => '12345', 'name' => 'sam'}}
+        obj = @klass.new(hash, DesignViewModel)
+        doc = mock('DesignViewModel')
+        obj.model.should_receive(:build_from_database).with(hash['doc']).and_return(doc)
+        obj.doc.should eql(doc)
+      end
+
+      it "should try to load from id if no document" do
+        hash = {'id' => '12345', 'value' => 5}
+        obj = @klass.new(hash, DesignViewModel)
+        doc = mock('DesignViewModel')
+        obj.model.should_receive(:get).with('12345').and_return(doc)
+        obj.doc.should eql(doc)
+      end
+
+      it "should try to load linked document if available" do
+        hash = {'id' => '12345', 'value' => {'_id' => '54321'}}
+        obj = @klass.new(hash, DesignViewModel)
+        doc = mock('DesignViewModel')
+        obj.model.should_receive(:get).with('54321').and_return(doc)
+        obj.doc.should eql(doc)
+      end
+
+      it "should try to return nil for document if none available" do
+        hash = {'value' => 23} # simulate reduce
+        obj = @klass.new(hash, DesignViewModel)
+        doc = mock('DesignViewModel')
+        obj.model.should_not_receive(:get)
+        obj.doc.should be_nil
+      end
+
+
+    end
+   
+  end
+
+
+  describe "scenarios" do
+
+    before :all do
+      @objs = [
+        {:name => "Judith"},
+        {:name => "Lorena"},
+        {:name => "Peter"},
+        {:name => "Sam"},
+        {:name => "Vilma"}
+      ].map{|h| DesignViewModel.create(h)}
+    end
+
+    describe "loading documents" do
+      it "should return first" do
+        DesignViewModel.by_name.first.name.should eql("Judith")
+      end
+
+      it "should return last" do
+        DesignViewModel.by_name.last.name.should eql("Vilma")
+      end
+
+      it "should allow multiple results" do
+        view = DesignViewModel.by_name.limit(3)
+        view.total_rows.should eql(5)
+        view.last.name.should eql("Peter")
+        view.all.length.should eql(3)
+      end
+    end
+
+    describe "index information" do
+      it "should provide total_rows" do
+        DesignViewModel.by_name.total_rows.should eql(5)
+      end
+      it "should provide total_rows" do
+        DesignViewModel.by_name.total_rows.should eql(5)
+      end
+      it "should provide an offset" do
+        DesignViewModel.by_name.offset.should eql(0)
+      end
+      it "should provide a set of keys" do
+        DesignViewModel.by_name.limit(2).keys.should eql(["Judith", "Lorena"])
+      end
+    end
+
+    describe "viewing" do
+      it "should load views with no reduce method" do
+        docs = DesignViewModel.by_just_name.all
+        docs.length.should eql(5)
+      end
+      it "should load documents by specific keys" do
+        docs = DesignViewModel.by_name.keys(["Judith", "Peter"]).all
+        docs[0].name.should eql("Judith")
+        docs[1].name.should eql("Peter")
+      end
+      it "should provide count even if limit or skip set" do
+        docs = DesignViewModel.by_name.limit(20).skip(2)
+        docs.count.should eql(5)
+      end
+    end
+
+    describe "pagination" do
+      before :all do
+        DesignViewModel.paginates_per 3
+      end
+      before :each do
+        @view = DesignViewModel.by_name.page(1)
+      end
+
+      it "should calculate number of pages" do
+        @view.num_pages.should eql(2)
+      end
+      it "should return results from first page" do
+        @view.all.first.name.should eql('Judith')
+        @view.all.last.name.should eql('Peter')
+      end
+      it "should return results from second page" do
+        @view.page(2).all.first.name.should eql('Sam')
+        @view.page(2).all.last.name.should eql('Vilma')
+      end
+
+      it "should allow overriding per page count" do
+        @view = @view.per(10)
+        @view.num_pages.should eql(1)
+        @view.all.last.name.should eql('Vilma')
+      end
+    end
+
+  end
+
+
+end