dm-core 0.9.11 → 0.10.0

data/spec/public/resource_spec.rb

@@ -0,0 +1,71 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe DataMapper::Resource do
+  before :all do
+    module ::Blog
+      class User
+        include DataMapper::Resource
+
+        property :name,        String, :key => true
+        property :age,         Integer
+        property :summary,     Text
+        property :description, Text
+        property :admin,       Boolean, :accessor => :private
+
+        belongs_to :referrer, self, :nullable => true
+        has n, :comments
+
+        # FIXME: figure out a different approach than stubbing things out
+        def comment=(*)
+          # do nothing with comment
+        end
+      end
+
+      class Author < User; end
+
+      class Comment
+        include DataMapper::Resource
+
+        property :id,   Serial
+        property :body, Text
+
+        belongs_to :user
+      end
+
+      class Article
+        include DataMapper::Resource
+
+        property :id,   Serial
+        property :body, Text
+
+        has n, :paragraphs
+      end
+
+      class Paragraph
+        include DataMapper::Resource
+
+        property :id,   Serial
+        property :text, String
+
+        belongs_to :article
+      end
+    end
+
+    @user_model      = Blog::User
+    @author_model    = Blog::Author
+    @comment_model   = Blog::Comment
+    @article_model   = Blog::Article
+    @paragraph_model = Blog::Paragraph
+  end
+
+  supported_by :all do
+    before :all do
+      user = @user_model.create(:name => 'dbussink', :age => 25, :description => 'Test')
+
+      @user = @user_model.get(*user.key)
+    end
+
+    it_should_behave_like 'A public Resource'
+    it_should_behave_like 'A Resource supporting Strategic Eager Loading'
+  end
+end

data/spec/public/sel_spec.rb

@@ -0,0 +1,44 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe 'SEL', 'with different key types' do
+  before :all do
+    module ::Blog
+      class Author
+        include DataMapper::Resource
+
+        property :id,   Serial
+        property :name, String
+
+        has n, :articles
+      end
+
+      class Article
+        include DataMapper::Resource
+
+        property :id,      Serial
+        property :title,   String, :nullable => false
+
+        property :author_id, String  # different type
+
+        belongs_to :author
+      end
+    end
+
+    @author_model  = Blog::Author
+    @article_model = Blog::Article
+  end
+
+  supported_by :all do
+    before :all do
+      @author1 = @author_model.create(:name => 'Dan Kubb')
+      @author2 = @author_model.create(:name => 'Carl Porth')
+
+      @article1 = @author1.articles.create(:title => 'Sample Article')
+      @article2 = @author2.articles.create(:title => 'Other Article')
+    end
+
+    it 'should return expected results' do
+      @article_model.all.map { |article| article.author }.should == [ @author1, @author2 ]
+    end
+  end
+end

data/spec/public/setup_spec.rb

@@ -0,0 +1,145 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe DataMapper do
+  describe '.setup' do
+    describe 'using connection string' do
+      before :all do
+        @return = DataMapper.setup(:setup_test, 'in_memory://user:pass@hostname:1234/path?foo=bar&baz=foo#fragment')
+
+        @options = @return.options
+      end
+
+      after :all do
+        DataMapper::Repository.adapters.delete(@return.name)
+      end
+
+      it 'should return an Adapter' do
+        @return.should be_kind_of(DataMapper::Adapters::AbstractAdapter)
+      end
+
+      it 'should set up the repository' do
+        DataMapper.repository(:setup_test).adapter.should equal(@return)
+      end
+
+      {
+        :adapter  => 'in_memory',
+        :user     => 'user',
+        :password => 'pass',
+        :host     => 'hostname',
+        :port     => 1234,
+        :path     => '/path',
+        :fragment => 'fragment'
+      }.each do |key, val|
+        it "should extract the #{key.inspect} option from the uri" do
+          @options[key].should == val
+        end
+      end
+
+      it 'should alias the scheme of the uri as the adapter' do
+        @options[:scheme].should == @options[:adapter]
+      end
+
+      it 'should leave the query param intact' do
+        @options[:query].should == 'foo=bar&baz=foo'
+      end
+
+      it 'should extract the query param as top-level options' do
+        @options[:foo].should == 'bar'
+        @options[:baz].should == 'foo'
+      end
+    end
+
+    describe 'using options' do
+      before :all do
+        @return = DataMapper.setup(:setup_test, :adapter => :in_memory, :foo => 'bar')
+
+        @options = @return.options
+      end
+
+      after :all do
+        DataMapper::Repository.adapters.delete(@return.name)
+      end
+
+      it 'should return an Adapter' do
+        @return.should be_kind_of(DataMapper::Adapters::AbstractAdapter)
+      end
+
+      it 'should set up the repository' do
+        DataMapper.repository(:setup_test).adapter.should equal(@return)
+      end
+
+      {
+        :adapter => :in_memory,
+        :foo     => 'bar'
+      }.each do |key, val|
+        it "should set the #{key.inspect} option" do
+          @options[key].should == val
+        end
+      end
+    end
+
+    describe 'using invalid options' do
+      it 'should raise an exception' do
+        lambda {
+          DataMapper.setup(:setup_test, :invalid)
+        }.should raise_error(ArgumentError, '+options+ should be Hash or Addressable::URI or String, but was Symbol')
+      end
+    end
+
+    describe 'using an instance of an adapter' do
+      before :all do
+        @adapter = DataMapper::Adapters::InMemoryAdapter.new(:setup_test)
+
+        @return = DataMapper.setup(@adapter)
+      end
+
+      after :all do
+        DataMapper::Repository.adapters.delete(@return.name)
+      end
+
+      it 'should return an Adapter' do
+        @return.should be_kind_of(DataMapper::Adapters::AbstractAdapter)
+      end
+
+      it 'should set up the repository' do
+        DataMapper.repository(:setup_test).adapter.should equal(@return)
+      end
+
+      it 'should use the adapter given' do
+        @return.should == @adapter
+      end
+
+      it 'should use the name given to the adapter' do
+        @return.name.should == @adapter.name
+      end
+    end
+
+    supported_by :postgres, :mysql, :sqlite3 do
+      { :path => :database, :user => :username }.each do |original_key, new_key|
+        describe "using #{new_key.inspect} option" do
+          before :all do
+            @return = DataMapper.setup(:setup_test, :adapter => @adapter.options[:adapter], new_key => @adapter.options[original_key])
+
+            @options = @return.options
+          end
+
+          after :all do
+            DataMapper::Repository.adapters.delete(@return.name)
+          end
+
+          it 'should return an Adapter' do
+            @return.should be_kind_of(DataMapper::Adapters::AbstractAdapter)
+          end
+
+          it 'should set up the repository' do
+            DataMapper.repository(:setup_test).adapter.should equal(@return)
+          end
+
+          it "should set the #{new_key.inspect} option" do
+            @options[new_key].should == @adapter.options[original_key]
+          end
+        end
+      end
+    end
+  end
+end

data/spec/public/shared/association_collection_shared_spec.rb

@@ -0,0 +1,317 @@
+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 relate the Resource to the Collection' do
+    @resource.collection.should equal(@articles)
+  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 'TODO', @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 'TODO', @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 'TODO', @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 'TODO', @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 'TODO', @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 relate the Resource to the Collection' do
+        @resource.collection.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 'TODO', @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