sbf-do_mysql 0.10.17

data/spec/encoding_spec.rb

@@ -0,0 +1,46 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
+require 'data_objects/spec/shared/encoding_spec'
+
+describe DataObjects::Mysql::Connection do
+  it_behaves_like 'a driver supporting different encodings'
+  it_behaves_like 'returning correctly encoded strings for the default database encoding'
+  it_behaves_like 'returning correctly encoded strings for the default internal encoding'
+
+  describe 'sets the character set through the URI' do
+    before do
+      @utf8mb4_connection = DataObjects::Connection.new(
+        "#{CONFIG.scheme}://#{CONFIG.user}:#{CONFIG.pass}@#{CONFIG.host}:#{CONFIG.port}#{CONFIG.database}?encoding=UTF-8-MB4"
+      )
+    end
+
+    after { @utf8mb4_connection.close }
+
+    it { expect(@utf8mb4_connection.character_set).to eq 'UTF-8-MB4' }
+
+    describe 'writing a multibyte String' do
+      it 'writes a multibyte String' do
+        @command = @utf8mb4_connection.create_command('INSERT INTO users_mb4 (name) VALUES(?)')
+        expect { @command.execute_non_query('😀') }.not_to raise_error
+      end
+    end
+
+    describe 'reading a String' do
+      before do
+        @reader = @utf8mb4_connection.create_command('SELECT name FROM users_mb4').execute_reader
+        @reader.next!
+        @values = @reader.values
+      end
+
+      after do
+        @reader.close
+      end
+
+      it 'returns a UTF-8 encoded String' do
+        expect(@values.first).to be_kind_of(String)
+        expect(@values.first.encoding.name).to eq 'UTF-8'
+        expect(@values.first).to eq '😀'
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/BlockLength

data/spec/error/sql_error_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/error/sql_error_spec'
+
+describe 'DataObjects::Mysql raising SQLError' do
+  it_behaves_like 'raising a SQLError'
+end

data/spec/reader_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
+require 'data_objects/spec/shared/reader_spec'
+
+describe DataObjects::Mysql::Reader do
+  it_behaves_like 'a Reader'
+
+  describe 'reading database metadata' do
+    subject { reader }
+
+    let(:connection) { DataObjects::Connection.new(CONFIG.uri) }
+    let(:command) { connection.create_command(sql) }
+    let(:reader) { command.execute_reader }
+
+    after do
+      reader.close
+      connection.close
+    end
+
+    describe 'showing correct column field names for a table' do
+      let(:sql) { 'SHOW COLUMNS FROM `widgets`' }
+      its(:fields) { is_expected.to eq %w(Field Type Null Key Default Extra) }
+    end
+
+    describe 'showing correct column field names for variables' do
+      let(:sql) { "SHOW VARIABLES LIKE 'character_set_connection'" }
+      its(:fields) { is_expected.to eq %w(Variable_name Value) }
+    end
+  end
+end

data/spec/result_spec.rb

@@ -0,0 +1,38 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
+require 'data_objects/spec/shared/result_spec'
+
+# splitting the describe into two separate declaration avoids
+# concurrent execution of the "it_behaves_like ....."
+# needed by some databases (sqlite3)
+
+describe DataObjects::Mysql::Result do
+  it_behaves_like 'a Result'
+end
+
+describe DataObjects::Mysql::Result do
+  it_behaves_like 'a Result which returns inserted key with sequences'
+  it_behaves_like 'a Result which returns nil without sequences'
+end
+
+describe DataObjects::Mysql::Result do
+  describe 'insert_id' do
+    before do
+      setup_test_environment
+      @connection = DataObjects::Connection.new(CONFIG.uri)
+      # set the sequence to a value larger than SQL integer
+      command = @connection.create_command('INSERT INTO stuff (id, value) VALUES (?,?)')
+      command.execute_non_query(3_000_000_000, 'cow')
+      # use the sequence to generate an id
+      command = @connection.create_command('INSERT INTO stuff (value) VALUES (?)')
+      @result = command.execute_non_query('monkey')
+    end
+
+    after do
+      @connection.close
+    end
+
+    it 'returns the bigint id' do
+      expect(@result.insert_id).to eq 3_000_000_001
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,242 @@
+# rubocop:disable Style/GlobalVars
+$TESTING = true
+# rubocop:enable Style/GlobalVars
+
+require 'rubygems'
+require 'rspec'
+require 'rspec/its'
+require 'date'
+require 'ostruct'
+require 'fileutils'
+require 'win32console' if RUBY_PLATFORM =~ /mingw|mswin/
+
+driver_lib = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(driver_lib) unless $LOAD_PATH.include?(driver_lib)
+
+# Prepend data_objects/do_jdbc in the repository to the load path.
+# DO NOT USE installed gems, except when running the specs from gem.
+repo_root = File.expand_path('../..', __dir__)
+
+lib_path = "#{repo_root}/data_objects/lib"
+$LOAD_PATH.unshift(lib_path) if File.directory?(lib_path) && !$LOAD_PATH.include?(lib_path)
+
+require 'data_objects'
+require 'data_objects/spec/setup'
+require 'data_objects/spec/lib/ssl'
+require 'data_objects/spec/lib/pending_helpers'
+require 'do_mysql'
+
+DataObjects::Mysql.logger = DataObjects::Logger.new($stdout, :off)
+at_exit { DataObjects.logger.flush }
+
+CONFIG = OpenStruct.new
+CONFIG.scheme   = 'mysql'
+CONFIG.user     = ENV['DO_MYSQL_USER'] || 'root'
+CONFIG.pass     = ENV['DO_MYSQL_PASS'] || ''
+CONFIG.user_info = if CONFIG.user == 'root' && CONFIG.pass.empty?
+                     ''
+                   else
+                     "#{CONFIG.user}:#{CONFIG.pass}@"
+                   end
+CONFIG.host     = ENV['DO_MYSQL_HOST'] || 'localhost'
+CONFIG.port     = ENV['DO_MYSQL_PORT'] || '3306'
+CONFIG.database = ENV['DO_MYSQL_DATABASE'] || '/do_test'
+CONFIG.ssl      = SSLHelpers.query(:ca_cert, :client_cert, :client_key)
+
+CONFIG.driver       = 'mysql'
+CONFIG.uri          = ENV['DO_MYSQL_SPEC_URI'] ||
+                      "#{CONFIG.scheme}://#{CONFIG.user_info}#{CONFIG.host}:#{CONFIG.port}#{CONFIG.database}?zeroDateTimeBehavior=convertToNull"
+CONFIG.sleep        = 'SELECT sleep(1)'
+
+module DataObjectsSpecHelpers
+  # rubocop:disable Metrics/MethodLength
+  def setup_test_environment
+    conn = DataObjects::Connection.new(CONFIG.uri)
+
+    conn.create_command(<<-EOF).execute_non_query
+      DROP TABLE IF EXISTS `invoices`
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      DROP TABLE IF EXISTS `users`
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      DROP TABLE IF EXISTS `users_mb4`
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      DROP TABLE IF EXISTS `stuff`
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      DROP TABLE IF EXISTS `widgets`
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      CREATE TABLE `users` (
+        `id` int(11) NOT NULL auto_increment,
+        `name` varchar(200) default 'Billy' NULL,
+        `fired_at` timestamp,
+        PRIMARY KEY  (`id`)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      CREATE TABLE `users_mb4` (
+        `id` int(11) NOT NULL auto_increment,
+        `name` varchar(200),
+        PRIMARY KEY  (`id`)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      CREATE TABLE `invoices` (
+        `invoice_number` varchar(50) NOT NULL,
+        PRIMARY KEY  (`invoice_number`)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      CREATE TABLE `stuff` (
+        `id` bigint NOT NULL auto_increment,
+        `value` varchar(50) NULL,
+        PRIMARY KEY  (`id`)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      CREATE TABLE `widgets` (
+        `id` int(11) NOT NULL auto_increment,
+        `code` char(8) default 'A14' NULL,
+        `name` varchar(200) default 'Super Widget' NULL,
+        `shelf_location` tinytext NULL,
+        `description` text NULL,
+        `image_data` blob NULL,
+        `ad_description` mediumtext NULL,
+        `ad_image` mediumblob NULL,
+        `whitepaper_text` longtext NULL,
+        `cad_drawing` longblob NULL,
+        `flags` boolean default false,
+        `number_in_stock` smallint default 500,
+        `number_sold` mediumint default 0,
+        `super_number` bigint default 9223372036854775807,
+        `weight` float default 1.23,
+        `cost1` double default 10.23,
+        `cost2` decimal(8,2) default 50.23,
+        `release_date` date default '2008-02-14',
+        `release_datetime` datetime default '2008-02-14 00:31:12',
+        `release_timestamp` timestamp NULL default '2008-02-14 00:31:31',
+        `status` enum('active','out of stock') NOT NULL default 'active',
+        PRIMARY KEY  (`id`)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
+    EOF
+
+    1.upto(16) do |n|
+      conn.create_command(<<-EOF).execute_non_query
+        insert into widgets(code, name, shelf_location, description, image_data, ad_description, ad_image, whitepaper_text, cad_drawing, super_number, weight) VALUES ('W#{n.to_s.rjust(7, '0')}', 'Widget #{n}', 'A14', 'This is a description', 'IMAGE DATA', 'Buy this product now!', 'AD IMAGE DATA', 'String', 'CAD \001 \000 DRAWING', 1234, 13.4);
+      EOF
+    end
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set flags = true where id = 2
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set ad_description = NULL where id = 3
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set flags = NULL where id = 4
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set cost1 = NULL where id = 5
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set cost2 = NULL where id = 6
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set release_date = NULL where id = 7
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set release_datetime = NULL where id = 8
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set release_timestamp = NULL where id = 9
+    EOF
+
+    conn.create_command(<<-EOF).execute_non_query
+      update widgets set release_datetime = '2008-07-14 00:31:12' where id = 10
+    EOF
+
+    conn.close
+  end
+  # rubocop:enable Metrics/MethodLength
+
+  def self.test_environment_ssl_config
+    ssl_config = SSLHelpers::CONFIG
+
+    message =  "\nYou can configure MySQL via my.cnf with the following options in [mysqld]:\n"
+    message << "ssl_ca=#{ssl_config.ca_cert}\n"
+    message << "ssl_cert=#{ssl_config.server_cert}\n"
+    message << "ssl_key=#{ssl_config.server_key}\n"
+    message << "ssl_cipher=#{ssl_config.cipher}\n"
+
+    message << "\nOr you can use the following command line options:\n"
+    message << "--ssl-ca #{ssl_config.ca_cert} "
+    message << "--ssl-cert #{ssl_config.server_cert} "
+    message << "--ssl-key #{ssl_config.server_key} "
+    message << "--ssl-cipher #{ssl_config.cipher} "
+    message
+  end
+
+  def self.test_environment_ssl_config_errors
+    conn = DataObjects::Connection.new(CONFIG.uri)
+
+    ssl_variables = conn.create_command(<<-EOF).execute_reader
+      SHOW VARIABLES LIKE '%ssl%'
+    EOF
+
+    ssl_config = SSLHelpers::CONFIG
+    current_config = {}
+
+    while ssl_variables.next!
+      variable, value = ssl_variables.values
+      current_config[variable.intern] = value
+    end
+
+    errors = []
+
+    errors << 'SSL was not compiled' if current_config[:have_ssl] == 'NO'
+
+    errors << 'SSL was not enabled' if current_config[:have_ssl] == 'DISABLED'
+
+    errors << "The CA certificate is not configured (it was set to '#{current_config[:ssl_ca]}')" if current_config[:ssl_ca] != ssl_config.ca_cert
+
+    if current_config[:ssl_cert] != ssl_config.server_cert
+      errors << "The server certificate is not configured (it was set to '#{current_config[:ssl_cert]}')"
+    end
+
+    errors << "The server key is not configured, (it was set to '#{current_config[:ssl_key]}')" if current_config[:ssl_key] != ssl_config.server_key
+
+    errors << "The cipher is not configured, (it was set to '#{current_config[:ssl_cipher]}')" if current_config[:ssl_cipher] != ssl_config.cipher
+
+    errors
+  ensure
+    conn.close
+  end
+
+  def self.test_environment_supports_ssl?
+    test_environment_ssl_config_errors.empty?
+  end
+end
+
+RSpec.configure do |config|
+  config.include(DataObjectsSpecHelpers)
+  config.include(DataObjects::Spec::PendingHelpers)
+end

data/spec/typecast/array_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/array_spec'
+
+describe 'DataObjects::Mysql with Array' do
+  it_behaves_like 'supporting Array'
+end

data/spec/typecast/bigdecimal_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/bigdecimal_spec'
+
+describe 'DataObjects::Mysql with BigDecimal' do
+  it_behaves_like 'supporting BigDecimal'
+  it_behaves_like 'supporting BigDecimal autocasting'
+end

data/spec/typecast/boolean_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/boolean_spec'
+
+describe 'DataObjects::Mysql with Boolean' do
+  it_behaves_like 'supporting Boolean'
+  it_behaves_like 'supporting Boolean autocasting'
+end

data/spec/typecast/byte_array_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/byte_array_spec'
+
+describe 'DataObjects::Mysql with ByteArray' do
+  it_behaves_like 'supporting ByteArray'
+end

data/spec/typecast/class_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/class_spec'
+
+describe 'DataObjects::Mysql with Class' do
+  it_behaves_like 'supporting Class'
+end

data/spec/typecast/date_spec.rb

@@ -0,0 +1,30 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/date_spec'
+
+describe 'DataObjects::Mysql with Date' do
+  it_behaves_like 'supporting Date'
+  it_behaves_like 'supporting Date autocasting'
+
+  describe 'reading 0000-00-00' do
+    before do
+      @connection = DataObjects::Connection.new(CONFIG.uri)
+
+      @connection.create_command("SET SESSION sql_mode = 'ALLOW_INVALID_DATES'").execute_non_query
+      @connection.create_command("INSERT INTO widgets (release_date) VALUES ('')").execute_non_query
+
+      @command = @connection.create_command("SELECT release_date FROM widgets WHERE release_date = '0000-00-00'")
+      @reader = @command.execute_reader
+      @reader.next!
+      @values = @reader.values
+    end
+
+    after do
+      @reader.close
+      @connection.close
+    end
+
+    it 'returns the number of created rows' do
+      expect(@values.first).to be_nil
+    end
+  end
+end

data/spec/typecast/datetime_spec.rb

@@ -0,0 +1,30 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/datetime_spec'
+
+describe 'DataObjects::Mysql with DateTime' do
+  it_behaves_like 'supporting DateTime'
+  it_behaves_like 'supporting DateTime autocasting'
+
+  describe 'reading 0000-00-00 00:00:00' do
+    before do
+      @connection = DataObjects::Connection.new(CONFIG.uri)
+
+      @connection.create_command("SET SESSION sql_mode = 'ALLOW_INVALID_DATES'").execute_non_query
+      @connection.create_command("INSERT INTO widgets (release_datetime) VALUES ('')").execute_non_query
+
+      @command = @connection.create_command("SELECT release_datetime FROM widgets WHERE release_datetime = '0000-00-00 00:00:00'")
+      @reader = @command.execute_reader
+      @reader.next!
+      @values = @reader.values
+    end
+
+    after do
+      @reader.close
+      @connection.close
+    end
+
+    it 'returns the number of created rows' do
+      expect(@values.first).to be_nil
+    end
+  end
+end

data/spec/typecast/float_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/float_spec'
+
+describe 'DataObjects::Mysql with Float' do
+  it_behaves_like 'supporting Float'
+  it_behaves_like 'supporting Float autocasting'
+end

data/spec/typecast/integer_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/integer_spec'
+
+describe 'DataObjects::Mysql with Integer' do
+  it_behaves_like 'supporting Integer'
+end

data/spec/typecast/nil_spec.rb

@@ -0,0 +1,8 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/nil_spec'
+
+describe 'DataObjects::Mysql with Nil' do
+  it_behaves_like 'supporting Nil'
+  it_behaves_like 'supporting writing an Nil'
+  it_behaves_like 'supporting Nil autocasting'
+end

data/spec/typecast/other_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/other_spec'
+
+describe 'DataObjects::H2 with other (unknown) type' do
+  it_behaves_like 'supporting other (unknown) type'
+end

data/spec/typecast/range_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/range_spec'
+
+describe 'DataObjects::Mysql with Range' do
+  it_behaves_like 'supporting Range'
+end

data/spec/typecast/string_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/string_spec'
+
+describe 'DataObjects::Mysql with String' do
+  it_behaves_like 'supporting String'
+end

data/spec/typecast/time_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+require 'data_objects/spec/shared/typecast/time_spec'
+
+describe 'DataObjects::Mysql with Time' do
+  it_behaves_like 'supporting Time'
+end

data/tasks/compile.rake

@@ -0,0 +1,16 @@
+begin
+  gem 'rake-compiler', '~>1.2'
+  require 'rake/extensiontask'
+
+  def gemspec
+    @gemspec ||= Gem::Specification.load(File.expand_path('../do_mysql.gemspec', __dir__))
+  end
+
+  Rake::ExtensionTask.new('do_mysql', gemspec) do |ext|
+    ext.lib_dir = "lib/#{gemspec.name}"
+
+    # automatically add build options to avoid need of manual input
+  end
+rescue LoadError
+  warn 'To compile, install rake-compiler (gem install rake-compiler)'
+end

data/tasks/release.rake

@@ -0,0 +1,14 @@
+desc 'Builds all gems (native, binaries for JRuby and Windows)'
+task :build_all do
+  `rake clean`
+  `rake build`
+end
+
+desc 'Release all gems (native, binaries for JRuby and Windows)'
+task release_all: :build_all do
+  Dir.children("pkg").each do |gem_path|
+    command = "gem push pkg/#{gem_path}"
+    puts "Executing #{command.inspect}:"
+    sh command
+  end
+end

data/tasks/retrieve.rake

@@ -0,0 +1,20 @@
+begin
+  gem 'rake-compiler', '~>1.2'
+  require 'rake/clean'
+  require 'rake/extensioncompiler'
+
+  # download mysql library and headers
+  directory 'vendor'
+
+  # only on Windows or cross platform compilation
+
+
+
+  # clobber vendored packages
+  CLOBBER.include('vendor')
+
+  # vendor:mysql
+
+  # hook into cross compilation vendored mysql dependency
+rescue LoadError
+end

data/tasks/spec.rake

@@ -0,0 +1,10 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(spec: %i(clean compile)) do |spec|
+  spec.pattern = './spec/**/*_spec.rb'
+
+  require 'simplecov'
+  SimpleCov.start do
+    minimum_coverage 100
+  end
+end

data/tasks/ssl.rake

@@ -0,0 +1,26 @@
+namespace :ssl do
+  task :env do
+    require ROOT.join('spec', 'spec_helper')
+  end
+
+  desc 'Check test environment for SSL support.'
+  task check: :env do
+    DataObjectsSpecHelpers.test_environment_supports_ssl?
+
+    puts
+    if DataObjectsSpecHelpers.test_environment_supports_ssl?
+      puts '** SSL successfully configured for the test environment **'
+    else
+      puts '** SSL is not configured for the test environment **'
+      puts
+      puts DataObjectsSpecHelpers.test_environment_ssl_config_errors.join("\n")
+      puts
+      raise 'Run rake ssl:config for instructions on how to configure the test environment.'
+    end
+  end
+
+  desc 'Provide instructions on how to configure SSL in your test environment.'
+  task config: :env do
+    puts DataObjectsSpecHelpers.test_environment_ssl_config
+  end
+end