mysql2 0.2.6-x86-mswin32-60

data/spec/em/em_spec.rb

@@ -0,0 +1,49 @@
+# encoding: UTF-8
+if defined? EventMachine
+  require 'spec_helper'
+  require 'mysql2/em'
+
+  describe Mysql2::EM::Client do
+    it "should support async queries" do
+      results = []
+      EM.run do
+        client1 = Mysql2::EM::Client.new
+        defer1 = client1.query "SELECT sleep(0.1) as first_query"
+        defer1.callback do |result|
+          results << result.first
+          EM.stop_event_loop
+        end
+
+        client2 = Mysql2::EM::Client.new
+        defer2 = client2.query "SELECT sleep(0.025) second_query"
+        defer2.callback do |result|
+          results << result.first
+        end
+      end
+
+      results[0].keys.should include("second_query")
+      results[1].keys.should include("first_query")
+    end
+
+    it "should support queries in callbacks" do
+      results = []
+      EM.run do
+        client = Mysql2::EM::Client.new
+        defer1 = client.query "SELECT sleep(0.025) as first_query"
+        defer1.callback do |result|
+          results << result.first
+          defer2 = client.query "SELECT sleep(0.025) as second_query"
+          defer2.callback do |result|
+            results << result.first
+            EM.stop_event_loop
+          end
+        end
+      end
+
+      results[0].keys.should include("first_query")
+      results[1].keys.should include("second_query")
+    end
+  end
+else
+  puts "EventMachine not installed, skipping the specs that use it"
+end

data/spec/mysql2/client_spec.rb

@@ -0,0 +1,348 @@
+# encoding: UTF-8
+require 'spec_helper'
+
+describe Mysql2::Client do
+  before(:each) do
+    @client = Mysql2::Client.new
+  end
+
+  if defined? Encoding
+    it "should raise an exception on create for invalid encodings" do
+      lambda {
+        c = Mysql2::Client.new(:encoding => "fake")
+      }.should raise_error(Mysql2::Error)
+    end
+  end
+
+  it "should accept connect flags and pass them to #connect" do
+    klient = Class.new(Mysql2::Client) do
+      attr_reader :connect_args
+      def connect *args
+        @connect_args ||= []
+        @connect_args << args
+      end
+    end
+    client = klient.new :flags => Mysql2::Client::FOUND_ROWS
+    (client.connect_args.last.last & Mysql2::Client::FOUND_ROWS).should be_true
+  end
+
+  it "should default flags to (REMEMBER_OPTIONS, LONG_PASSWORD, LONG_FLAG, TRANSACTIONS, PROTOCOL_41, SECURE_CONNECTION)" do
+    klient = Class.new(Mysql2::Client) do
+      attr_reader :connect_args
+      def connect *args
+        @connect_args ||= []
+        @connect_args << args
+      end
+    end
+    client = klient.new
+    (client.connect_args.last.last & (Mysql2::Client::REMEMBER_OPTIONS |
+                                     Mysql2::Client::LONG_PASSWORD |
+                                     Mysql2::Client::LONG_FLAG |
+                                     Mysql2::Client::TRANSACTIONS |
+                                     Mysql2::Client::PROTOCOL_41 |
+                                     Mysql2::Client::SECURE_CONNECTION)).should be_true
+  end
+
+  it "should have a global default_query_options hash" do
+    Mysql2::Client.should respond_to(:default_query_options)
+  end
+
+  it "should be able to connect via SSL options" do
+    pending("DON'T WORRY, THIS TEST PASSES :) - but is machine-specific. You need to have MySQL running with SSL configured and enabled. Then update the paths in this test to your needs and remove the pending state.")
+    ssl_client = nil
+    lambda {
+      ssl_client = Mysql2::Client.new(
+        :sslkey => '/path/to/client-key.pem',
+        :sslcert => '/path/to/client-cert.pem',
+        :sslca => '/path/to/ca-cert.pem',
+        :sslcapath => '/path/to/newcerts/',
+        :sslcipher => 'DHE-RSA-AES256-SHA'
+      )
+    }.should_not raise_error(Mysql2::Error)
+
+    results = ssl_client.query("SHOW STATUS WHERE Variable_name = \"Ssl_version\" OR Variable_name = \"Ssl_cipher\"").to_a
+    results[0]['Variable_name'].should eql('Ssl_cipher')
+    results[0]['Value'].should_not be_nil
+    results[0]['Value'].class.should eql(String)
+
+    results[1]['Variable_name'].should eql('Ssl_version')
+    results[1]['Value'].should_not be_nil
+    results[1]['Value'].class.should eql(String)
+  end
+
+  it "should respond to #close" do
+    @client.should respond_to(:close)
+  end
+
+  it "should be able to close properly" do
+    @client.close.should be_nil
+    lambda {
+      @client.query "SELECT 1"
+    }.should raise_error(Mysql2::Error)
+  end
+
+  it "should respond to #query" do
+    @client.should respond_to(:query)
+  end
+
+  context "#query" do
+    it "should accept an options hash that inherits from Mysql2::Client.default_query_options" do
+      @client.query "SELECT 1", :something => :else
+      @client.query_options.should eql(@client.query_options.merge(:something => :else))
+    end
+
+    it "should return results as a hash by default" do
+      @client.query("SELECT 1").first.class.should eql(Hash)
+    end
+
+    it "should be able to return results as an array" do
+      @client.query("SELECT 1", :as => :array).first.class.should eql(Array)
+      @client.query("SELECT 1").each(:as => :array)
+    end
+
+    it "should be able to return results with symbolized keys" do
+      @client.query("SELECT 1", :symbolize_keys => true).first.keys[0].class.should eql(Symbol)
+    end
+
+    it "should not allow another query to be sent without fetching a result first" do
+      @client.query("SELECT 1", :async => true)
+      lambda {
+        @client.query("SELECT 1")
+      }.should raise_error(Mysql2::Error)
+    end
+
+    it "should require an open connection" do
+      @client.close
+      lambda {
+        @client.query "SELECT 1"
+      }.should raise_error(Mysql2::Error)
+    end
+
+    # XXX this test is not deterministic (because Unix signal handling is not)
+    # and may fail on a loaded system
+    if RUBY_PLATFORM !~ /mingw|mswin/
+      it "should run signal handlers while waiting for a response" do
+        mark = {}
+        trap(:USR1) { mark[:USR1] = Time.now }
+        begin
+          mark[:START] = Time.now
+          pid = fork do
+            sleep 1 # wait for client "SELECT sleep(2)" query to start
+            Process.kill(:USR1, Process.ppid)
+            sleep # wait for explicit kill to prevent GC disconnect
+          end
+          @client.query("SELECT sleep(2)")
+          mark[:END] = Time.now
+          mark.include?(:USR1).should be_true
+          (mark[:USR1] - mark[:START]).should >= 1
+          (mark[:USR1] - mark[:START]).should < 1.1
+          (mark[:END] - mark[:USR1]).should > 0.9
+          (mark[:END] - mark[:START]).should >= 2
+          (mark[:END] - mark[:START]).should < 2.1
+          Process.kill(:TERM, pid)
+          Process.waitpid2(pid)
+        ensure
+          trap(:USR1, 'DEFAULT')
+        end
+      end
+    end
+  end
+
+  it "should respond to #escape" do
+    @client.should respond_to(:escape)
+  end
+
+  context "#escape" do
+    it "should return a new SQL-escape version of the passed string" do
+      @client.escape("abc'def\"ghi\0jkl%mno").should eql("abc\\'def\\\"ghi\\0jkl%mno")
+    end
+
+    it "should return the passed string if nothing was escaped" do
+      str = "plain"
+      @client.escape(str).object_id.should eql(str.object_id)
+    end
+
+    it "should not overflow the thread stack" do
+      lambda {
+        Thread.new { @client.escape("'" * 256 * 1024) }.join
+      }.should_not raise_error(SystemStackError)
+    end
+
+    it "should not overflow the process stack" do
+      lambda {
+        Thread.new { @client.escape("'" * 1024 * 1024 * 4) }.join
+      }.should_not raise_error(SystemStackError)
+    end
+
+    it "should require an open connection" do
+      @client.close
+      lambda {
+        @client.escape ""
+      }.should raise_error(Mysql2::Error)
+    end
+  end
+
+  it "should respond to #info" do
+    @client.should respond_to(:info)
+  end
+
+  it "#info should return a hash containing the client version ID and String" do
+    info = @client.info
+    info.class.should eql(Hash)
+    info.should have_key(:id)
+    info[:id].class.should eql(Fixnum)
+    info.should have_key(:version)
+    info[:version].class.should eql(String)
+  end
+
+  if defined? Encoding
+    context "strings returned by #info" do
+      it "should default to the connection's encoding if Encoding.default_internal is nil" do
+        Encoding.default_internal = nil
+        @client.info[:version].encoding.should eql(Encoding.find('utf-8'))
+
+        client2 = Mysql2::Client.new :encoding => 'ascii'
+        client2.info[:version].encoding.should eql(Encoding.find('us-ascii'))
+      end
+
+      it "should use Encoding.default_internal" do
+        Encoding.default_internal = Encoding.find('utf-8')
+        @client.info[:version].encoding.should eql(Encoding.default_internal)
+        Encoding.default_internal = Encoding.find('us-ascii')
+        @client.info[:version].encoding.should eql(Encoding.default_internal)
+      end
+    end
+  end
+
+  it "should respond to #server_info" do
+    @client.should respond_to(:server_info)
+  end
+
+  it "#server_info should return a hash containing the client version ID and String" do
+    server_info = @client.server_info
+    server_info.class.should eql(Hash)
+    server_info.should have_key(:id)
+    server_info[:id].class.should eql(Fixnum)
+    server_info.should have_key(:version)
+    server_info[:version].class.should eql(String)
+  end
+
+  it "#server_info should require an open connection" do
+    @client.close
+    lambda {
+      @client.server_info
+    }.should raise_error(Mysql2::Error)
+  end
+
+  if defined? Encoding
+    context "strings returned by #server_info" do
+      it "should default to the connection's encoding if Encoding.default_internal is nil" do
+        Encoding.default_internal = nil
+        @client.server_info[:version].encoding.should eql(Encoding.find('utf-8'))
+
+        client2 = Mysql2::Client.new :encoding => 'ascii'
+        client2.server_info[:version].encoding.should eql(Encoding.find('us-ascii'))
+      end
+
+      it "should use Encoding.default_internal" do
+        Encoding.default_internal = Encoding.find('utf-8')
+        @client.server_info[:version].encoding.should eql(Encoding.default_internal)
+        Encoding.default_internal = Encoding.find('us-ascii')
+        @client.server_info[:version].encoding.should eql(Encoding.default_internal)
+      end
+    end
+  end
+
+  it "should respond to #socket" do
+    @client.should respond_to(:socket)
+  end
+
+  it "#socket should return a Fixnum (file descriptor from C)" do
+    @client.socket.class.should eql(Fixnum)
+    @client.socket.should_not eql(0)
+  end
+
+  it "#socket should require an open connection" do
+    @client.close
+    lambda {
+      @client.socket
+    }.should raise_error(Mysql2::Error)
+  end
+
+  it "should raise a Mysql2::Error exception upon connection failure" do
+    lambda {
+      bad_client = Mysql2::Client.new :host => "dfjhdi9wrhw", :username => 'asdfasdf8d2h'
+    }.should raise_error(Mysql2::Error)
+
+    lambda {
+      good_client = Mysql2::Client.new
+    }.should_not raise_error(Mysql2::Error)
+  end
+
+  it "threaded queries should be supported" do
+    threads, results = [], {}
+    connect = lambda{ Mysql2::Client.new(:host => "localhost", :username => "root") }
+    Timeout.timeout(0.7) do
+      5.times {
+        threads << Thread.new do
+          results[Thread.current.object_id] = connect.call.query("SELECT sleep(0.5) as result")
+        end
+      }
+    end
+    threads.each{|t| t.join }
+    results.keys.sort.should eql(threads.map{|t| t.object_id }.sort)
+  end
+
+  it "evented async queries should be supported" do
+    # should immediately return nil
+    @client.query("SELECT sleep(0.1)", :async => true).should eql(nil)
+
+    io_wrapper = IO.for_fd(@client.socket)
+    loops = 0
+    loop do
+      if IO.select([io_wrapper], nil, nil, 0.05)
+        break
+      else
+        loops += 1
+      end
+    end
+
+    # make sure we waited some period of time
+    (loops >= 1).should be_true
+
+    result = @client.async_result
+    result.class.should eql(Mysql2::Result)
+  end
+
+  context 'write operations api' do
+    before(:each) do
+      @client.query "USE test"
+      @client.query "CREATE TABLE lastIdTest (`id` int(11) NOT NULL AUTO_INCREMENT, blah INT(11), PRIMARY KEY (`id`))"
+    end
+
+    after(:each) do
+      @client.query "DROP TABLE lastIdTest"
+    end
+
+    it "should respond to #last_id" do
+      @client.should respond_to(:last_id)
+    end
+
+    it "#last_id should return a Fixnum, the from the last INSERT/UPDATE" do
+      @client.last_id.should eql(0)
+      @client.query "INSERT INTO lastIdTest (blah) VALUES (1234)"
+      @client.last_id.should eql(1)
+    end
+
+    it "should respond to #last_id" do
+      @client.should respond_to(:last_id)
+    end
+
+    it "#last_id should return a Fixnum, the from the last INSERT/UPDATE" do
+      @client.query "INSERT INTO lastIdTest (blah) VALUES (1234)"
+      @client.affected_rows.should eql(1)
+      @client.query "UPDATE lastIdTest SET blah=4321 WHERE id=1"
+      @client.affected_rows.should eql(1)
+    end
+  end
+end

data/spec/mysql2/error_spec.rb

@@ -0,0 +1,25 @@
+# encoding: UTF-8
+require 'spec_helper'
+
+describe Mysql2::Error do
+  before(:each) do
+    @error = Mysql2::Error.new "testing"
+  end
+  
+  it "should respond to #error_number" do
+    @error.should respond_to(:error_number)
+  end
+  
+  it "should respond to #sql_state" do
+    @error.should respond_to(:sql_state)
+  end
+
+  # Mysql gem compatibility
+  it "should alias #error_number to #errno" do
+    @error.should respond_to(:errno)
+  end
+
+  it "should alias #message to #error" do
+    @error.should respond_to(:error)
+  end
+end

data/spec/mysql2/result_spec.rb

@@ -0,0 +1,318 @@
+# encoding: UTF-8
+require 'spec_helper'
+
+describe Mysql2::Result do
+  before(:each) do
+    @client = Mysql2::Client.new :host => "localhost", :username => "root"
+  end
+
+  before(:each) do
+    @result = @client.query "SELECT 1"
+  end
+
+  it "should have included Enumerable" do
+    Mysql2::Result.ancestors.include?(Enumerable).should be_true
+  end
+
+  it "should respond to #each" do
+    @result.should respond_to(:each)
+  end
+
+  it "should raise a Mysql2::Error exception upon a bad query" do
+    lambda {
+      @client.query "bad sql"
+    }.should raise_error(Mysql2::Error)
+
+    lambda {
+      @client.query "SELECT 1"
+    }.should_not raise_error(Mysql2::Error)
+  end
+
+  context "#each" do
+    it "should yield rows as hash's" do
+      @result.each do |row|
+        row.class.should eql(Hash)
+      end
+    end
+
+    it "should yield rows as hash's with symbol keys if :symbolize_keys was set to true" do
+      @result.each(:symbolize_keys => true) do |row|
+        row.keys.first.class.should eql(Symbol)
+      end
+    end
+
+    it "should be able to return results as an array" do
+      @result.each(:as => :array) do |row|
+        row.class.should eql(Array)
+      end
+    end
+
+    it "should cache previously yielded results by default" do
+      @result.first.object_id.should eql(@result.first.object_id)
+    end
+
+    it "should not cache previously yielded results if cache_rows is disabled" do
+      result = @client.query "SELECT 1", :cache_rows => false
+      result.first.object_id.should_not eql(result.first.object_id)
+    end
+  end
+
+  context "#fields" do
+    before(:each) do
+      @client.query "USE test"
+      @test_result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1")
+    end
+
+    it "method should exist" do
+      @test_result.should respond_to(:fields)
+    end
+
+    it "should return an array of field names in proper order" do
+      result = @client.query "SELECT 'a', 'b', 'c'"
+      result.fields.should eql(['a', 'b', 'c'])
+    end
+  end
+
+  context "row data type mapping" do
+    before(:each) do
+      @client.query "USE test"
+      @test_result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+    end
+
+    it "should return nil for a NULL value" do
+      @test_result['null_test'].class.should eql(NilClass)
+      @test_result['null_test'].should eql(nil)
+    end
+
+    it "should return Fixnum for a BIT value" do
+      @test_result['bit_test'].class.should eql(String)
+      @test_result['bit_test'].should eql("\000\000\000\000\000\000\000\005")
+    end
+
+    it "should return Fixnum for a TINYINT value" do
+      [Fixnum, Bignum].should include(@test_result['tiny_int_test'].class)
+      @test_result['tiny_int_test'].should eql(1)
+    end
+
+    it "should return TrueClass or FalseClass for a TINYINT value if :cast_booleans is enabled" do
+      @client.query 'INSERT INTO mysql2_test (bool_cast_test) VALUES (1)'
+      id1 = @client.last_id
+      @client.query 'INSERT INTO mysql2_test (bool_cast_test) VALUES (0)'
+      id2 = @client.last_id
+
+      result1 = @client.query 'SELECT bool_cast_test FROM mysql2_test WHERE bool_cast_test = 1 LIMIT 1', :cast_booleans => true
+      result2 = @client.query 'SELECT bool_cast_test FROM mysql2_test WHERE bool_cast_test = 0 LIMIT 1', :cast_booleans => true
+      result1.first['bool_cast_test'].should be_true
+      result2.first['bool_cast_test'].should be_false
+
+      @client.query "DELETE from mysql2_test WHERE id IN(#{id1},#{id2})"
+    end
+
+    it "should return Fixnum for a SMALLINT value" do
+      [Fixnum, Bignum].should include(@test_result['small_int_test'].class)
+      @test_result['small_int_test'].should eql(10)
+    end
+
+    it "should return Fixnum for a MEDIUMINT value" do
+      [Fixnum, Bignum].should include(@test_result['medium_int_test'].class)
+      @test_result['medium_int_test'].should eql(10)
+    end
+
+    it "should return Fixnum for an INT value" do
+      [Fixnum, Bignum].should include(@test_result['int_test'].class)
+      @test_result['int_test'].should eql(10)
+    end
+
+    it "should return Fixnum for a BIGINT value" do
+      [Fixnum, Bignum].should include(@test_result['big_int_test'].class)
+      @test_result['big_int_test'].should eql(10)
+    end
+
+    it "should return Fixnum for a YEAR value" do
+      [Fixnum, Bignum].should include(@test_result['year_test'].class)
+      @test_result['year_test'].should eql(2009)
+    end
+
+    it "should return BigDecimal for a DECIMAL value" do
+      @test_result['decimal_test'].class.should eql(BigDecimal)
+      @test_result['decimal_test'].should eql(10.3)
+    end
+
+    it "should return Float for a FLOAT value" do
+      @test_result['float_test'].class.should eql(Float)
+      @test_result['float_test'].should eql(10.3)
+    end
+
+    it "should return Float for a DOUBLE value" do
+      @test_result['double_test'].class.should eql(Float)
+      @test_result['double_test'].should eql(10.3)
+    end
+
+    it "should return Time for a DATETIME value when within the supported range" do
+      @test_result['date_time_test'].class.should eql(Time)
+      @test_result['date_time_test'].strftime("%F %T").should eql('2010-04-04 11:44:00')
+    end
+
+    it "should return DateTime for a DATETIME value when outside the supported range" do
+      r = @client.query("SELECT CAST('1901-1-1 01:01:01' AS DATETIME) as test")
+      r.first['test'].class.should eql(DateTime)
+    end
+
+    it "should return Time for a TIMESTAMP value when within the supported range" do
+      @test_result['timestamp_test'].class.should eql(Time)
+      @test_result['timestamp_test'].strftime("%F %T").should eql('2010-04-04 11:44:00')
+    end
+
+    it "should return Time for a TIME value" do
+      @test_result['time_test'].class.should eql(Time)
+      @test_result['time_test'].strftime("%F %T").should eql('2000-01-01 11:44:00')
+    end
+
+    it "should return Date for a DATE value" do
+      @test_result['date_test'].class.should eql(Date)
+      @test_result['date_test'].strftime("%F").should eql('2010-04-04')
+    end
+
+    it "should return String for an ENUM value" do
+      @test_result['enum_test'].class.should eql(String)
+      @test_result['enum_test'].should eql('val1')
+    end
+
+    if defined? Encoding
+      context "string encoding for ENUM values" do
+        it "should default to the connection's encoding if Encoding.default_internal is nil" do
+          Encoding.default_internal = nil
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['enum_test'].encoding.should eql(Encoding.find('utf-8'))
+
+          client2 = Mysql2::Client.new :encoding => 'ascii'
+          client2.query "USE test"
+          result = client2.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['enum_test'].encoding.should eql(Encoding.find('us-ascii'))
+        end
+
+        it "should use Encoding.default_internal" do
+          Encoding.default_internal = Encoding.find('utf-8')
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['enum_test'].encoding.should eql(Encoding.default_internal)
+          Encoding.default_internal = Encoding.find('us-ascii')
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['enum_test'].encoding.should eql(Encoding.default_internal)
+        end
+      end
+    end
+
+    it "should return String for a SET value" do
+      @test_result['set_test'].class.should eql(String)
+      @test_result['set_test'].should eql('val1,val2')
+    end
+
+    if defined? Encoding
+      context "string encoding for SET values" do
+        it "should default to the connection's encoding if Encoding.default_internal is nil" do
+          Encoding.default_internal = nil
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['set_test'].encoding.should eql(Encoding.find('utf-8'))
+
+          client2 = Mysql2::Client.new :encoding => 'ascii'
+          client2.query "USE test"
+          result = client2.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['set_test'].encoding.should eql(Encoding.find('us-ascii'))
+        end
+
+        it "should use Encoding.default_internal" do
+          Encoding.default_internal = Encoding.find('utf-8')
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['set_test'].encoding.should eql(Encoding.default_internal)
+          Encoding.default_internal = Encoding.find('us-ascii')
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['set_test'].encoding.should eql(Encoding.default_internal)
+        end
+      end
+    end
+
+    it "should return String for a BINARY value" do
+      @test_result['binary_test'].class.should eql(String)
+      @test_result['binary_test'].should eql("test#{"\000"*6}")
+    end
+
+    if defined? Encoding
+      context "string encoding for BINARY values" do
+        it "should default to binary if Encoding.default_internal is nil" do
+          Encoding.default_internal = nil
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['binary_test'].encoding.should eql(Encoding.find('binary'))
+        end
+
+        it "should not use Encoding.default_internal" do
+          Encoding.default_internal = Encoding.find('utf-8')
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['binary_test'].encoding.should eql(Encoding.find('binary'))
+          Encoding.default_internal = Encoding.find('us-ascii')
+          result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+          result['binary_test'].encoding.should eql(Encoding.find('binary'))
+        end
+      end
+    end
+
+    {
+      'char_test' => 'CHAR',
+      'varchar_test' => 'VARCHAR',
+      'varbinary_test' => 'VARBINARY',
+      'tiny_blob_test' => 'TINYBLOB',
+      'tiny_text_test' => 'TINYTEXT',
+      'blob_test' => 'BLOB',
+      'text_test' => 'TEXT',
+      'medium_blob_test' => 'MEDIUMBLOB',
+      'medium_text_test' => 'MEDIUMTEXT',
+      'long_blob_test' => 'LONGBLOB',
+      'long_text_test' => 'LONGTEXT'
+    }.each do |field, type|
+      it "should return a String for #{type}" do
+        @test_result[field].class.should eql(String)
+        @test_result[field].should eql("test")
+      end
+
+      if defined? Encoding
+        context "string encoding for #{type} values" do
+          if ['VARBINARY', 'TINYBLOB', 'BLOB', 'MEDIUMBLOB', 'LONGBLOB'].include?(type)
+            it "should default to binary if Encoding.default_internal is nil" do
+              Encoding.default_internal = nil
+              result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+              result['binary_test'].encoding.should eql(Encoding.find('binary'))
+            end
+
+            it "should not use Encoding.default_internal" do
+              Encoding.default_internal = Encoding.find('utf-8')
+              result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+              result['binary_test'].encoding.should eql(Encoding.find('binary'))
+              Encoding.default_internal = Encoding.find('us-ascii')
+              result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+              result['binary_test'].encoding.should eql(Encoding.find('binary'))
+            end
+          else
+            it "should default to utf-8 if Encoding.default_internal is nil" do
+              Encoding.default_internal = nil
+              result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+              result[field].encoding.should eql(Encoding.find('utf-8'))
+
+              client2 = Mysql2::Client.new :encoding => 'ascii'
+              client2.query "USE test"
+              result = client2.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+              result[field].encoding.should eql(Encoding.find('us-ascii'))
+            end
+
+            it "should use Encoding.default_internal" do
+              Encoding.default_internal = Encoding.find('utf-8')
+              result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+              result[field].encoding.should eql(Encoding.default_internal)
+              Encoding.default_internal = Encoding.find('us-ascii')
+              result = @client.query("SELECT * FROM mysql2_test ORDER BY id DESC LIMIT 1").first
+              result[field].encoding.should eql(Encoding.default_internal)
+            end
+          end
+        end
+      end
+    end
+  end
+end