ardm-core 1.2.1

data/spec/public/shared/association_collection_shared_spec.rb

@@ -0,0 +1,309 @@
+share_examples_for 'It can transfer a Resource from another association' do
+  before :all do
+    @no_join = defined?(DataMapper::Adapters::InMemoryAdapter) && @adapter.kind_of?(DataMapper::Adapters::InMemoryAdapter) ||
+               defined?(DataMapper::Adapters::YamlAdapter)     && @adapter.kind_of?(DataMapper::Adapters::YamlAdapter)
+
+    @one_to_many  = @articles.kind_of?(DataMapper::Associations::OneToMany::Collection)
+    @many_to_many = @articles.kind_of?(DataMapper::Associations::ManyToMany::Collection)
+
+    @skip = @no_join && @many_to_many
+  end
+
+  before :all do
+    unless @skip
+      %w[ @resource @original ].each do |ivar|
+        raise "+#{ivar}+ should be defined in before block" unless instance_variable_defined?(ivar)
+        raise "+#{ivar}+ should not be nil in before block" unless instance_variable_get(ivar)
+      end
+    end
+  end
+
+  before do
+    pending if @skip
+  end
+
+  it 'should remove the Resource from the original Collection' do
+    pending do
+      @original.should_not be_include(@resource)
+    end
+  end
+end
+
+share_examples_for 'A public Association Collection' do
+  before :all do
+    @no_join = defined?(DataMapper::Adapters::InMemoryAdapter) && @adapter.kind_of?(DataMapper::Adapters::InMemoryAdapter) ||
+               defined?(DataMapper::Adapters::YamlAdapter)     && @adapter.kind_of?(DataMapper::Adapters::YamlAdapter)
+
+    @one_to_many  = @articles.kind_of?(DataMapper::Associations::OneToMany::Collection)
+    @many_to_many = @articles.kind_of?(DataMapper::Associations::ManyToMany::Collection)
+
+    @skip = @no_join && @many_to_many
+  end
+
+  before :all do
+    unless @skip
+      %w[ @articles @other_articles ].each do |ivar|
+        raise "+#{ivar}+ should be defined in before block" unless instance_variable_get(ivar)
+      end
+    end
+
+    @articles.loaded?.should == loaded
+  end
+
+  before do
+    pending if @skip
+  end
+
+  describe '#<<' do
+    describe 'when provided a Resource belonging to another association' do
+      before :all do
+        @original = @other_articles
+        @resource = @original.first
+
+        rescue_if @skip do
+          @return = @articles << @resource
+        end
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should return self' do
+        @return.should equal(@articles)
+      end
+
+      it_should_behave_like 'It can transfer a Resource from another association'
+    end
+  end
+
+  describe '#collect!' do
+    describe 'when provided a Resource belonging to another association' do
+      before :all do
+        @original = @other_articles
+        @resource = @original.first
+        @return = @articles.collect! { |resource| @resource }
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should return self' do
+        @return.should equal(@articles)
+      end
+
+      it_should_behave_like 'It can transfer a Resource from another association'
+    end
+  end
+
+  describe '#concat' do
+    describe 'when provided a Resource belonging to another association' do
+      before :all do
+        @original = @other_articles
+        @resource = @original.first
+
+        rescue_if @skip do
+          @return = @articles.concat([ @resource ])
+        end
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should return self' do
+        @return.should equal(@articles)
+      end
+
+      it_should_behave_like 'It can transfer a Resource from another association'
+    end
+  end
+
+  describe '#create' do
+    describe 'when the parent is not saved' do
+      it 'should raise an exception' do
+        author = @author_model.new(:name => 'Dan Kubb')
+        lambda {
+          author.articles.create
+        }.should raise_error(DataMapper::UnsavedParentError)
+      end
+    end
+  end
+
+  describe '#destroy' do
+    describe 'when the parent is not saved' do
+      it 'should raise an exception' do
+        author = @author_model.new(:name => 'Dan Kubb')
+        lambda {
+          author.articles.destroy
+        }.should raise_error(DataMapper::UnsavedParentError, 'The source must be saved before mass-deleting the collection')
+      end
+    end
+  end
+
+  describe '#destroy!' do
+    describe 'when the parent is not saved' do
+      it 'should raise an exception' do
+        author = @author_model.new(:name => 'Dan Kubb')
+        lambda {
+          author.articles.destroy!
+        }.should raise_error(DataMapper::UnsavedParentError, 'The source must be saved before mass-deleting the collection')
+      end
+    end
+  end
+
+  describe '#insert' do
+    describe 'when provided a Resource belonging to another association' do
+      before :all do
+        @original = @other_articles
+        @resource = @original.first
+
+        rescue_if @skip do
+          @return = @articles.insert(0, @resource)
+        end
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should return self' do
+        @return.should equal(@articles)
+      end
+
+      it_should_behave_like 'It can transfer a Resource from another association'
+    end
+  end
+
+  it 'should respond to a public collection method with #method_missing' do
+    @articles.respond_to?(:to_a)
+  end
+
+  describe '#method_missing' do
+    describe 'with a public collection method' do
+      before :all do
+        @return = @articles.to_a
+      end
+
+      it 'should return expected object' do
+        @return.should == @articles
+      end
+    end
+
+    describe 'with unknown method' do
+      it 'should raise an exception' do
+        lambda {
+          @articles.unknown
+        }.should raise_error(NoMethodError)
+      end
+    end
+  end
+
+  describe '#new' do
+    before :all do
+      @resource = @author.articles.new
+    end
+
+    it 'should associate the Resource to the Collection' do
+      if @resource.respond_to?(:authors)
+        pending 'TODO: make sure the association is bidirectional' do
+          @resource.authors.should == [ @author ]
+        end
+      else
+        @resource.author.should == @author
+      end
+    end
+  end
+
+  describe '#push' do
+    describe 'when provided a Resource belonging to another association' do
+      before :all do
+        @original = @other_articles
+        @resource = @original.first
+
+        rescue_if @skip do
+          @return = @articles.push(@resource)
+        end
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should return self' do
+        @return.should equal(@articles)
+      end
+
+      it_should_behave_like 'It can transfer a Resource from another association'
+    end
+  end
+
+  describe '#replace' do
+    describe 'when provided a Resource belonging to another association' do
+      before :all do
+        @original = @other_articles
+        @resource = @original.first
+
+        rescue_if @skip do
+          @return = @articles.replace([ @resource ])
+        end
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should return self' do
+        @return.should equal(@articles)
+      end
+
+      it_should_behave_like 'It can transfer a Resource from another association'
+    end
+  end
+
+  describe '#unshift' do
+    describe 'when provided a Resource belonging to another association' do
+      before :all do
+        @original = @other_articles
+        @resource = @original.first
+
+        rescue_if @skip do
+          @return = @articles.unshift(@resource)
+        end
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should return self' do
+        @return.should equal(@articles)
+      end
+
+      it_should_behave_like 'It can transfer a Resource from another association'
+    end
+  end
+
+  describe '#update' do
+    describe 'when the parent is not saved' do
+      it 'should raise an exception' do
+        author = @author_model.new(:name => 'Dan Kubb')
+        lambda {
+          author.articles.update(:title => 'New Title')
+        }.should raise_error(DataMapper::UnsavedParentError, 'The source must be saved before mass-updating the collection')
+      end
+    end
+  end
+
+  describe '#update!' do
+    describe 'when the parent is not saved' do
+      it 'should raise an exception' do
+        author = @author_model.new(:name => 'Dan Kubb')
+        lambda {
+          author.articles.update!(:title => 'New Title')
+        }.should raise_error(DataMapper::UnsavedParentError, 'The source must be saved before mass-updating the collection')
+      end
+    end
+  end
+end

data/spec/public/shared/collection_finder_shared_spec.rb

@@ -0,0 +1,267 @@
+share_examples_for 'Collection Finder Interface' do
+  before :all do
+    %w[ @article_model @article @other @articles ].each do |ivar|
+      raise "+#{ivar}+ should be defined in before block" unless instance_variable_defined?(ivar)
+      raise "+#{ivar}+ should not be nil in before block" unless instance_variable_get(ivar)
+    end
+  end
+
+  before :all do
+    @no_join = defined?(DataMapper::Adapters::InMemoryAdapter) && @adapter.kind_of?(DataMapper::Adapters::InMemoryAdapter) ||
+               defined?(DataMapper::Adapters::YamlAdapter)     && @adapter.kind_of?(DataMapper::Adapters::YamlAdapter)
+
+    @many_to_many = @articles.kind_of?(DataMapper::Associations::ManyToMany::Collection)
+
+    @skip = @no_join && @many_to_many
+  end
+
+  before do
+    pending if @skip
+  end
+
+  describe '#at' do
+    before :all do
+      @copy = @articles.dup
+      @copy.to_a
+    end
+
+    describe 'with positive offset', 'after prepending to the collection' do
+      before :all do
+        @return = @resource = @articles.unshift(@other).at(0)
+      end
+
+      should_not_be_a_kicker
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should return expected Resource' do
+        @resource.should equal(@other)
+      end
+    end
+
+    describe 'with negative offset', 'after appending to the collection' do
+      before :all do
+        @return = @resource = @articles.push(@other).at(-1)
+      end
+
+      should_not_be_a_kicker
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should return expected Resource' do
+        @resource.should equal(@other)
+      end
+    end
+  end
+
+  describe '#first' do
+    before :all do
+      1.upto(5) { |number| @articles.create(:content => "Article #{number}") }
+
+      @copy = @articles.dup
+      @copy.to_a
+
+      # reload the articles
+      @articles = @article_model.all(@articles.query)
+    end
+
+    describe 'with no arguments' do
+      before :all do
+        @return = @resource = @articles.first
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should be first Resource in the Collection' do
+        @resource.should equal(@copy.entries.first)
+      end
+
+      it 'should return the same Resource every time' do
+        @return.should equal(@articles.first)
+      end
+    end
+
+    describe 'with no arguments', 'after prepending to the collection' do
+      before :all do
+        @return = @resource = @articles.unshift(@other).first
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should return expected Resource' do
+        @resource.should equal(@other)
+      end
+
+      it 'should be first Resource in the Collection' do
+        @resource.should equal(@copy.entries.unshift(@other).first)
+      end
+    end
+
+    describe 'with empty query', 'after prepending to the collection' do
+      before :all do
+        @return = @resource = @articles.unshift(@other).first({})
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should return expected Resource' do
+        @resource.should equal(@other)
+      end
+
+      it 'should be first Resource in the Collection' do
+        @resource.should equal(@copy.entries.unshift(@other).first)
+      end
+    end
+
+    describe 'with a limit specified', 'after prepending to the collection' do
+      before :all do
+        @return = @resources = @articles.unshift(@other).first(1)
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should be the expected Collection' do
+        @resources.should == [ @other ]
+      end
+
+      it 'should be the first N Resources in the Collection' do
+        @resources.should == @copy.entries.unshift(@other).first(1)
+      end
+    end
+  end
+
+  [ :get, :get! ].each do |method|
+    describe 'with a key to a Resource within a Collection using a limit' do
+      before :all do
+        rescue_if @skip && method == :get! do
+          @articles = @articles.all(:limit => 1)
+
+          @return = @resource = @articles.send(method, *@article.key)
+        end
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should be matching Resource in the Collection' do
+        @resource.should == @article
+      end
+    end
+
+    describe 'with a key to a Resource within a Collection using an offset' do
+      before :all do
+        rescue_if @skip && method == :get! do
+          @new = @articles.create(:content => 'New Article')
+          @articles = @articles.all(:offset => 1, :limit => 1)
+
+          @return = @resource = @articles.send(method, *@new.key)
+        end
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should be matching Resource in the Collection' do
+        @resource.should equal(@new)
+      end
+    end
+  end
+
+  describe '#last' do
+    before :all do
+      1.upto(5) { |number| @articles.create(:content => "Article #{number}") }
+
+      @copy = @articles.dup
+      @copy.to_a
+
+      # reload the articles
+      @articles = @article_model.all(@articles.query)
+    end
+
+    describe 'with no arguments' do
+      before :all do
+        @return = @resource = @articles.last
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should be last Resource in the Collection' do
+        @resource.should equal(@copy.entries.last)
+      end
+
+      it 'should return the same Resource every time' do
+        @return.should equal(@articles.last)
+      end
+    end
+
+    describe 'with no arguments', 'after appending to the collection' do
+      before :all do
+        @return = @resource = @articles.push(@other).last
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should return expected Resource' do
+        @resource.should equal(@other)
+      end
+
+      it 'should be last Resource in the Collection' do
+        @resource.should equal(@copy.entries.push(@other).last)
+      end
+    end
+
+    describe 'with empty query', 'after appending to the collection' do
+      before :all do
+        @return = @resource = @articles.push(@other).last({})
+      end
+
+      it 'should return a Resource' do
+        @return.should be_kind_of(DataMapper::Resource)
+      end
+
+      it 'should return expected Resource' do
+        @resource.should equal(@other)
+      end
+
+      it 'should be last Resource in the Collection' do
+        @resource.should equal(@copy.entries.push(@other).last)
+      end
+    end
+
+    describe 'with a limit specified', 'after appending to the collection' do
+      before :all do
+        @return = @resources = @articles.push(@other).last(1)
+      end
+
+      it 'should return a Collection' do
+        @return.should be_kind_of(DataMapper::Collection)
+      end
+
+      it 'should be the expected Collection' do
+        @resources.should == [ @other ]
+      end
+
+      it 'should be the last N Resources in the Collection' do
+        @resources.should == @copy.entries.push(@other).last(1)
+      end
+    end
+  end
+end