sequel 1.3 → 1.4.0

data/spec/plugins_spec.rb

@@ -0,0 +1,74 @@
+require File.join(File.dirname(__FILE__), "spec_helper")
+
+module Sequel::Plugins
+
+  module Timestamped
+    def self.apply(m, opts)
+      m.class_def(:get_stamp) {@values[:stamp]}
+      m.meta_def(:stamp_opts) {opts}
+      m.before_save {@values[:stamp] = Time.now}
+    end
+    
+    module InstanceMethods
+      def abc; timestamped_opts; end
+    end
+    
+    module ClassMethods
+      def deff; timestamped_opts; end
+    end
+
+    module DatasetMethods
+      def ghi; timestamped_opts; end
+    end
+  end
+
+end
+
+describe Sequel::Model, "using a plugin" do
+
+  it "should fail if the plugin is not found" do
+    proc do
+      c = Class.new(Sequel::Model) do
+        is :something_or_other
+      end
+    end.should raise_error(LoadError)
+  end
+  
+  it "should apply the plugin to the class" do
+    c = nil
+    proc do
+      c = Class.new(Sequel::Model) do
+        set_dataset MODEL_DB[:items]
+        is :timestamped, :a => 1, :b => 2
+      end
+    end.should_not raise_error(LoadError)
+    
+    c.should respond_to(:stamp_opts)
+    c.stamp_opts.should == {:a => 1, :b => 2}
+    
+    # instance methods
+    m = c.new
+    m.should respond_to(:get_stamp)
+    m.should respond_to(:abc)
+    m.abc.should == {:a => 1, :b => 2}
+    t = Time.now
+    m[:stamp] = t
+    m.get_stamp.should == t
+    
+    # class methods
+    c.should respond_to(:deff)
+    c.deff.should == {:a => 1, :b => 2}
+    
+    # dataset methods
+    c.dataset.should respond_to(:ghi)
+    c.dataset.ghi.should == {:a => 1, :b => 2}
+  end
+  
+  it "should fail to apply if the plugin has DatasetMethod and the model has no datset" do
+    proc do
+      Class.new(Sequel::Model) do
+        is :timestamped, :a => 1, :b => 2
+      end
+    end.should raise_error(Sequel::Error)
+  end
+end

data/spec/rcov.opts

@@ -0,0 +1,4 @@
+--exclude
+gems
+--exclude
+spec

data/spec/record_spec.rb

@@ -0,0 +1,593 @@
+require File.join(File.dirname(__FILE__), "spec_helper")
+
+describe "Model#save" do
+  
+  before(:each) do
+    MODEL_DB.reset
+
+    @c = Class.new(Sequel::Model(:items)) do
+      def columns
+        [:id, :x, :y]
+      end
+    end
+  end
+  
+  it "should insert a record for a new model instance" do
+    o = @c.new(:x => 1)
+    o.save
+    
+    MODEL_DB.sqls.first.should == "INSERT INTO items (x) VALUES (1)"
+  end
+
+  it "should update a record for an existing model instance" do
+    o = @c.load(:id => 3, :x => 1)
+    o.save
+    
+    MODEL_DB.sqls.first.should =~ 
+      /UPDATE items SET (id = 3, x = 1|x = 1, id = 3) WHERE \(id = 3\)/
+  end
+  
+  it "should update only the given columns if given" do
+    o = @c.load(:id => 3, :x => 1, :y => nil)
+    o.save(:y)
+    
+    MODEL_DB.sqls.first.should == "UPDATE items SET y = NULL WHERE (id = 3)"
+  end
+  
+  it "should mark saved columns as not changed" do
+    o = @c.new(:id => 3, :x => 1, :y => nil)
+    o[:y] = 4
+    o.changed_columns.should == [:y]
+    o.save(:x)
+    o.changed_columns.should == [:y]
+    o.save(:y)
+    o.changed_columns.should == []
+  end
+  
+end
+
+describe "Model#save_changes" do
+  
+  before(:each) do
+    MODEL_DB.reset
+
+    @c = Class.new(Sequel::Model(:items)) do
+      def columns
+        [:id, :x, :y]
+      end
+    end
+  end
+  
+  it "should do nothing if no changed columns" do
+    o = @c.new(:id => 3, :x => 1, :y => nil)
+    o.save_changes
+    
+    MODEL_DB.sqls.should be_empty
+
+    o = @c.load(:id => 3, :x => 1, :y => nil)
+    o.save_changes
+    
+    MODEL_DB.sqls.should be_empty
+  end
+  
+  it "should update only changed columns" do
+    o = @c.load(:id => 3, :x => 1, :y => nil)
+    o.x = 2
+
+    o.save_changes
+    MODEL_DB.sqls.should == ["UPDATE items SET x = 2 WHERE (id = 3)"]
+    o.save_changes
+    o.save_changes
+    MODEL_DB.sqls.should == ["UPDATE items SET x = 2 WHERE (id = 3)"]
+    MODEL_DB.reset
+
+    o.y = 4
+    o.save_changes
+    MODEL_DB.sqls.should == ["UPDATE items SET y = 4 WHERE (id = 3)"]
+    o.save_changes
+    o.save_changes
+    MODEL_DB.sqls.should == ["UPDATE items SET y = 4 WHERE (id = 3)"]
+  end
+  
+  it "should not consider columns changed if the values did not change" do
+    o = @c.load(:id => 3, :x => 1, :y => nil)
+    o.x = 1
+
+    o.save_changes
+    MODEL_DB.sqls.should == []
+    o.x = 3
+    o.save_changes
+    MODEL_DB.sqls.should == ["UPDATE items SET x = 3 WHERE (id = 3)"]
+    MODEL_DB.reset
+
+    o[:y] = nil
+    o.save_changes
+    MODEL_DB.sqls.should == []
+    o[:y] = 4
+    o.save_changes
+    MODEL_DB.sqls.should == ["UPDATE items SET y = 4 WHERE (id = 3)"]
+  end
+end
+
+describe "Model#set" do
+  
+  before(:each) do
+    MODEL_DB.reset
+
+    @c = Class.new(Sequel::Model(:items)) do
+      def columns
+        [:id, :x, :y]
+      end
+    end
+  end
+  
+  it "should generate an update statement" do
+    o = @c.new(:id => 1)
+    o.set(:x => 1)
+    MODEL_DB.sqls.first.should == "UPDATE items SET x = 1 WHERE (id = 1)"
+  end
+  
+  it "should update attribute values" do
+    o = @c.new(:id => 1)
+    o.x.should be_nil
+    o.set(:x => 1)
+    o.x.should == 1
+  end
+  
+  it "should support string keys" do
+    o = @c.new(:id => 1)
+    o.x.should be_nil
+    o.set('x' => 1)
+    o.x.should == 1
+    MODEL_DB.sqls.first.should == "UPDATE items SET x = 1 WHERE (id = 1)"
+  end
+  
+  it "should be aliased by #update" do
+    o = @c.new(:id => 1)
+    o.update(:x => 1)
+    MODEL_DB.sqls.first.should == "UPDATE items SET x = 1 WHERE (id = 1)"
+  end
+end
+
+
+describe "Model#new?" do
+  
+  before(:each) do
+    MODEL_DB.reset
+
+    @c = Class.new(Sequel::Model(:items)) do
+    end
+  end
+  
+  it "should be true for a new instance" do
+    n = @c.new(:x => 1)
+    n.should be_new
+  end
+  
+  it "should be false after saving" do
+    n = @c.new(:x => 1)
+    n.save
+    n.should_not be_new
+  end
+  
+  it "should alias new_record? to new?" do
+    n = @c.new(:x => 1)
+    n.should respond_to(:new_record?)
+    n.should be_new_record
+    n.save
+    n.should_not be_new_record
+  end
+  
+end
+
+describe Sequel::Model, "w/ primary key" do
+  
+  it "should default to ':id'" do
+    model_a = Class.new Sequel::Model
+    model_a.primary_key.should be_equal(:id)
+  end
+
+  it "should be changed through 'set_primary_key'" do
+    model_a = Class.new(Sequel::Model) { set_primary_key :a }
+    model_a.primary_key.should be_equal(:a)
+  end
+
+  it "should support multi argument composite keys" do
+    model_a = Class.new(Sequel::Model) { set_primary_key :a, :b }
+    model_a.primary_key.should be_eql([:a, :b])
+  end
+
+  it "should accept single argument composite keys" do
+    model_a = Class.new(Sequel::Model) { set_primary_key [:a, :b] }
+    model_a.primary_key.should be_eql([:a, :b])
+  end
+  
+end
+
+describe Sequel::Model, "w/o primary key" do
+  it "should return nil for primary key" do
+    Class.new(Sequel::Model) { no_primary_key }.primary_key.should be_nil
+  end
+
+  it "should raise a Sequel::Error on 'this'" do
+    instance = Class.new(Sequel::Model) { no_primary_key }.new
+    proc { instance.this }.should raise_error(Sequel::Error)
+  end
+end
+
+describe Sequel::Model, "with this" do
+
+  before { @example = Class.new Sequel::Model(:examples) }
+
+  it "should return a dataset identifying the record" do
+    instance = @example.new :id => 3
+    instance.this.sql.should be_eql("SELECT * FROM examples WHERE (id = 3) LIMIT 1")
+  end
+
+  it "should support arbitary primary keys" do
+    @example.set_primary_key :a
+
+    instance = @example.new :a => 3
+    instance.this.sql.should be_eql("SELECT * FROM examples WHERE (a = 3) LIMIT 1")
+  end
+
+  it "should support composite primary keys" do
+    @example.set_primary_key :x, :y
+    instance = @example.new :x => 4, :y => 5
+
+    parts = [
+      'SELECT * FROM examples WHERE %s LIMIT 1',
+      '(x = 4) AND (y = 5)', 
+      '(y = 5) AND (x = 4)'
+    ].map { |expr| Regexp.escape expr }
+    regexp = Regexp.new parts.first % "(?:#{parts[1]}|#{parts[2]})"
+
+    instance.this.sql.should match(regexp)
+  end
+
+end
+
+describe "Model#pk" do
+  before(:each) do
+    @m = Class.new(Sequel::Model)
+  end
+  
+  it "should be default return the value of the :id column" do
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    m.pk.should == 111
+  end
+
+  it "should be return the primary key value for custom primary key" do
+    @m.set_primary_key :x
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    m.pk.should == 2
+  end
+
+  it "should be return the primary key value for composite primary key" do
+    @m.set_primary_key [:y, :x]
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    m.pk.should == [3, 2]
+  end
+
+  it "should raise if no primary key" do
+    @m.set_primary_key nil
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    proc {m.pk}.should raise_error(Sequel::Error)
+
+    @m.no_primary_key
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    proc {m.pk}.should raise_error(Sequel::Error)
+  end
+end
+
+describe "Model#pk_hash" do
+  before(:each) do
+    @m = Class.new(Sequel::Model)
+  end
+  
+  it "should be default return the value of the :id column" do
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    m.pk_hash.should == {:id => 111}
+  end
+
+  it "should be return the primary key value for custom primary key" do
+    @m.set_primary_key :x
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    m.pk_hash.should == {:x => 2}
+  end
+
+  it "should be return the primary key value for composite primary key" do
+    @m.set_primary_key [:y, :x]
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    m.pk_hash.should == {:y => 3, :x => 2}
+  end
+
+  it "should raise if no primary key" do
+    @m.set_primary_key nil
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    proc {m.pk_hash}.should raise_error(Sequel::Error)
+
+    @m.no_primary_key
+    m = @m.new(:id => 111, :x => 2, :y => 3)
+    proc {m.pk_hash}.should raise_error(Sequel::Error)
+  end
+end
+
+describe Sequel::Model, "update_with_params" do
+
+  before(:each) do
+    MODEL_DB.reset
+    
+    @c = Class.new(Sequel::Model(:items)) do
+      def self.columns; [:x, :y]; end
+    end
+    @o1 = @c.new
+    @o2 = @c.load(:id => 5)
+  end
+  
+  it "should filter the given params using the model columns" do
+    @o1.update_with_params(:x => 1, :z => 2)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (x) VALUES (1)"
+
+    MODEL_DB.reset
+    @o2.update_with_params(:y => 1, :abc => 2)
+    MODEL_DB.sqls.first.should == "UPDATE items SET y = 1 WHERE (id = 5)"
+  end
+  
+  it "should be aliased by create_with" do
+    @o1.update_with(:x => 1, :z => 2)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (x) VALUES (1)"
+
+    MODEL_DB.reset
+    @o2.update_with(:y => 1, :abc => 2)
+    MODEL_DB.sqls.first.should == "UPDATE items SET y = 1 WHERE (id = 5)"
+  end
+  
+  it "should support virtual attributes" do
+    @c.class_def(:blah=) {|v| self.x = v}
+    @o1.update_with(:blah => 333)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (x) VALUES (333)"
+  end
+end
+
+describe Sequel::Model, "create_with_params" do
+
+  before(:each) do
+    MODEL_DB.reset
+    
+    @c = Class.new(Sequel::Model(:items)) do
+      def self.columns; [:x, :y]; end
+    end
+  end
+  
+  it "should filter the given params using the model columns" do
+    @c.create_with_params(:x => 1, :z => 2)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (x) VALUES (1)"
+
+    MODEL_DB.reset
+    @c.create_with_params(:y => 1, :abc => 2)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (y) VALUES (1)"
+  end
+  
+  it "should be aliased by create_with" do
+    @c.create_with(:x => 1, :z => 2)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (x) VALUES (1)"
+
+    MODEL_DB.reset
+    @c.create_with(:y => 1, :abc => 2)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (y) VALUES (1)"
+  end
+  
+  it "should support virtual attributes" do
+    @c.class_def(:blah=) {|v| self.x = v}
+    o = @c.create_with(:blah => 333)
+    MODEL_DB.sqls.first.should == "INSERT INTO items (x) VALUES (333)"
+  end
+end
+
+describe Sequel::Model, "#destroy" do
+
+  before(:each) do
+    MODEL_DB.reset
+    @model = Class.new(Sequel::Model(:items))
+    @model.dataset.meta_def(:delete) {MODEL_DB.execute delete_sql}
+    
+    @instance = @model.new(:id => 1234)
+    #@model.stub!(:delete).and_return(:true)
+  end
+
+  it "should run within a transaction" do
+    @model.db.should_receive(:transaction)
+    @instance.destroy
+  end
+
+  it "should run before_destroy and after_destroy hooks" do
+    @model.before_destroy {MODEL_DB.execute('before blah')}
+    @model.after_destroy {MODEL_DB.execute('after blah')}
+    @instance.destroy
+    
+    MODEL_DB.sqls.should == [
+      "before blah",
+      "DELETE FROM items WHERE (id = 1234)",
+      "after blah"
+    ]
+  end
+end
+
+describe Sequel::Model, "#exists?" do
+  before(:each) do
+    @model = Class.new(Sequel::Model(:items))
+    @m = @model.new
+  end
+
+  it "should returns true when #this.count > 0" do
+    @m.this.meta_def(:count) {1}
+    @m.exists?.should be_true
+  end
+
+  it "should return false when #this.count == 0" do
+    @m.this.meta_def(:count) {0}
+    @m.exists?.should be_false
+  end
+end
+
+describe Sequel::Model, "#each" do
+  setup do
+    @model = Class.new(Sequel::Model(:items))
+    @m = @model.new(:a => 1, :b => 2, :id => 4444)
+  end
+  
+  specify "should iterate over the values" do
+    h = {}
+    @m.each {|k, v| h[k] = v}
+    h.should == {:a => 1, :b => 2, :id => 4444}
+  end
+end
+
+describe Sequel::Model, "#keys" do
+  setup do
+    @model = Class.new(Sequel::Model(:items))
+    @m = @model.new(:a => 1, :b => 2, :id => 4444)
+  end
+  
+  specify "should return the value keys" do
+    @m.keys.size.should == 3
+    @m.keys.should include(:a, :b, :id)
+    
+    @m = @model.new()
+    @m.keys.should == []
+  end
+end
+
+describe Sequel::Model, "#===" do
+  specify "should compare instances by values" do
+    a = Sequel::Model.new(:id => 1, :x => 3)
+    b = Sequel::Model.new(:id => 1, :x => 4)
+    c = Sequel::Model.new(:id => 1, :x => 3)
+    
+    a.should_not == b
+    a.should == c
+    b.should_not == c
+  end
+end
+
+describe Sequel::Model, "#===" do
+  specify "should compare instances by pk only" do
+    a = Sequel::Model.new(:id => 1, :x => 3)
+    b = Sequel::Model.new(:id => 1, :x => 4)
+    c = Sequel::Model.new(:id => 2, :x => 3)
+    
+    a.should === b
+    a.should_not === c
+  end
+end
+
+describe Sequel::Model, "#initialize" do
+  setup do
+    @c = Class.new(Sequel::Model) do
+    end
+  end
+  
+  specify "should accept values" do
+    m = @c.new(:id => 1, :x => 2)
+    m.values.should == {:id => 1, :x => 2}
+  end
+  
+  specify "should accept no values" do
+    m = @c.new
+    m.values.should == {}
+  end
+  
+  specify "should accept nil values" do
+    m = @c.new(nil)
+    m.values.should == {}
+  end
+  
+  specify "should accept a block to execute" do
+    m = @c.new {|o| o[:id] = 1234}
+    m.id.should == 1234
+  end
+  
+  specify "should accept virtual attributes" do
+    @c.class_def(:blah=) {|x| @blah = x}
+    @c.class_def(:blah) {@blah}
+    
+    m = @c.new(:id => 1, :x => 2, :blah => 3)
+    m.values.should == {:id => 1, :x => 2}
+    m.blah.should == 3
+  end
+  
+  specify "should convert string keys into symbol keys" do
+    m = @c.new('id' => 1, 'x' => 2)
+    m.values.should == {:id => 1, :x => 2}
+  end
+end
+
+describe Sequel::Model, ".create" do
+
+  before(:each) do
+    MODEL_DB.reset
+    @c = Class.new(Sequel::Model(:items)) do
+      def columns; [:x]; end
+    end
+  end
+
+  it "should be able to create rows in the associated table" do
+    o = @c.create(:x => 1)
+    o.class.should == @c
+    MODEL_DB.sqls.should == ['INSERT INTO items (x) VALUES (1)',  "SELECT * FROM items WHERE (id IN ('INSERT INTO items (x) VALUES (1)')) LIMIT 1"]
+  end
+
+  it "should be able to create rows without any values specified" do
+    o = @c.create
+    o.class.should == @c
+    MODEL_DB.sqls.should == ["INSERT INTO items DEFAULT VALUES", "SELECT * FROM items WHERE (id IN ('INSERT INTO items DEFAULT VALUES')) LIMIT 1"]
+  end
+
+  it "should accept a block and run it" do
+    o1, o2, o3 =  nil, nil, nil
+    o = @c.create {|o3| o1 = o3; o2 = :blah; o3.x = 333}
+    o.class.should == @c
+    o1.should === o
+    o3.should === o
+    o2.should == :blah
+    MODEL_DB.sqls.should == ["INSERT INTO items (x) VALUES (333)", "SELECT * FROM items WHERE (id IN ('INSERT INTO items (x) VALUES (333)')) LIMIT 1"]
+  end
+  
+  it "should create a row for a model with custom primary key" do
+    @c.set_primary_key :x
+    o = @c.create(:x => 30)
+    o.class.should == @c
+    MODEL_DB.sqls.should == ["INSERT INTO items (x) VALUES (30)", "SELECT * FROM items WHERE (x = 30) LIMIT 1"]
+  end
+end
+
+describe Sequel::Model, "#refresh" do
+  setup do
+    MODEL_DB.reset
+    @c = Class.new(Sequel::Model(:items)) do
+      def columns; [:x]; end
+    end
+  end
+
+  specify "should reload the instance values from the database" do
+    @m = @c.new(:id => 555)
+    @m[:x] = 'blah'
+    @m.this.should_receive(:first).and_return({:x => 'kaboom', :id => 555})
+    @m.refresh
+    @m[:x].should == 'kaboom'
+  end
+  
+  specify "should raise if the instance is not found" do
+    @m = @c.new(:id => 555)
+    @m.this.should_receive(:first).and_return(nil)
+    proc {@m.refresh}.should raise_error(Sequel::Error)
+  end
+  
+  specify "should be aliased by #reload" do
+    @m = @c.new(:id => 555)
+    @m.this.should_receive(:first).and_return({:x => 'kaboom', :id => 555})
+    @m.reload
+    @m[:x].should == 'kaboom'
+  end
+end