sbf-dm-types 1.3.0.beta

data/spec/unit/flag_spec.rb

@@ -0,0 +1,114 @@
+require_relative '../spec_helper'
+
+require_relative '../fixtures/tshirt'
+
+try_spec do
+  describe DataMapper::Property::Flag do
+    describe '.dump' do
+      before :all do
+        @flag = DataMapper::TypesFixtures::TShirt.property(
+          :stuff, DataMapper::Property::Flag[:first, :second, :third, :fourth, :fifth])
+
+        @property_klass = DataMapper::Property::Flag
+      end
+
+      it_behaves_like 'A property with flags'
+
+      describe 'when argument matches a value in the flag map' do
+        before :all do
+          @result = @flag.dump(:first)
+        end
+
+        it 'returns flag bit of value' do
+          expect(@result).to eq 1
+        end
+      end
+
+      describe 'when argument matches 2nd value in the flag map' do
+        before :all do
+          @result = @flag.dump(:second)
+        end
+
+        it 'returns flag bit of value' do
+          expect(@result).to eq 2
+        end
+      end
+
+      describe 'when argument matches multiple Symbol values in the flag map' do
+        before :all do
+          @result = @flag.dump([ :second, :fourth ])
+        end
+
+        it 'builds binary flag from key values of all matches' do
+          expect(@result).to eq 10
+        end
+      end
+
+      describe 'when argument matches multiple string values in the flag map' do
+        before :all do
+          @result = @flag.dump(['first', 'second', 'third', 'fourth', 'fifth'])
+        end
+
+        it 'builds binary flag from key values of all matches' do
+          expect(@result).to eq 31
+        end
+      end
+
+      describe 'when argument does not match a single value in the flag map' do
+        before :all do
+          @result = @flag.dump(:zero)
+        end
+
+        it 'returns zero' do
+          expect(@result).to eq 0
+        end
+      end
+
+      describe 'when argument contains duplicate flags' do
+        before :all do
+          @result = @flag.dump([ :second, :fourth, :second ])
+        end
+
+        it 'behaves the same as if there were no duplicates' do
+          expect(@result).to eq @flag.dump([ :second, :fourth ])
+        end
+      end
+    end
+
+    describe '.load' do
+      before :all do
+        @flag = DataMapper::TypesFixtures::TShirt.property(:stuff, DataMapper::Property::Flag, :flags => [:uno, :dos, :tres, :cuatro, :cinco])
+      end
+
+      describe 'when argument matches a key in the flag map' do
+        before :all do
+          @result = @flag.load(4)
+        end
+
+        it 'returns array with a single matching element' do
+          expect(@result).to eq [ :tres ]
+        end
+      end
+
+      describe 'when argument matches multiple keys in the flag map' do
+        before :all do
+          @result = @flag.load(10)
+        end
+
+        it 'returns array of matching values' do
+          expect(@result).to eq [ :dos, :cuatro ]
+        end
+      end
+
+      describe 'when argument does not match a single key in the flag map' do
+        before :all do
+          @result = @flag.load(nil)
+        end
+
+        it 'returns an empty array' do
+          expect(@result).to eq []
+        end
+      end
+    end
+  end
+end

data/spec/unit/ip_address_spec.rb

@@ -0,0 +1,109 @@
+require_relative '../spec_helper'
+
+require_relative '../fixtures/network_node'
+
+try_spec do
+  describe DataMapper::Property::IPAddress do
+    before :all do
+      @stored = '81.20.130.1'
+      @input  = IPAddr.new(@stored)
+      @property = DataMapper::TypesFixtures::NetworkNode.properties[:ip_address]
+    end
+
+    describe '.dump' do
+      describe 'when argument is an IP address given as Ruby object' do
+        before :all do
+          @result = @property.dump(@input)
+        end
+
+        it 'dumps input into a string' do
+          expect(@result).to eq @stored
+        end
+      end
+
+      describe 'when argument is nil' do
+        before :all do
+          @result = @property.dump(nil)
+        end
+
+        it 'returns nil' do
+          expect(@result).to be_nil
+        end
+      end
+
+      describe 'when input is a blank string' do
+        before :all do
+          @result = @property.dump('')
+        end
+
+        it 'retuns a blank string' do
+          expect(@result).to eq ''
+        end
+      end
+    end
+
+    describe '.load' do
+      describe 'when argument is a valid IP address as a string' do
+        before :all do
+          @result = @property.load(@stored)
+        end
+
+        it 'returns IPAddr instance from stored value' do
+          expect(@result).to eq @input
+        end
+      end
+
+      describe 'when argument is nil' do
+        before :all do
+          @result = @property.load(nil)
+        end
+
+        it 'returns nil' do
+          expect(@result).to be_nil
+        end
+      end
+
+      describe 'when argument is a blank string' do
+        before :all do
+          @result = @property.load('')
+        end
+
+        it 'returns IPAddr instance from stored value' do
+          expect(@result).to eq IPAddr.new('0.0.0.0')
+        end
+      end
+
+      describe 'when argument is an Array instance' do
+        before :all do
+          @operation = lambda { @property.load([]) }
+        end
+
+        it 'raises ArgumentError with a meaningful message' do
+          expect { @operation }.to raise_error(ArgumentError, '+value+ must be nil or a String')
+        end
+      end
+    end
+
+    describe '.typecast' do
+      describe 'when argument is an IpAddr object' do
+        before :all do
+          @result = @property.typecast(@input)
+        end
+
+        it 'does not change the value' do
+          expect(@result).to eq @input
+        end
+      end
+
+      describe 'when argument is a valid IP address as a string' do
+        before :all do
+          @result = @property.typecast(@stored)
+        end
+
+        it 'instantiates IPAddr instance' do
+          expect(@result).to eq @input
+        end
+      end
+    end
+  end
+end

data/spec/unit/json_spec.rb

@@ -0,0 +1,126 @@
+require_relative '../spec_helper'
+require_relative '../shared/identity_function_group'
+
+try_spec do
+
+  require_relative '../fixtures/person'
+
+  describe DataMapper::Property::Json do
+    before :all do
+      @property = DataMapper::TypesFixtures::Person.properties[:positions]
+    end
+
+    describe '.load' do
+      describe 'when nil is provided' do
+        it 'returns nil' do
+          expect(@property.load(nil)).to be_nil
+        end
+      end
+
+      describe 'when Json encoded primitive string is provided' do
+        it 'returns decoded value as Ruby string' do
+          expect(@property.load(MultiJson.dump(:value => 'JSON encoded string'))).to eq({ 'value' => 'JSON encoded string' })
+        end
+      end
+
+      describe 'when something else is provided' do
+        it 'raises ArgumentError with a meaningful message' do
+          expect {
+            @property.load(:sym)
+          }.to raise_error(ArgumentError, '+value+ of a property of JSON type must be nil or a String')
+        end
+      end
+    end
+
+    describe '.dump' do
+      describe 'when nil is provided' do
+        it 'returns nil' do
+          expect(@property.dump(nil)).to be_nil
+        end
+      end
+
+      describe 'when Json encoded primitive string is provided' do
+        it 'does not do double encoding' do
+          expect(@property.dump('Json encoded string')).to eq 'Json encoded string'
+        end
+      end
+
+      describe 'when regular Ruby string is provided' do
+        it 'dumps argument to Json' do
+          expect(@property.dump('dump me (to JSON)')).to eq 'dump me (to JSON)'
+        end
+      end
+
+      describe 'when Ruby array is provided' do
+        it 'dumps argument to Json' do
+          expect(@property.dump([1, 2, 3])).to eq '[1,2,3]'
+        end
+      end
+
+      describe 'when Ruby hash is provided' do
+        it 'dumps argument to Json' do
+          expect(@property.dump({ :datamapper => 'Data access layer in Ruby' })).to eq '{"datamapper":"Data access layer in Ruby"}'
+        end
+      end
+    end
+
+    describe '.typecast' do
+      class ::SerializeMe
+        attr_accessor :name
+      end
+
+      describe 'when given instance of a Hash' do
+        before :all do
+          @input = { :library => 'DataMapper' }
+
+          @result = @property.typecast(@input)
+        end
+
+        it_behaves_like 'identity function'
+      end
+
+      describe 'when given instance of an Array' do
+        before :all do
+          @input = %w[ dm-core dm-more ]
+
+          @result = @property.typecast(@input)
+        end
+
+        it_behaves_like 'identity function'
+      end
+
+      describe 'when given nil' do
+        before :all do
+          @input = nil
+
+          @result = @property.typecast(@input)
+        end
+
+        it_behaves_like 'identity function'
+      end
+
+      describe 'when given JSON encoded value' do
+        before :all do
+          @input = '{ "value": 11 }'
+
+          @result = @property.typecast(@input)
+        end
+
+        it 'decodes value from JSON' do
+          expect(@result).to eq({ 'value' => 11 })
+        end
+      end
+
+      describe 'when given instance of a custom class' do
+        before :all do
+          @input      = SerializeMe.new
+          @input.name = 'Hello!'
+
+          # @result = @property.typecast(@input)
+        end
+
+        it 'attempts to load value from JSON string'
+      end
+    end
+  end
+end

data/spec/unit/paranoid_boolean_spec.rb

@@ -0,0 +1,149 @@
+require 'spec_helper'
+
+describe DataMapper::Property::ParanoidBoolean do
+  before :all do
+    Object.send(:remove_const, :Blog) if defined?(Blog)
+
+    module ::Blog
+      class Draft
+        include DataMapper::Resource
+
+        property :id,      Serial
+        property :deleted, ParanoidBoolean
+
+        before :destroy, :before_destroy
+
+        def before_destroy; end
+      end
+
+      class Article < Draft; end
+
+      class Review < Article; end
+    end
+
+    @model = Blog::Article
+  end
+
+  supported_by :all do
+    describe 'Resource#destroy' do
+      subject { @resource.destroy }
+
+      describe 'with a new resource' do
+        before do
+          @resource = @model.new
+        end
+
+        it { is_expected.to be(false) }
+
+        it 'does not delete the resource from the datastore' do
+          expect { method(:subject) }.not_to change { @model.with_deleted.size }.from(0)
+        end
+
+        it 'does not set the paranoid column' do
+          expect { method(:subject) }.not_to change { @resource.deleted }.from(false)
+        end
+
+        it 'runs the destroy hook' do
+          expect(@resource).to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+
+      describe 'with a saved resource' do
+        before do
+          @resource = @model.create
+        end
+
+        it { is_expected.to be(true) }
+
+        it 'does not delete the resource from the datastore' do
+          expect { method(:subject) }.not_to change { @model.with_deleted.size }.from(1)
+        end
+
+        it 'sets the paranoid column' do
+          expect { method(:subject) }.to change { @resource.deleted }.from(false).to(true)
+        end
+
+        it 'runs the destroy hook' do
+          expect(@resource).to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+    end
+
+    describe 'Resource#destroy!' do
+      subject { @resource.destroy! }
+
+      describe 'with a new resource' do
+        before do
+          @resource = @model.new
+        end
+
+        it { is_expected.to be(false) }
+
+        it 'does not delete the resource from the datastore' do
+          expect { method(:subject) }.not_to change { @model.with_deleted.size }.from(0)
+        end
+
+        it 'does not set the paranoid column' do
+          expect { method(:subject) }.not_to change { @resource.deleted }.from(false)
+        end
+
+        it 'does not run the destroy hook' do
+          expect(@resource).not_to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+
+      describe 'with a saved resource' do
+        before do
+          @resource = @model.create
+        end
+
+        it { is_expected.to be(true) }
+
+        it 'deletes the resource from the datastore' do
+          expect { method(:subject) }.to change { @model.with_deleted.size }.from(1).to(0)
+        end
+
+        it 'does not set the paranoid column' do
+          expect { method(:subject) }.not_to change { @resource.deleted }.from(false)
+        end
+
+        it 'does not run the destroy hook' do
+          expect(@resource).not_to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+    end
+
+    describe 'Model#with_deleted' do
+      before do
+        @resource = @model.create
+        @resource.destroy
+      end
+
+      describe 'with a block' do
+        subject { @model.with_deleted { @model.all } }
+
+        it 'scopes the block to return all resources' do
+          expect(subject.map(&:key)).to eq [ @resource.key ]
+        end
+      end
+
+      describe 'without a block' do
+        subject { @model.with_deleted }
+
+        it 'returns a collection scoped to return all resources' do
+          expect(subject.map(&:key)).to eq [ @resource.key ]
+        end
+      end
+    end
+
+    describe 'Model.inherited' do
+      it 'sets @paranoid_properties' do
+        expect(::Blog::Review.instance_variable_get(:@paranoid_properties)).to eq ::Blog::Article.instance_variable_get(:@paranoid_properties)
+      end
+    end
+  end
+end

data/spec/unit/paranoid_datetime_spec.rb

@@ -0,0 +1,153 @@
+require_relative '../spec_helper'
+
+describe DataMapper::Property::ParanoidDateTime do
+  before :all do
+    Object.send(:remove_const, :Blog) if defined?(Blog)
+    module ::Blog
+      class Draft
+        include DataMapper::Resource
+
+        property :id,         Serial
+        property :deleted_at, ParanoidDateTime
+
+        before :destroy, :before_destroy
+
+        def before_destroy; end
+      end
+
+      class Article < Draft; end
+
+      class Review < Article; end
+    end
+
+    @model = Blog::Article
+  end
+
+  supported_by :all do
+    describe 'Resource#destroy' do
+      before do
+        pending 'Does not work with < 1.8.7, see if backports fixes it' if RUBY_VERSION < '1.8.7'
+      end
+
+      subject { @resource.destroy }
+
+      describe 'with a new resource' do
+        before do
+          @resource = @model.new
+        end
+
+        it { is_expected.to be(false) }
+
+        it 'does not delete the resource from the datastore' do
+          expect { method(:subject) }.not_to change { @model.with_deleted.size }.from(0)
+        end
+
+        it 'does not set the paranoid column' do
+          expect { method(:subject) }.not_to change { @resource.deleted_at }.from(nil)
+        end
+
+        it 'runs the destroy hook' do
+          expect(@resource).to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+
+      describe 'with a saved resource' do
+        before do
+          @resource = @model.create
+        end
+
+        it { is_expected.to be(true) }
+
+        it 'does not delete the resource from the datastore' do
+          expect { method(:subject) }.not_to change { @model.with_deleted.size }.from(1)
+        end
+
+        it 'sets the paranoid column' do
+          expect { method(:subject) }.to change { @resource.deleted_at }.from(nil)
+        end
+
+        it 'runs the destroy hook' do
+          expect(@resource).to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+    end
+
+    describe 'Resource#destroy!' do
+      subject { @resource.destroy! }
+
+      describe 'with a new resource' do
+        before do
+          @resource = @model.new
+        end
+
+        it { is_expected.to be(false) }
+
+        it 'does not delete the resource from the datastore' do
+          expect { method(:subject) }.not_to change { @model.with_deleted.size }.from(0)
+        end
+
+        it 'does not set the paranoid column' do
+          expect { method(:subject) }.not_to change { @resource.deleted_at }.from(nil)
+        end
+
+        it 'does not run the destroy hook' do
+          expect(@resource).not_to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+
+      describe 'with a saved resource' do
+        before do
+          @resource = @model.create
+        end
+
+        it { is_expected.to be(true) }
+
+        it 'deletes the resource from the datastore' do
+          expect { method(:subject) }.to change { @model.with_deleted.size }.from(1).to(0)
+        end
+
+        it 'does not set the paranoid column' do
+          expect { method(:subject) }.not_to change { @resource.deleted_at }.from(nil)
+        end
+
+        it 'does not run the destroy hook' do
+          expect(@resource).not_to receive(:before_destroy).with(no_args)
+          subject
+        end
+      end
+    end
+
+    describe 'Model#with_deleted' do
+      before do
+        pending 'Does not work with < 1.8.7, see if backports fixes it' if RUBY_VERSION < '1.8.7'
+        @resource = @model.create
+        @resource.destroy
+      end
+
+      describe 'with a block' do
+        subject { @model.with_deleted { @model.all } }
+
+        it 'scopes the block to return all resources' do
+          expect(subject.map(&:key)).to eq [ @resource.key ]
+        end
+      end
+
+      describe 'without a block' do
+        subject { @model.with_deleted }
+
+        it 'returns a collection scoped to return all resources' do
+          expect(subject.map(&:key)).to eq [ @resource.key ]
+        end
+      end
+    end
+
+    describe 'Model.inherited' do
+      it 'sets @paranoid_properties' do
+        expect(Blog::Review.instance_variable_get(:@paranoid_properties)).to eq Blog::Article.instance_variable_get(:@paranoid_properties)
+      end
+    end
+  end
+end

data/spec/unit/regexp_spec.rb

@@ -0,0 +1,63 @@
+require_relative '../spec_helper'
+
+try_spec do
+  describe DataMapper::Property::Regexp  do
+    before :all do
+      class ::User
+        include DataMapper::Resource
+        property :id, Serial
+        property :regexp, Regexp
+      end
+
+      @property = User.properties[:regexp]
+    end
+
+    describe '.load' do
+      describe 'when argument is a string' do
+        before :all do
+          @input  = '[a-z]\d+'
+          @result = @property.load(@input)
+        end
+
+        it 'create a regexp instance from argument' do
+          expect(@result).to eq Regexp.new(@input)
+        end
+      end
+
+      describe 'when argument is nil' do
+        before :all do
+          @input  = nil
+          @result = @property.load(@input)
+        end
+
+        it 'returns nil' do
+          expect(@result).to be_nil
+        end
+      end
+    end
+
+    describe '.dump' do
+      describe 'when argument is a regular expression' do
+        before :all do
+          @input  = /\d+/
+          @result = @property.dump(@input)
+        end
+
+        it 'escapes the argument' do
+          expect(@result).to eq '\\d+'
+        end
+      end
+
+      describe 'when argument is nil' do
+        before :all do
+          @input = nil
+          @result = @property.dump(@input)
+        end
+
+        it 'returns nil' do
+          expect(@result).to be_nil
+        end
+      end
+    end
+  end
+end