ceritium-relaxdb 0.2.8

data/spec/relaxdb_spec.rb

@@ -0,0 +1,226 @@
+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  
+
+  # bulk_save and bulk_save! should match Document#save and Document#save! semantics
+  describe ".bulk_save" do
+    
+    it "should be invokable multiple times" do
+      t1, t2 = Tag.new, Tag.new
+      RelaxDB.bulk_save(t1, t2)
+      RelaxDB.bulk_save(t1, t2)
+    end
+    
+    it "should return the objects it was passed" do
+      t1, t2 = Tag.new, Tag.new
+      ta, tb = RelaxDB.bulk_save(t1, t2)
+      ta.should == t1
+      tb.should == t2
+    end
+    
+    it "should succeed when passed no args" do
+      RelaxDB.bulk_save
+    end
+    
+    it "should return false on failure" do
+      c = Class.new(RelaxDB::Document) do
+        property :foo, :validator => lambda { false }
+      end
+      x = c.new
+      RelaxDB.bulk_save(x).should be_false
+    end
+
+    it "should not attempt to save if a pre-save stage fails" do
+      c = Class.new(RelaxDB::Document) do
+        property :foo, :validator => lambda { false }
+      end
+      x = c.new
+      RelaxDB.bulk_save(x)
+      x.should be_new_document
+    end
+    
+    it "should invoke the after-save stage after a successful save" do
+      c = Class.new(RelaxDB::Document) do
+        attr_accessor :foo
+        after_save lambda { |c| c.foo = :bar }
+      end
+      x = c.new
+      RelaxDB.bulk_save(x).first.foo.should == :bar
+    end
+    
+  end
+  
+  describe ".bulk_save!" do
+    
+    it "should raise an exception if a obj fails validation" do
+      c = Class.new(RelaxDB::Document) do
+        property :foo, :validator => lambda { false }
+      end
+      lambda { RelaxDB.bulk_save!(c.new) }.should raise_error(RelaxDB::ValidationFailure)
+    end
+    
+    it "should raise an exception if a document update conflict occurs on save" do
+      Atom.new(:_id => "a1").save!
+      lambda { RelaxDB.bulk_save! Atom.new(:_id => "a1") }.should raise_error(RelaxDB::UpdateConflict)
+    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
+    
+    it "should return nil when given a id for a non existant doc" do
+      RelaxDB.load("nothere").should be_nil
+    end
+    
+    it "should return an array with correctly placed nils when given a list containing non existant doc ids" do
+      a1, a2 = Atom.new.save, Atom.new.save
+      res = RelaxDB.load [nil, a1._id, nil, a2._id, nil]
+      res.should == [nil, a1, nil, a2, nil]
+    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 multiple 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
+    
+    it "should throw an exception if given a single id for a non-existant doc" do
+      lambda do
+        RelaxDB.load! "nothere"
+      end.should raise_error(RelaxDB::NotFound)
+    end
+    
+    it "should throw an exception if any of a list of doc ids is for a non-existant doc" do
+      a = Atom.new.save
+      lambda do
+        RelaxDB.load! [nil, a._id]
+      end.should raise_error(RelaxDB::NotFound)
+    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

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'relaxdb'

data/spec/spec_models.rb

@@ -0,0 +1,151 @@
+#
+# RSpec loads this file multiple times, thus breaking invocations like Document.has_one_rels
+# The following clause ensures the tests pass, but perhaps Document should raise a warning 
+# if it's loaded more than once...
+#
+unless @spec_models_loaded
+
+  class Atom < RelaxDB::Document
+  end
+
+  class Initiative < RelaxDB::Document
+    property :x
+    attr_reader :foo
+    def initialize(data)
+      data[:_id] = data[:x]
+      super data
+      @foo = :bar
+    end
+  end
+
+  class Primitives < RelaxDB::Document
+  
+    property :str
+    property :num
+    property :true_bool
+    property :false_bool
+    property :created_at
+    property :empty
+  
+  end
+
+  class BespokeReader < RelaxDB::Document
+    property :val
+    def val; @val + 5; end
+  end
+
+  class BespokeWriter < RelaxDB::Document
+    property :val
+    def val=(v); @val = v - 10; end
+  end
+
+  class Letter < RelaxDB::Document
+  
+    property :letter
+    property :number
+  
+  end
+
+  class Invite < RelaxDB::Document
+  
+    property :message
+  
+    belongs_to :sender
+    belongs_to :recipient
+    
+  end
+
+  class Item < RelaxDB::Document
+  
+    property :name
+    belongs_to :user
+  
+  end
+
+  class User < RelaxDB::Document
+  
+    property :name, :default => "u" 
+    property :age
+  
+    has_many :items, :class => "Item"
+  
+    has_many :invites_received, :class => "Invite", :known_as => :recipient
+    has_many :invites_sent, :class => "Invite", :known_as => :sender
+  
+  end
+
+  class Post < RelaxDB::Document
+  
+    property :subject
+    property :content
+    property :created_at
+    property :viewed_at
+  
+  end
+
+  class Rating < RelaxDB::Document
+
+    property :stars, :default => 5
+    belongs_to :photo
+
+  end
+
+  class Photo < RelaxDB::Document
+  
+    property :name
+  
+    has_one :rating
+  
+    references_many :tags, :class => "Tag", :known_as => :photos
+  
+    has_many :taggings, :class => "Tagging"
+
+  end
+
+  class Tag < RelaxDB::Document
+  
+    property :name
+    references_many :photos, :class => "Photo", :known_as => :tags
+  
+    has_many :taggings, :class => "Tagging"
+  
+  end
+
+  class Tagging < RelaxDB::Document
+
+    belongs_to :photo
+    belongs_to :tag
+    property :relevance  
+
+  end
+
+  class MultiWordClass < RelaxDB::Document
+    has_one :multi_word_child
+    has_many :multi_word_children, :class => "MultiWordChild"
+  end
+
+  class MultiWordChild < RelaxDB::Document
+    belongs_to :multi_word_class
+  end
+
+  class TwitterUser < RelaxDB::Document
+  
+    property :name
+    references_many :followers, :class => "User", :known_as => :leaders
+    references_many :leaders, :class => "User", :known_as => :followers
+  
+  end
+
+  class Dysfunctional < RelaxDB::Document
+    has_one :failure
+    has_many :failures, :class => "Failure"
+  end
+
+  class Failure < RelaxDB::Document
+    property :pathological, :validator => lambda { false }
+    belongs_to :dysfunctional
+  end
+
+  @spec_models_loaded = true
+
+end

data/spec/view_object_spec.rb

@@ -0,0 +1,47 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.dirname(__FILE__) + '/spec_models.rb'
+
+describe RelaxDB::ViewObject do
+  
+  describe ".new" do 
+    
+    it "should provide readers for the object passed in the hash" do
+      data = { :name => "chaise", :variety => "longue" }
+      obj = RelaxDB::ViewObject.new(data)
+      obj.name.should == "chaise"
+      obj.variety.should == "longue"
+    end
+    
+    it "should try to convert objects ending in _at to a time" do
+      now = Time.now
+      data = { :ends_at => now.to_s }
+      obj = RelaxDB::ViewObject.new(data)
+      obj.ends_at.should be_close(now, 1)
+    end
+    
+  end
+  
+  describe ".create" do
+    
+    it "should return an array of view objects when passed an array" do
+      data = [ {:half_life => 2}, {:half_life => 16} ]
+      obj = RelaxDB::ViewObject.create(data)
+      obj.size.should == 2
+      obj[0].half_life.should == 2
+      obj[1].half_life.should == 16
+    end
+
+    it "should return a view object when passed a hash" do
+      data = {:half_life => 32}
+      obj = RelaxDB::ViewObject.create(data)
+      obj.half_life.should == 32
+    end
+    
+    it "should return a simple value when passed a primitive" do
+      obj = RelaxDB::ViewObject.create(10)
+      obj.should == 10
+    end
+    
+  end
+  
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: ceritium-relaxdb
+version: !ruby/object:Gem::Version 
+  version: 0.2.8
+platform: ruby
+authors: 
+- Paul Carey
+autorequire: relaxdb
+bindir: bin
+cert_chain: []
+
+date: 2009-02-02 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: extlib
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.4
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: uuid
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: paul.p.carey@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- README.textile
+- Rakefile
+- docs/spec_results.html
+- lib/relaxdb
+- lib/relaxdb/all_delegator.rb
+- lib/relaxdb/belongs_to_proxy.rb
+- lib/relaxdb/design_doc.rb
+- lib/relaxdb/document.rb
+- lib/relaxdb/extlib.rb
+- lib/relaxdb/has_many_proxy.rb
+- lib/relaxdb/has_one_proxy.rb
+- lib/relaxdb/paginate_params.rb
+- lib/relaxdb/paginator.rb
+- lib/relaxdb/query.rb
+- lib/relaxdb/references_many_proxy.rb
+- lib/relaxdb/relaxdb.rb
+- lib/relaxdb/server.rb
+- lib/relaxdb/sorted_by_view.rb
+- lib/relaxdb/uuid_generator.rb
+- lib/relaxdb/validators.rb
+- lib/relaxdb/view_object.rb
+- lib/relaxdb/view_result.rb
+- lib/relaxdb/view_uploader.rb
+- lib/relaxdb/views.rb
+- lib/more/grapher.rb
+- lib/relaxdb.rb
+- lib/more/atomic_bulk_save_support.rb
+- spec/belongs_to_spec.rb
+- spec/callbacks_spec.rb
+- spec/design_doc_spec.rb
+- spec/derived_properties_spec.rb
+- spec/document_spec.rb
+- spec/has_many_spec.rb
+- spec/has_one_spec.rb
+- spec/query_spec.rb
+- spec/references_many_spec.rb
+- spec/relaxdb_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/spec_models.rb
+- spec/view_object_spec.rb
+has_rdoc: false
+homepage: http://github.com/paulcarey/relaxdb/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: RelaxDB provides a simple interface to CouchDB
+test_files: []
+