ardm 0.0.1

data/spec/unit/epoch_time_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+
+describe Ardm::Property::EpochTime do
+  before do
+    class ::User < Ardm::Record
+      property :id,   Serial
+      property :bday, EpochTime
+    end
+
+    @property = User.properties[:bday]
+  end
+
+  describe '#dump' do
+    subject { @property.dump(value) }
+
+    describe 'with a Time instance' do
+      let(:value) { Time.now }
+
+      it { should == value.to_i }
+    end
+
+    describe 'with nil' do
+      let(:value) { nil }
+
+      it { should == value }
+    end
+  end
+
+  describe '#typecast' do
+    subject { @property.typecast(value) }
+
+    describe 'with a DateTime instance' do
+      let(:value) { DateTime.now }
+
+      it { should == Time.parse(value.to_s) }
+    end
+
+    describe 'with a number' do
+      let(:value) { Time.now.to_i }
+
+      it { should == ::Time.at(value) }
+    end
+
+    describe 'with a numeric string' do
+      let(:value) { Time.now.to_i.to_s }
+
+      it { should == ::Time.at(value.to_i) }
+    end
+
+    describe 'with a DateTime string' do
+      let(:value) { '2011-07-11 15:00:04 UTC' }
+
+      it { should == ::Time.parse(value) }
+    end
+  end
+
+  describe '#load' do
+    subject { @property.load(value) }
+
+    describe 'with a number' do
+      let(:value) { Time.now.to_i }
+
+      it { should == Time.at(value) }
+    end
+
+    describe 'with nil' do
+      let(:value) { nil }
+
+      it { should == value }
+    end
+  end
+end

data/spec/unit/file_path_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+require './spec/fixtures/software_package'
+
+try_spec do
+  describe Ardm::Property::FilePath do
+    before do
+      @property = Ardm::Fixtures::SoftwarePackage.properties[:source_path]
+    end
+
+    before do
+      @input = '/usr/bin/ruby'
+      @path  = Pathname.new(@input)
+    end
+
+    describe '.dump' do
+      describe 'when input is a string' do
+        it 'does not modify input' do
+          @property.dump(@input).should == @input
+        end
+      end
+
+      describe 'when input is nil' do
+        it 'returns nil' do
+          @property.dump(nil).should be_nil
+        end
+      end
+
+      describe 'when input is a blank string' do
+        it 'returns nil' do
+          @property.dump('').should be_nil
+        end
+      end
+    end
+
+    describe '.load' do
+      describe 'when value is a non-blank file path' do
+        it 'returns Pathname for a path' do
+          @property.load(@input).should == @path
+        end
+      end
+
+      describe 'when value is nil' do
+        it 'return nil' do
+          @property.load(nil).should be_nil
+        end
+      end
+
+      describe 'when value is a blank string' do
+        it 'returns nil' do
+          @property.load('').should be_nil
+        end
+      end
+    end
+
+    describe '.typecast' do
+      describe 'when a Pathname is given' do
+        it 'does not modify input' do
+          @property.typecast(@path).should == @path
+        end
+      end
+
+      describe 'when a nil is given' do
+        it 'does not modify input' do
+          @property.typecast(nil).should == nil
+        end
+      end
+
+      describe 'when a string is given' do
+        it 'returns Pathname for given path' do
+          @property.typecast(@input).should == @path
+        end
+      end
+    end
+  end
+end

data/spec/unit/flag_spec.rb

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

data/spec/unit/ip_address_spec.rb

@@ -0,0 +1,109 @@
+require 'spec_helper'
+
+require './spec/fixtures/network_node'
+
+try_spec do
+  describe Ardm::Property::IPAddress do
+    before do
+      @stored = '81.20.130.1'
+      @input  = IPAddr.new(@stored)
+      @property = Ardm::Fixtures::NetworkNode.properties[:ip_address]
+    end
+
+    describe '.dump' do
+      describe 'when argument is an IP address given as Ruby object' do
+        before do
+          @result = @property.dump(@input)
+        end
+
+        it 'dumps input into a string' do
+          @result.should == @stored
+        end
+      end
+
+      describe 'when argument is nil' do
+        before do
+          @result = @property.dump(nil)
+        end
+
+        it 'returns nil' do
+          @result.should be_nil
+        end
+      end
+
+      describe 'when input is a blank string' do
+        before do
+          @result = @property.dump('')
+        end
+
+        it 'retuns a blank string' do
+          @result.should == ''
+        end
+      end
+    end
+
+    describe '.load' do
+      describe 'when argument is a valid IP address as a string' do
+        before do
+          @result = @property.load(@stored)
+        end
+
+        it 'returns IPAddr instance from stored value' do
+          @result.should == @input
+        end
+      end
+
+      describe 'when argument is nil' do
+        before do
+          @result = @property.load(nil)
+        end
+
+        it 'returns nil' do
+          @result.should be_nil
+        end
+      end
+
+      describe 'when argument is a blank string' do
+        before do
+          @result = @property.load('')
+        end
+
+        it 'returns IPAddr instance from stored value' do
+          @result.should == IPAddr.new('0.0.0.0')
+        end
+      end
+
+      describe 'when argument is an Array instance' do
+        before do
+          @operation = lambda { @property.load([]) }
+        end
+
+        it 'raises ArgumentError with a meaningful message' do
+          @operation.should 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 do
+          @result = @property.typecast(@input)
+        end
+
+        it 'does not change the value' do
+          @result.should == @input
+        end
+      end
+
+      describe 'when argument is a valid IP address as a string' do
+        before do
+          @result = @property.typecast(@stored)
+        end
+
+        it 'instantiates IPAddr instance' do
+          @result.should == @input
+        end
+      end
+    end
+  end
+end

data/spec/unit/json_spec.rb

@@ -0,0 +1,127 @@
+require 'spec_helper'
+require 'shared/identity_function_group'
+
+try_spec do
+
+  require './spec/fixtures/person'
+
+  describe Ardm::Property::Json do
+    before do
+      @property = Ardm::Fixtures::Person.properties[:positions]
+    end
+
+    describe '.load' do
+      describe 'when nil is provided' do
+        it 'returns nil' do
+          @property.load(nil).should be_nil
+        end
+      end
+
+      describe 'when Json encoded primitive string is provided' do
+        it 'returns decoded value as Ruby string' do
+          @property.load(MultiJson.dump(:value => 'JSON encoded string')).should == { 'value' => 'JSON encoded string' }
+        end
+      end
+
+      describe 'when something else is provided' do
+        it 'raises ArgumentError with a meaningful message' do
+          lambda {
+            @property.load(:sym)
+          }.should 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
+          @property.dump(nil).should be_nil
+        end
+      end
+
+      describe 'when Json encoded primitive string is provided' do
+        it 'does not do double encoding' do
+          @property.dump('Json encoded string').should == 'Json encoded string'
+        end
+      end
+
+      describe 'when regular Ruby string is provided' do
+        it 'dumps argument to Json' do
+          @property.dump('dump me (to JSON)').should == 'dump me (to JSON)'
+        end
+      end
+
+      describe 'when Ruby array is provided' do
+        it 'dumps argument to Json' do
+          @property.dump([1, 2, 3]).should == '[1,2,3]'
+        end
+      end
+
+      describe 'when Ruby hash is provided' do
+        it 'dumps argument to Json' do
+          @property.dump({ :datamapper => 'Data access layer in Ruby' }).
+            should == '{"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 do
+          @input = { :library => 'Ardm' }
+
+          @result = @property.typecast(@input)
+        end
+
+        it_should_behave_like 'identity function'
+      end
+
+      describe 'when given instance of an Array' do
+        before do
+          @input = %w[ ardm dm-more ]
+
+          @result = @property.typecast(@input)
+        end
+
+        it_should_behave_like 'identity function'
+      end
+
+      describe 'when given nil' do
+        before do
+          @input = nil
+
+          @result = @property.typecast(@input)
+        end
+
+        it_should_behave_like 'identity function'
+      end
+
+      describe 'when given JSON encoded value' do
+        before do
+          @input = '{ "value": 11 }'
+
+          @result = @property.typecast(@input)
+        end
+
+        it 'decodes value from JSON' do
+          @result.should == { 'value' => 11 }
+        end
+      end
+
+      describe 'when given instance of a custom class' do
+        before 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,142 @@
+require 'spec_helper'
+
+module ::ParanoidBooleanBlog
+  class Draft < Ardm::Record
+    self.table_name = "articles"
+    property :id,      Serial
+    property :deleted, ParanoidBoolean
+
+    before_destroy :before_destroy
+
+    def before_destroy; end
+  end
+
+  class Article < Draft; end
+
+  class Review < Article; end
+end
+
+describe Ardm::Property::ParanoidBoolean do
+  before do
+    @model = ParanoidBooleanBlog::Article
+  end
+
+  describe 'Property#destroy' do
+    subject { @resource.destroy }
+
+    describe 'with a new resource' do
+      before do
+        @resource = @model.new
+      end
+
+      it 'should not delete the resource from the datastore' do
+        method(:subject).should_not change { @model.with_deleted.size }.from(0)
+      end
+
+      it 'should not set the paranoid column' do
+        method(:subject).should_not change { @resource.deleted }.from(false)
+      end
+
+      it 'should run the destroy hook' do
+        # NOTE: changed behavior because AR doesn't call hooks on destroying new objects
+        @resource.should_not_receive(:before_destroy).with(no_args)
+        subject
+      end
+    end
+
+    describe 'with a saved resource' do
+      before do
+        @resource = @model.create
+      end
+
+      it { (!!subject).should be_true }
+
+      it 'should not delete the resource from the datastore' do
+        method(:subject).should_not change { @model.with_deleted.size }.from(1)
+      end
+
+      it 'should set the paranoid column' do
+        method(:subject).should change { @resource.deleted }.from(false).to(true)
+      end
+
+      it 'should run the destroy hook' do
+        @resource.should_receive(:before_destroy).with(no_args)
+        subject
+      end
+    end
+  end
+
+  describe 'Property#delete' do
+    subject { @resource.delete }
+
+    describe 'with a new resource' do
+      before do
+        @resource = @model.new
+      end
+
+      it 'should not delete the resource from the datastore' do
+        method(:subject).should_not change { @model.with_deleted.size }.from(0)
+      end
+
+      it 'should not set the paranoid column' do
+        method(:subject).should_not change { @resource.deleted }.from(false)
+      end
+
+      it 'should not run the destroy hook' do
+        @resource.should_not_receive(:before_destroy).with(no_args)
+        subject
+      end
+    end
+
+    describe 'with a saved resource' do
+      before do
+        @resource = @model.create
+      end
+
+      it { (!!subject).should be_true }
+
+      it 'should delete the resource from the datastore' do
+        method(:subject).should change { @model.with_deleted.size }.from(1).to(0)
+      end
+
+      it 'should not set the paranoid column' do
+        method(:subject).should_not change { @resource.deleted }.from(false)
+      end
+
+      it 'should not run the destroy hook' do
+        @resource.should_not_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 'should scope the block to return all resources' do
+        subject.map { |resource| resource.key }.should == [ @resource.key ]
+      end
+    end
+
+    describe 'without a block' do
+      subject { @model.with_deleted }
+
+      it 'should return a collection scoped to return all resources' do
+        subject.map { |resource| resource.key }.should == [ @resource.key ]
+      end
+    end
+  end
+
+  describe 'Model.inherited' do
+    it 'sets @paranoid_properties' do
+      ::ParanoidBooleanBlog::Review.instance_variable_get(:@paranoid_properties).should ==
+        ::ParanoidBooleanBlog::Article.instance_variable_get(:@paranoid_properties)
+    end
+  end
+end