dm-do-adapter 1.0.0.rc1

data/lib/dm-do-adapter/spec/shared_spec.rb

@@ -0,0 +1,370 @@
+share_examples_for 'A DataObjects Adapter' do
+  before :all do
+    raise '+@adapter+ should be defined in before block' unless instance_variable_get('@adapter')
+
+    @log = StringIO.new
+
+    @original_logger = DataMapper.logger
+    DataMapper.logger = DataMapper::Logger.new(@log, :debug)
+
+    # set up the adapter after switching the logger so queries can be captured
+    @adapter = DataMapper.setup(@adapter.name, @adapter.options)
+
+    @jruby = !!(RUBY_PLATFORM =~ /java/)
+
+    @postgres   = defined?(DataMapper::Adapters::PostgresAdapter)  && @adapter.kind_of?(DataMapper::Adapters::PostgresAdapter)
+    @mysql      = defined?(DataMapper::Adapters::MysqlAdapter)     && @adapter.kind_of?(DataMapper::Adapters::MysqlAdapter)
+    @sql_server = defined?(DataMapper::Adapters::SqlserverAdapter) && @adapter.kind_of?(DataMapper::Adapters::SqlserverAdapter)
+    @oracle     = defined?(DataMapper::Adapters::OracleAdapter)    && @adapter.kind_of?(DataMapper::Adapters::OracleAdapter)
+  end
+
+  after :all do
+    DataMapper.logger = @original_logger
+  end
+
+  def reset_log
+    @log.truncate(0)
+    @log.rewind
+  end
+
+  def log_output
+    @log.rewind
+    @log.read.chomp.gsub(/^\s+~ \(\d+\.?\d*\)\s+/, '').split("\n")
+  end
+
+  def supports_default_values?
+    @adapter.send(:supports_default_values?)
+  end
+
+  def supports_returning?
+    @adapter.send(:supports_returning?)
+  end
+
+  describe '#create' do
+    describe 'serial properties' do
+      before :all do
+        class ::Article
+          include DataMapper::Resource
+
+          property :id, Serial
+
+          auto_migrate!
+        end
+
+        reset_log
+
+        Article.create
+      end
+
+      it 'should not send NULL values' do
+        statement = if @mysql
+          /\AINSERT INTO `articles` \(\) VALUES \(\)\z/
+        elsif @oracle
+          /\AINSERT INTO "ARTICLES" \("ID"\) VALUES \(DEFAULT\) RETURNING "ID"/
+        elsif supports_default_values? && supports_returning?
+          /\AINSERT INTO "articles" DEFAULT VALUES RETURNING \"id\"\z/
+        elsif supports_default_values?
+          /\AINSERT INTO "articles" DEFAULT VALUES\z/
+        else
+          /\AINSERT INTO "articles" \(\) VALUES \(\)\z/
+        end
+
+        log_output.first.should =~ statement
+      end
+    end
+
+    describe 'properties without a default' do
+      before :all do
+        class ::Article
+          include DataMapper::Resource
+
+          property :id,    Serial
+          property :title, String
+
+          auto_migrate!
+        end
+
+        reset_log
+
+        Article.create(:id => 1)
+      end
+
+      it 'should not send NULL values' do
+        regexp = if @mysql
+          /^INSERT INTO `articles` \(`id`\) VALUES \(.{1,2}\)$/i
+        elsif @sql_server
+          /^SET IDENTITY_INSERT \"articles\" ON INSERT INTO "articles" \("id"\) VALUES \(.{1,2}\) SET IDENTITY_INSERT \"articles\" OFF $/i
+        else
+          /^INSERT INTO "articles" \("id"\) VALUES \(.{1,2}\)$/i
+        end
+
+        log_output.first.should =~ regexp
+      end
+    end
+  end
+
+  describe '#select' do
+    before :all do
+      class ::Article
+        include DataMapper::Resource
+
+        property :name,   String, :key => true
+        property :author, String, :required => true
+
+        auto_migrate!
+      end
+
+      @article_model = Article
+
+      @article_model.create(:name => 'Learning DataMapper', :author => 'Dan Kubb')
+    end
+
+    describe 'when one field specified in SELECT statement' do
+      before :all do
+        @return = @adapter.select('SELECT name FROM articles')
+      end
+
+      it 'should return an Array' do
+        @return.should be_kind_of(Array)
+      end
+
+      it 'should have a single result' do
+        @return.size.should == 1
+      end
+
+      it 'should return an Array of values' do
+        @return.should == [ 'Learning DataMapper' ]
+      end
+    end
+
+    describe 'when more than one field specified in SELECT statement' do
+      before :all do
+        @return = @adapter.select('SELECT name, author FROM articles')
+      end
+
+      it 'should return an Array' do
+        @return.should be_kind_of(Array)
+      end
+
+      it 'should have a single result' do
+        @return.size.should == 1
+      end
+
+      it 'should return an Array of Struct objects' do
+        @return.first.should be_kind_of(Struct)
+      end
+
+      it 'should return expected values' do
+        @return.first.values.should == [ 'Learning DataMapper', 'Dan Kubb' ]
+      end
+    end
+  end
+
+  describe '#execute' do
+    before :all do
+      class ::Article
+        include DataMapper::Resource
+
+        property :name,   String, :key => true
+        property :author, String, :required => true
+
+        auto_migrate!
+      end
+
+      @article_model = Article
+    end
+
+    before :all do
+      @result = @adapter.execute('INSERT INTO articles (name, author) VALUES(?, ?)', 'Learning DataMapper', 'Dan Kubb')
+    end
+
+    it 'should return a DataObjects::Result' do
+      @result.should be_kind_of(DataObjects::Result)
+    end
+
+    it 'should affect 1 row' do
+      @result.affected_rows.should == 1
+    end
+
+    it 'should not have an insert_id' do
+      pending_if 'Inconsistent insert_id results', !(@postgres || @mysql || @oracle) do
+        @result.insert_id.should be_nil
+      end
+    end
+  end
+
+  describe '#read' do
+    before :all do
+      class ::Article
+        include DataMapper::Resource
+
+        property :name, String, :key => true
+        property :description, String, :required => false
+
+        belongs_to :parent, self, :required => false
+        has n, :children, self, :inverse => :parent
+
+        auto_migrate!
+      end
+
+      @article_model = Article
+    end
+
+    describe 'with a raw query' do
+      before :all do
+        @article_model.create(:name => 'Test', :description => 'Description').should be_saved
+        @article_model.create(:name => 'NoDescription').should be_saved
+
+        @query = DataMapper::Query.new(@repository, @article_model, :conditions => [ 'description IS NOT NULL' ])
+
+        @return = @adapter.read(@query)
+      end
+
+      it 'should return an Array of Hashes' do
+        @return.should be_kind_of(Array)
+        @return.all? { |entry| entry.should be_kind_of(Hash) }
+      end
+
+      it 'should return expected values' do
+        @return.should == [ { @article_model.properties[:name]        => 'Test',
+                              @article_model.properties[:description] => 'Description',
+                              @article_model.properties[:parent_name] => nil } ]
+      end
+    end
+
+    describe 'with a raw query with a bind value mismatch' do
+      before :all do
+        @article_model.create(:name => 'Test').should be_saved
+
+        @query = DataMapper::Query.new(@repository, @article_model, :conditions => [ 'name IS NOT NULL', nil ])
+      end
+
+      it 'should raise an error' do
+        lambda {
+          @adapter.read(@query)
+        }.should raise_error(ArgumentError, 'Binding mismatch: 1 for 0')
+      end
+    end
+
+    describe 'with a Collection bind value' do
+      describe 'with an inclusion comparison' do
+        before :all do
+          5.times do |index|
+            @article_model.create(:name => "Test #{index}", :parent => @article_model.last).should be_saved
+          end
+
+          @parents = @article_model.all
+          @query   = DataMapper::Query.new(@repository, @article_model, :parent => @parents)
+
+          @expected = @article_model.all[1, 4].map { |article| article.attributes(:property) }
+        end
+
+        describe 'that is not loaded' do
+          before :all do
+            reset_log
+            @return = @adapter.read(@query)
+          end
+
+          it 'should return an Array of Hashes' do
+            @return.should be_kind_of(Array)
+            @return.all? { |entry| entry.should be_kind_of(Hash) }
+          end
+
+          it 'should return expected values' do
+            @return.should == @expected
+          end
+
+          it 'should execute one subquery' do
+            pending_if @mysql do
+              log_output.size.should == 1
+            end
+          end
+        end
+
+        describe 'that is loaded' do
+          before :all do
+            @parents.to_a  # lazy load the collection
+          end
+
+          before :all do
+            reset_log
+            @return = @adapter.read(@query)
+          end
+
+          it 'should return an Array of Hashes' do
+            @return.should be_kind_of(Array)
+            @return.all? { |entry| entry.should be_kind_of(Hash) }
+          end
+
+          it 'should return expected values' do
+            @return.should == @expected
+          end
+
+          it 'should execute one query' do
+            log_output.size.should == 1
+          end
+        end
+      end
+
+      describe 'with an negated inclusion comparison' do
+        before :all do
+          5.times do |index|
+            @article_model.create(:name => "Test #{index}", :parent => @article_model.last).should be_saved
+          end
+
+          @parents = @article_model.all
+          @query   = DataMapper::Query.new(@repository, @article_model, :parent.not => @parents)
+
+          @expected = []
+        end
+
+        describe 'that is not loaded' do
+          before :all do
+            reset_log
+            @return = @adapter.read(@query)
+          end
+
+          it 'should return an Array of Hashes' do
+            @return.should be_kind_of(Array)
+            @return.all? { |entry| entry.should be_kind_of(Hash) }
+          end
+
+          it 'should return expected values' do
+            @return.should == @expected
+          end
+
+          it 'should execute one subquery' do
+            pending_if @mysql do
+              log_output.size.should == 1
+            end
+          end
+        end
+
+        describe 'that is loaded' do
+          before :all do
+            @parents.to_a  # lazy load the collection
+          end
+
+          before :all do
+            reset_log
+            @return = @adapter.read(@query)
+          end
+
+          it 'should return an Array of Hashes' do
+            @return.should be_kind_of(Array)
+            @return.all? { |entry| entry.should be_kind_of(Hash) }
+          end
+
+          it 'should return expected values' do
+            @return.should == @expected
+          end
+
+          it 'should execute one query' do
+            log_output.size.should == 1
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/dm-do-adapter.rb

@@ -0,0 +1 @@
+require 'dm-do-adapter/adapter'

data/tasks/local_gemfile.rake

@@ -0,0 +1,18 @@
+desc "Support bundling from local source code (allows BUNDLE_GEMFILE=Gemfile.local bundle foo)"
+task :local_gemfile do |t|
+
+  root              = Pathname(__FILE__).dirname.parent
+  datamapper        = root.parent
+
+  source_regex     = /DATAMAPPER = 'git:\/\/github.com\/datamapper'/
+  gem_source_regex = /:git => \"#\{DATAMAPPER\}\/(.+?)(?:\.git)?\"/
+
+  root.join('Gemfile.local').open('w') do |f|
+    root.join('Gemfile').open.each do |line|
+      line.sub!(source_regex,     "DATAMAPPER = '#{datamapper}'")
+      line.sub!(gem_source_regex, ':path => "#{DATAMAPPER}/\1"')
+      f.puts line
+    end
+  end
+
+end

data/tasks/yard.rake

@@ -0,0 +1,9 @@
+begin
+  require 'yard'
+
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yard do
+    abort 'YARD is not available. In order to run yard, you must: gem install yard'
+  end
+end

data/tasks/yardstick.rake

@@ -0,0 +1,19 @@
+begin
+  require 'pathname'
+  require 'yardstick/rake/measurement'
+  require 'yardstick/rake/verify'
+
+  # yardstick_measure task
+  Yardstick::Rake::Measurement.new
+
+  # verify_measurements task
+  Yardstick::Rake::Verify.new do |verify|
+    verify.threshold = 100
+  end
+rescue LoadError
+  %w[ yardstick_measure verify_measurements ].each do |name|
+    task name.to_s do
+      abort "Yardstick is not available. In order to run #{name}, you must: gem install yardstick"
+    end
+  end
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification 
+name: dm-do-adapter
+version: !ruby/object:Gem::Version 
+  prerelease: true
+  segments: 
+  - 1
+  - 0
+  - 0
+  - rc1
+  version: 1.0.0.rc1
+platform: ruby
+authors: 
+- Dan Kubb
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-19 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: data_objects
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 10
+        - 1
+        version: 0.10.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: dm-core
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        - rc1
+        version: 1.0.0.rc1
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        version: "1.3"
+  type: :development
+  version_requirements: *id003
+description: DataObjects Adapter for DataMapper
+email: dan.kubb@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- dm-do-adapter.gemspec
+- lib/dm-do-adapter.rb
+- lib/dm-do-adapter/adapter.rb
+- lib/dm-do-adapter/spec/shared_spec.rb
+- tasks/local_gemfile.rake
+- tasks/yard.rake
+- tasks/yardstick.rake
+has_rdoc: true
+homepage: http://github.com/datamapper/dm-do-adapter
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: DataObjects Adapter for DataMapper
+test_files: []
+