cohitre-relaxdb 0.2.2

data/spec/has_one_spec.rb

@@ -0,0 +1,128 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.dirname(__FILE__) + '/spec_models.rb'
+
+describe RelaxDB::HasOneProxy do
+  
+  before(:all) do
+    RelaxDB.configure(:host => "localhost", :port => 5984)  
+  end
+
+  before(:each) do
+    RelaxDB.delete_db "relaxdb_spec_db" rescue "ok"
+    RelaxDB.use_db "relaxdb_spec_db"
+  end
+        
+  describe "has_one" do
+    
+    it "should return nil when accessed before assignment" do
+      p = Photo.new
+      p.rating.should == nil
+    end    
+    
+    it "should be establishable via a constructor attribute" do
+      r = Rating.new
+      p = Photo.new :rating => r
+      p.rating.should == r
+    end
+
+    it "should be establishable via assignment" do
+      p = Photo.new
+      r = Rating.new
+      p.rating = r
+      p.rating.should == r
+    end
+    
+    it "should return the same object on repeated invocations" do
+      p = Photo.new.save
+      p.rating = Rating.new
+      p = RelaxDB.load(p._id)
+      p.rating.object_id.should == p.rating.object_id
+    end
+    
+    it "should be preserved across load / save boundary" do
+      r = Rating.new
+      p = Photo.new(:rating => r).save
+      p = RelaxDB.load p._id
+      p.rating.should == r
+    end    
+    
+    it "should be able reference itself via its child" do
+      r = Rating.new
+      p = Photo.new(:rating => r).save
+      p = RelaxDB.load p._id
+      p.rating.photo.should == p
+    end        
+    
+    it "should work with MultiWordClassNames" do
+      c = MultiWordChild.new
+      m = MultiWordClass.new(:multi_word_child => c).save
+      m = RelaxDB.load m._id
+      m.multi_word_child.should == c
+    end
+           
+    describe "#=" do
+
+      it "should create a reference from the child to the parent" do
+        p = Photo.new
+        r = Rating.new
+        p.rating = r
+        r.photo.should == p
+      end
+
+      it "should save the assigned object" do
+        p = Photo.new
+        r = Rating.new
+        p.rating = r
+        r.should_not be_unsaved
+      end
+
+      it "will not save the parent" do
+        p = Photo.new
+        r = Rating.new
+        p.rating = r
+        p.should be_unsaved
+      end
+
+      it "should set the target to nil when nil is assigned" do
+        p = Photo.new
+        p.rating = nil
+        p.rating.should be_nil
+      end
+
+      it "should nullify any existing relationship in the database" do
+        p = Photo.new
+        r = Rating.new
+        p.rating = r
+        p.rating = nil
+        RelaxDB.load(r._id).photo.should be_nil
+      end
+
+      it "should nullify any existing relationship on a known in-memory object" do
+        p = Photo.new
+        r = Rating.new
+        p.rating = r
+        p.rating = nil
+        r.photo.should be_nil
+      end
+
+      it "will not nullify any existing relationship on unknown in-memory objects" do
+        p = Photo.new.save
+        r = Rating.new
+        p.rating = r
+        r_copy = RelaxDB.load(r._id)
+        p.rating = nil
+        r_copy.photo.should_not be_nil
+      end
+      
+      it "will not throw an error when the rhs fails validation" do
+        d = Dysfunctional.new.save
+        f = Failure.new
+        d.failure = f
+        d.failure.should == f
+      end
+
+    end  
+           
+  end
+      
+end

data/spec/query_spec.rb

@@ -0,0 +1,80 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.dirname(__FILE__) + '/spec_models.rb'
+
+describe RelaxDB::Query do
+
+  describe "#view_name" do
+
+    it "should match a single key attribute" do
+      q = RelaxDB::SortedByView.new("", :foo)
+      q.view_name.should == "all_sorted_by_foo"
+    end
+    
+    it "should match key attributes" do
+      q = RelaxDB::SortedByView.new("", :foo, :bar)
+      q.view_name.should == "all_sorted_by_foo_and_bar"
+    end
+  end
+  
+  describe "#view_path" do
+    
+    it "should list design document and view name" do
+      q = RelaxDB::Query.new("Zenith", "mount")
+      q.view_path.should == "_view/Zenith/mount"
+    end
+    
+    it "should contain URL and JSON encoded key when the key has been set" do
+      q = RelaxDB::Query.new("", "")
+      q.key("olympus")
+      q.view_path.should == "_view//?key=%22olympus%22"
+    end
+    
+    it "should honour startkey, endkey and count" do
+      q = RelaxDB::Query.new("", "")
+      q.startkey(["olympus"]).endkey(["vesuvius", 3600]).count(100)
+      q.view_path.should == "_view//?startkey=%5B%22olympus%22%5D&endkey=%5B%22vesuvius%22%2C3600%5D&count=100"
+    end
+        
+    it "should specify a null key if key was set to nil" do
+      q = RelaxDB::Query.new("", "")
+      q.key(nil)
+      q.view_path.should == "_view//?key=null"
+    end
+
+    it "should specify a null startkey if startkey was set to nil" do
+      q = RelaxDB::Query.new("", "")
+      q.startkey(nil)
+      q.view_path.should == "_view//?startkey=null"
+    end
+
+    it "should specify a null endkey if endkey was set to nil" do
+      q = RelaxDB::Query.new("", "")
+      q.endkey(nil)
+      q.view_path.should == "_view//?endkey=null"
+    end
+    
+    it "should not JSON encode the startkey_docid" do
+      q = RelaxDB::Query.new("", "")
+      q.startkey_docid("foo")
+      q.view_path.should == "_view//?startkey_docid=foo"
+    end
+
+    it "should not JSON encode the endkey_docid" do
+      q = RelaxDB::Query.new("", "")
+      q.endkey_docid("foo")
+      q.view_path.should == "_view//?endkey_docid=foo"
+    end
+    
+  end  
+  
+  describe "#keys" do
+    
+    it "should return a JSON encoded hash" do
+      q = RelaxDB::Query.new("", "")
+      q.keys(["a", "b"])
+      q.keys.should == '{"keys":["a","b"]}'
+    end
+    
+  end
+      
+end

data/spec/references_many_spec.rb

@@ -0,0 +1,141 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.dirname(__FILE__) + '/spec_models.rb'
+
+describe RelaxDB::ReferencesManyProxy do
+
+  before(:all) do
+    RelaxDB.configure(:host => "localhost", :port => 5984)  
+  end
+
+  before(:each) do
+    RelaxDB.delete_db "relaxdb_spec_db" rescue "ok"
+    RelaxDB.use_db "relaxdb_spec_db"
+  end
+
+  describe "references_many" do
+    
+    it "is now deprecated and will be removed in the near future" do
+    end
+    
+    it "should preserve the relationships across the save / load boundary" do
+      p = Photo.new
+      t = Tag.new
+      t.photos << p
+    
+      p = RelaxDB.load p._id
+      p.tags.size.should == 1
+      p.tags[0].should == t
+
+      t = RelaxDB.load t._id
+      t.photos.size.should == 1
+      t.photos[0].should == p
+    end
+  
+    describe "#=" do
+      it "should not be invoked" do
+      end
+    end
+      
+    describe "#<<" do
+      
+      it "should set the relationship on both sides" do
+        p = Photo.new(:name => "photo")
+        t = Tag.new(:name => "tag")
+        p.tags << t
+    
+        p.tags.size.should == 1
+        p.tags[0].name.should == "tag"
+    
+        t.photos.size.should == 1
+        t.photos[0].name.should == "photo"
+      end
+      
+      it "should not create duplicates when the same object is added more than once" do
+        p = Photo.new
+        t = Tag.new
+        p.tags << t << t
+        p.tags.size.should == 1
+      end      
+      
+      it "should not create duplicates when reciprocal objects are added from opposite sides" do
+        p = Photo.new
+        t = Tag.new
+        p.tags << t
+        t.photos << p
+        p.tags.size.should == 1
+        t.photos.size.should == 1
+      end
+
+    end
+
+    describe "#delete" do
+
+      it "should nullify relationship on both sides" do
+        p = Photo.new
+        t = Tag.new
+        p.tags << t
+
+        p.tags.delete(t)
+        p.tags.should be_empty
+        t.photos.should be_empty
+      end
+      
+    end
+    
+    describe "owner#destroy" do
+      
+      it "will not remove its membership from its peers in memory" do
+        # Documentating behaviour, not stating that this behaviour is desired
+        p = Photo.new
+        t = Tag.new
+        p.tags << t
+
+        p.destroy!
+        t.photos.size.should == 1
+      end
+
+      it "should remove its membership from its peers in CouchDB" do
+        p = Photo.new
+        t = Tag.new
+        p.tags << t
+
+        p.destroy!
+        RelaxDB.load(t._id).photos.should be_empty
+      end
+      
+    end  
+    
+    # Leaving this test as a reminder of problems with all.destroy and a self referential 
+    # references_many until references_many is removed
+    #
+    # This test more complex than it needs to be to prove the point
+    # It also serves as a proof of a self referential references_many, but there are better places for that
+    # it "all.destroy should play nice with self referential references_many" do
+    #   u1 = TwitterUser.new(:name => "u1")
+    #   u2 = TwitterUser.new(:name => "u2")
+    #   u3 = TwitterUser.new(:name => "u3")
+    #   
+    #   u1.followers << u2
+    #   u1.followers << u3
+    #   u3.leaders << u2
+    #   
+    #   u1f = u1.followers.map { |u| u.name }
+    #   u1f.sort.should == ["u2", "u3"]
+    #   u1.leaders.should be_empty
+    #   
+    #   u2.leaders.size.should == 1
+    #   u2.leaders[0].name.should == "u1"
+    #   u2.followers.size.should == 1
+    #   u2.followers[0].name.should == "u3"
+    #   
+    #   u3l = u3.leaders.map { |u| u.name }
+    #   u3l.sort.should == ["u1", "u2"]
+    #   u3.followers.should be_empty
+    #   
+    #   TwitterUser.all.destroy!
+    #   TwitterUser.all.should be_empty
+    # end
+          
+  end
+
+end

data/spec/relaxdb_spec.rb

@@ -0,0 +1,137 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.dirname(__FILE__) + '/spec_models.rb'
+
+describe RelaxDB do
+
+  before(:all) do
+    RelaxDB.configure(:host => "localhost", :port => 5984)  
+  end
+
+  before(:each) do
+    RelaxDB.delete_db "relaxdb_spec_db" rescue "ok"
+    RelaxDB.use_db "relaxdb_spec_db"
+  end
+        
+  describe ".create_object" do
+    
+    it "should return an instance of a known object if passed a hash with a class key" do
+      data = { "class" => "Item" }
+      obj = RelaxDB.create_object(data)
+      obj.should be_instance_of(Item)
+    end
+    
+    it "should return an instance of a dynamically created object if no class key is provided" do
+      data = { "name" => "tesla coil", "strength" => 5000 }
+      obj = RelaxDB.create_object(data)
+      obj.name.should == "tesla coil"
+      obj.strength.should == 5000
+    end
+    
+  end  
+      
+  describe ".bulk_save" do
+    
+    it "should be invokable multiple times" do
+      t1 = Tag.new(:name => "t1")
+      t2 = Tag.new(:name => "t2")
+      RelaxDB.bulk_save(t1, t2)
+      RelaxDB.bulk_save(t1, t2)
+    end
+    
+    it "should succeed when passed no args" do
+      RelaxDB.bulk_save
+    end
+    
+  end
+  
+  describe ".replicate_db" do
+    
+    it "should replicate the named database" do
+      orig = "relaxdb_spec_db"
+      replica = "relaxdb_spec_db_replica"
+      RelaxDB.delete_db replica rescue "ok"
+      Atom.new.save # implicitly saved to orig
+      RelaxDB.replicate_db orig, replica
+      RelaxDB.use_db replica
+      Atom.all.size.should == 1
+    end
+    
+  end
+  
+  describe ".load" do
+    
+    it "should load a single document" do
+      a = Atom.new.save
+      ar = RelaxDB.load a._id
+      ar.should == a
+    end
+    
+    it "should load an arbitrary number of documents" do
+      a1, a2 = Atom.new.save, Atom.new.save
+      ar1, ar2 = RelaxDB.load a1._id, a2._id
+      ar1.should == a1
+      ar2.should == a2
+    end
+    
+  end
+  
+  describe ".view" do
+    
+    map_func = %Q<
+      function (doc) {
+        emit(doc._id, doc);
+      }
+    >
+    
+    it "should request a view and return a hash" do
+      RelaxDB::DesignDocument.get("viewtest").add_view("simple", "map", map_func).save
+      data = RelaxDB.view("viewtest", "simple")
+      data.should be_instance_of(Hash)
+    end
+
+    it "may accept a block" do
+      RelaxDB::DesignDocument.get("viewtest").add_view("simple", "map", map_func).save
+      RelaxDB.db.put("x", {}.to_json)      
+      RelaxDB.db.put("y", {}.to_json)      
+      data = RelaxDB.view("viewtest", "simple") { |q| q.key("x") }
+      data["rows"].size.should == 1
+    end
+    
+    it "should be queryable with a multi key post" do
+      5.times { |i| Primitives.new(:num => i).save }
+      # Create the view
+      Primitives.all.sorted_by(:num) 
+      resp = RelaxDB.view("Primitives", "all_sorted_by_num") do |q| 
+        q.keys([0, 4])
+        q.reduce(false).group(true) # group invocation should hopefully be temporary
+      end
+      RelaxDB.instantiate(resp).map{ |p| p.num }.should == [0, 4]
+    end
+    
+  end
+  
+  describe ".merge" do
+    
+    it "should merge rows sharing a common merge key into a single ViewObject" do
+      rows = [
+        {"value" => {"sculptor_id" => 1, "sculpture_name" => "strandbeesten"} },
+        {"value" => {"sculptor_id" => 1, "sculptor_name" => "hans"} },
+        {"value" => {"sculptor_id" => 2, "sculpture_name" => "parading dogs"} },
+        {"value" => {"sculptor_id" => 2, "sculptor_name" => "holmes"} }
+      ]
+      data = {"rows" => rows}
+      result = RelaxDB.merge(data, "sculptor_id")
+      result = result.sort { |a, b| a.sculptor_name <=> b.sculptor_name }      
+
+      result[0].sculptor_name.should == "hans"
+      result[0].sculpture_name.should == "strandbeesten"
+      result[1].sculptor_name.should == "holmes"
+      result[1].sculpture_name.should == "parading dogs"
+    end
+        
+  end
+  
+  # if caching is added
+  # it "should offer an example where behaviour is different with caching enabled and caching disabled"
+            
+end