pg 0.18.0.pre20140820094244 → 0.18.0.pre20141017155815

data/spec/pg/type_map_by_mri_type_spec.rb

@@ -0,0 +1,122 @@
+#!/usr/bin/env rspec
+# encoding: utf-8
+
+require_relative '../helpers'
+
+require 'pg'
+
+
+describe PG::TypeMapByMriType do
+
+	let!(:textenc_int){ PG::TextEncoder::Integer.new name: 'INT4', oid: 23 }
+	let!(:textenc_float){ PG::TextEncoder::Float.new name: 'FLOAT8', oid: 701 }
+	let!(:textenc_string){ PG::TextEncoder::String.new name: 'TEXT', oid: 25 }
+	let!(:binaryenc_int){ PG::BinaryEncoder::Int8.new name: 'INT8', oid: 20, format: 1 }
+	let!(:pass_through_type) do
+		type = Class.new(PG::SimpleEncoder) do
+			def encode(*v)
+				v.inspect
+			end
+		end.new
+		type.oid = 25
+		type.format = 0
+		type.name = 'pass_through'
+		type
+	end
+
+	let!(:tm) do
+		tm = PG::TypeMapByMriType.new
+		tm['T_FIXNUM'] = binaryenc_int
+		tm['T_FLOAT'] = textenc_float
+		tm['T_SYMBOL'] = pass_through_type
+		tm
+	end
+
+	let!(:derived_tm) do
+		tm = Class.new(PG::TypeMapByMriType) do
+			def array_type_map_for(value)
+				PG::TextEncoder::Array.new name: '_INT4', oid: 1007, elements_type: PG::TextEncoder::Integer.new
+			end
+		end.new
+		tm['T_FIXNUM'] = proc{|value| textenc_int }
+		tm['T_REGEXP'] = proc{|value| :invalid }
+		tm['T_ARRAY'] = :array_type_map_for
+		tm
+	end
+
+	it "should retrieve all conversions" do
+		expect( tm.coders ).to eq( {
+			"T_FIXNUM" => binaryenc_int,
+			"T_FLOAT" => textenc_float,
+			"T_SYMBOL" => pass_through_type,
+			"T_HASH" => nil,
+			"T_ARRAY" => nil,
+			"T_BIGNUM" => nil,
+			"T_CLASS" => nil,
+			"T_COMPLEX" => nil,
+			"T_DATA" => nil,
+			"T_FALSE" => nil,
+			"T_FILE" => nil,
+			"T_MODULE" => nil,
+			"T_OBJECT" => nil,
+			"T_RATIONAL" => nil,
+			"T_REGEXP" => nil,
+			"T_STRING" => nil,
+			"T_STRUCT" => nil,
+			"T_TRUE" => nil,
+		} )
+	end
+
+	it "should retrieve particular conversions" do
+		expect( tm['T_FIXNUM'] ).to eq(binaryenc_int)
+		expect( tm['T_FLOAT'] ).to eq(textenc_float)
+		expect( tm['T_BIGNUM'] ).to be_nil
+		expect( derived_tm['T_REGEXP'] ).to be_kind_of(Proc)
+		expect( derived_tm['T_ARRAY'] ).to eq(:array_type_map_for)
+	end
+
+	it "should allow deletion of coders" do
+		tm['T_FIXNUM'] = nil
+		expect( tm['T_FIXNUM'] ).to be_nil
+	end
+
+	it "should check MRI type key" do
+		expect{ tm['NO_TYPE'] }.to raise_error(ArgumentError)
+		expect{ tm[123] }.to raise_error(TypeError)
+		expect{ tm['NO_TYPE'] = textenc_float }.to raise_error(ArgumentError)
+		expect{ tm[123] = textenc_float }.to raise_error(TypeError)
+	end
+
+	#
+	# Decoding Examples
+	#
+
+	it "should raise an error when used for results" do
+		res = @conn.exec_params( "SELECT 1", [], 1 )
+		expect{ res.type_map = tm }.to raise_error(NotImplementedError, /not suitable to map result values/)
+	end
+
+	#
+	# Encoding Examples
+	#
+
+	it "should allow mixed type conversions" do
+		res = @conn.exec_params( "SELECT $1, $2, $3", [5, 1.23, :TestSymbol], 0, tm )
+		expect( res.values ).to eq([['5', '1.23', '[:TestSymbol]']])
+		expect( res.ftype(0) ).to eq(20)
+	end
+
+	it "should allow mixed type conversions with derived type map" do
+		res = @conn.exec_params( "SELECT $1, $2", [6, [7]], 0, derived_tm )
+		expect( res.values ).to eq([['6', '{7}']])
+		expect( res.ftype(0) ).to eq(23)
+		expect( res.ftype(1) ).to eq(1007)
+	end
+
+	it "should raise TypeError with derived type map" do
+		expect{
+			@conn.exec_params( "SELECT $1", [//], 0, derived_tm )
+		}.to raise_error(TypeError, /argument 1/)
+	end
+
+end

data/spec/pg/type_map_by_oid_spec.rb

@@ -0,0 +1,133 @@
+#!/usr/bin/env rspec
+# encoding: utf-8
+
+require_relative '../helpers'
+
+require 'pg'
+
+
+describe PG::TypeMapByOid do
+
+	let!(:textdec_int){ PG::TextDecoder::Integer.new name: 'INT4', oid: 23 }
+	let!(:textdec_float){ PG::TextDecoder::Float.new name: 'FLOAT8', oid: 701 }
+	let!(:textdec_string){ PG::TextDecoder::String.new name: 'TEXT', oid: 25 }
+	let!(:textdec_bytea){ PG::TextDecoder::Bytea.new name: 'BYTEA', oid: 17 }
+	let!(:binarydec_float){ PG::BinaryDecoder::Float.new name: 'FLOAT8', oid: 701, format: 1 }
+	let!(:pass_through_type) do
+		type = Class.new(PG::SimpleDecoder) do
+			def decode(*v)
+				v
+			end
+		end.new
+		type.oid = 1082
+		type.format = 0
+		type.name = 'pass_through'
+		type
+	end
+
+	let!(:tm) do
+		tm = PG::TypeMapByOid.new
+		tm.add_coder textdec_int
+		tm.add_coder textdec_float
+		tm.add_coder binarydec_float
+		tm.add_coder pass_through_type
+		tm
+	end
+
+	it "should retrieve it's conversions" do
+		expect( tm.coders ).to eq( [
+			textdec_int,
+			textdec_float,
+			pass_through_type,
+			binarydec_float,
+		] )
+	end
+
+	it "should allow deletion of coders" do
+		expect( tm.rm_coder 0, 701 ).to eq(textdec_float)
+		expect( tm.rm_coder 0, 701 ).to eq(nil)
+		expect( tm.rm_coder 1, 701 ).to eq(binarydec_float)
+		expect( tm.coders ).to eq( [
+			textdec_int,
+			pass_through_type,
+		] )
+	end
+
+	it "should check format when deleting coders" do
+		expect{ tm.rm_coder 2, 123 }.to raise_error(ArgumentError)
+		expect{ tm.rm_coder -1, 123 }.to raise_error(ArgumentError)
+	end
+
+	it "should check format when adding coders" do
+		textdec_int.format = 2
+		expect{ tm.add_coder textdec_int }.to raise_error(ArgumentError)
+		textdec_int.format = -1
+		expect{ tm.add_coder textdec_int }.to raise_error(ArgumentError)
+	end
+
+	it "should check coder type when adding coders" do
+		expect{ tm.add_coder :dummy }.to raise_error(ArgumentError)
+	end
+
+	it "should allow reading and writing max_rows_for_online_lookup" do
+		expect( tm.max_rows_for_online_lookup ).to eq(10)
+		tm.max_rows_for_online_lookup = 5
+		expect( tm.max_rows_for_online_lookup ).to eq(5)
+	end
+
+	it "should allow building new TypeMapByColumn for a given result" do
+		res = @conn.exec( "SELECT 1, 'a', 2.0::FLOAT, '2013-06-30'::DATE" )
+		tm2 = tm.fit_to_result(res, true)
+		expect( tm2 ).to eq( tm )
+
+		tm2 = tm.fit_to_result(res, false)
+		expect( tm2 ).to be_a_kind_of(PG::TypeMapByColumn)
+		expect( tm2.coders ).to eq( [textdec_int, nil, textdec_float, pass_through_type] )
+	end
+
+	#
+	# Decoding Examples text format
+	#
+
+	it "should allow mixed type conversions in text format" do
+		res = @conn.exec( "SELECT 1, 'a', 2.0::FLOAT, '2013-06-30'::DATE" )
+		res.type_map = tm
+		expect( res.values ).to eq( [[1, 'a', 2.0, ['2013-06-30', 0, 3] ]] )
+	end
+
+	it "should build a TypeMapByColumn when assigned and the number of rows is high enough" do
+		res = @conn.exec( "SELECT generate_series(1,20), 'a', 2.0::FLOAT, '2013-06-30'::DATE" )
+		expect( tm.fit_to_result(res) ).to be_a_kind_of(PG::TypeMapByColumn)
+		res.type_map = tm
+		expect( res.type_map ).to be_kind_of( PG::TypeMapByColumn )
+		expect( res.type_map.coders ).to eq( [textdec_int, nil, textdec_float, pass_through_type] )
+	end
+
+	it "should use TypeMapByOid for online lookup and the number of rows is low enough" do
+		res = @conn.exec( "SELECT 1, 'a', 2.0::FLOAT, '2013-06-30'::DATE" )
+		expect( tm.fit_to_result(res) ).to eq( tm )
+		res.type_map = tm
+		expect( res.type_map ).to be_kind_of( PG::TypeMapByOid )
+	end
+
+	#
+	# Decoding Examples binary format
+	#
+
+	it "should allow mixed type conversions in binary format" do
+		res = @conn.exec_params( "SELECT 1, 2.0::FLOAT", [], 1 )
+		res.type_map = tm
+		expect( res.values ).to eq( [["\x00\x00\x00\x01", 2.0 ]] )
+	end
+
+	#
+	# Encoding Examples
+	#
+
+	it "should raise an error used for query params" do
+		expect{
+			@conn.exec_params( "SELECT $1", [5], 0, tm )
+		}.to raise_error(NotImplementedError, /not suitable to map query params/)
+	end
+
+end

data/spec/pg/type_map_spec.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/env rspec
+# encoding: utf-8
+
+require_relative '../helpers'
+
+require 'pg'
+
+
+describe PG::TypeMap do
+	let!(:tm){ PG::TypeMap.new }
+
+	it "should respond to fit_to_query" do
+		expect{ tm.fit_to_query( [123] ) }.to raise_error(NotImplementedError, /not suitable to map query params/)
+	end
+
+	it "should respond to fit_to_result" do
+		res = @conn.exec( "SELECT 1" )
+		expect{ tm.fit_to_result( res ) }.to raise_error(NotImplementedError, /not suitable to map result values/)
+	end
+
+	it "should check params type" do
+		expect{ tm.fit_to_query( :invalid ) }.to raise_error(TypeError, /expected Array/)
+	end
+
+	it "should check result class" do
+		expect{ tm.fit_to_result( :invalid ) }.to raise_error(TypeError, /expected kind of PG::Result/)
+	end
+
+	it "should raise an error when used for param type casts" do
+		expect{
+			@conn.exec_params( "SELECT $1", [5], 0, tm )
+		}.to raise_error(NotImplementedError, /not suitable to map query params/)
+	end
+
+	it "should raise an error when used for result type casts" do
+		res = @conn.exec( "SELECT 1" )
+		expect{ res.map_types!(tm) }.to raise_error(NotImplementedError, /not suitable to map result values/)
+	end
+end

data/spec/pg/type_spec.rb

@@ -0,0 +1,620 @@
+#!/usr/bin/env rspec
+# encoding: utf-8
+
+require 'pg'
+
+
+describe "PG::Type derivations" do
+	let!(:textenc_int) { PG::TextEncoder::Integer.new name: 'Integer', oid: 23 }
+	let!(:textdec_int) { PG::TextDecoder::Integer.new name: 'Integer', oid: 23 }
+	let!(:textenc_float) { PG::TextEncoder::Float.new }
+	let!(:textdec_float) { PG::TextDecoder::Float.new }
+	let!(:textenc_string) { PG::TextEncoder::String.new }
+	let!(:textdec_string) { PG::TextDecoder::String.new }
+	let!(:textenc_timestamp) { PG::TextEncoder::TimestampWithoutTimeZone.new }
+	let!(:textdec_timestamp) { PG::TextDecoder::TimestampWithoutTimeZone.new }
+	let!(:textdec_bytea) { PG::TextDecoder::Bytea.new }
+	let!(:binaryenc_int2) { PG::BinaryEncoder::Int2.new }
+	let!(:binaryenc_int4) { PG::BinaryEncoder::Int4.new }
+	let!(:binaryenc_int8) { PG::BinaryEncoder::Int8.new }
+	let!(:binarydec_integer) { PG::BinaryDecoder::Integer.new }
+
+	let!(:intenc_incrementer) do
+		Class.new(PG::SimpleEncoder) do
+			def encode(value)
+				(value.to_i + 1).to_s + " "
+			end
+		end.new
+	end
+	let!(:intdec_incrementer) do
+		Class.new(PG::SimpleDecoder) do
+			def decode(string, tuple=nil, field=nil)
+				string.to_i+1
+			end
+		end.new
+	end
+
+	let!(:intenc_incrementer_with_int_result) do
+		Class.new(PG::SimpleEncoder) do
+			def encode(value)
+				value.to_i+1
+			end
+		end.new
+	end
+
+	it "shouldn't be possible to build a PG::Type directly" do
+		expect{ PG::Coder.new }.to raise_error(TypeError, /cannot/)
+	end
+
+	describe PG::SimpleCoder do
+		describe '#decode' do
+			it "should offer decode method with tuple/field" do
+				res = textdec_int.decode("123", 1, 1)
+				expect( res ).to eq( 123 )
+			end
+
+			it "should offer decode method without tuple/field" do
+				res = textdec_int.decode("234")
+				expect( res ).to eq( 234 )
+			end
+
+			it "should decode with ruby decoder" do
+				expect( intdec_incrementer.decode("3") ).to eq( 4 )
+			end
+
+			it "should decode integers of different lengths form text format" do
+				30.times do |zeros|
+					expect( textdec_int.decode("1" + "0"*zeros) ).to eq( 10 ** zeros )
+					expect( textdec_int.decode(zeros==0 ? "0" : "9"*zeros) ).to eq( 10 ** zeros - 1 )
+					expect( textdec_int.decode("-1" + "0"*zeros) ).to eq( -10 ** zeros )
+					expect( textdec_int.decode(zeros==0 ? "0" : "-" + "9"*zeros) ).to eq( -10 ** zeros + 1 )
+				end
+				66.times do |bits|
+					expect( textdec_int.decode((2 ** bits).to_s) ).to eq( 2 ** bits )
+					expect( textdec_int.decode((2 ** bits - 1).to_s) ).to eq( 2 ** bits - 1 )
+					expect( textdec_int.decode((-2 ** bits).to_s) ).to eq( -2 ** bits )
+					expect( textdec_int.decode((-2 ** bits + 1).to_s) ).to eq( -2 ** bits + 1 )
+				end
+			end
+
+			it 'decodes bytea to a binary string' do
+				expect( textdec_bytea.decode("\\x00010203EF") ).to eq( "\x00\x01\x02\x03\xef".b )
+				expect( textdec_bytea.decode("\\377\\000") ).to eq( "\xff\0".b )
+			end
+
+			it "should raise when decode method is called with wrong args" do
+				expect{ textdec_int.decode() }.to raise_error(ArgumentError)
+				expect{ textdec_int.decode("123", 2, 3, 4) }.to raise_error(ArgumentError)
+				expect{ textdec_int.decode(2, 3, 4) }.to raise_error(TypeError)
+				expect( intdec_incrementer.decode(2, 3, 4) ).to eq( 3 )
+			end
+		end
+
+		describe '#encode' do
+			it "should offer encode method for text type" do
+				res = textenc_int.encode(123)
+				expect( res ).to eq( "123" )
+			end
+
+			it "should offer encode method for binary type" do
+				res = binaryenc_int8.encode(123)
+				expect( res ).to eq( [123].pack("q>") )
+			end
+
+			it "should encode integers from string to binary format" do
+				expect( binaryenc_int2.encode("  -123  ") ).to eq( [-123].pack("s>") )
+				expect( binaryenc_int4.encode("  -123  ") ).to eq( [-123].pack("l>") )
+				expect( binaryenc_int8.encode("  -123  ") ).to eq( [-123].pack("q>") )
+				expect( binaryenc_int2.encode("  123-xyz  ") ).to eq( [123].pack("s>") )
+				expect( binaryenc_int4.encode("  123-xyz  ") ).to eq( [123].pack("l>") )
+				expect( binaryenc_int8.encode("  123-xyz  ") ).to eq( [123].pack("q>") )
+			end
+
+			it "should encode integers of different lengths to text format" do
+				30.times do |zeros|
+					expect( textenc_int.encode(10 ** zeros) ).to eq( "1" + "0"*zeros )
+					expect( textenc_int.encode(10 ** zeros - 1) ).to eq( zeros==0 ? "0" : "9"*zeros )
+					expect( textenc_int.encode(-10 ** zeros) ).to eq( "-1" + "0"*zeros )
+					expect( textenc_int.encode(-10 ** zeros + 1) ).to eq( zeros==0 ? "0" : "-" + "9"*zeros )
+				end
+				66.times do |bits|
+					expect( textenc_int.encode(2 ** bits) ).to eq( (2 ** bits).to_s )
+					expect( textenc_int.encode(2 ** bits - 1) ).to eq( (2 ** bits - 1).to_s )
+					expect( textenc_int.encode(-2 ** bits) ).to eq( (-2 ** bits).to_s )
+					expect( textenc_int.encode(-2 ** bits + 1) ).to eq( (-2 ** bits + 1).to_s )
+				end
+			end
+
+			it "should encode integers from string to text format" do
+				expect( textenc_int.encode("  -123  ") ).to eq( "-123" )
+				expect( textenc_int.encode("  123-xyz  ") ).to eq( "123" )
+			end
+
+			it "should encode special floats equally to Float#to_s" do
+				expect( textenc_float.encode(Float::INFINITY) ).to eq( Float::INFINITY.to_s )
+				expect( textenc_float.encode(-Float::INFINITY) ).to eq( (-Float::INFINITY).to_s )
+				expect( textenc_float.encode(-Float::NAN) ).to eq( Float::NAN.to_s )
+			end
+
+			it "should encode with ruby encoder" do
+				expect( intenc_incrementer.encode(3) ).to eq( "4 " )
+			end
+
+			it "should return when ruby encoder returns non string values" do
+				expect( intenc_incrementer_with_int_result.encode(3) ).to eq( 4 )
+			end
+		end
+
+		it "should be possible to marshal encoders" do
+			mt = Marshal.dump(textenc_int)
+			lt = Marshal.load(mt)
+			expect( lt.to_h ).to eq( textenc_int.to_h )
+		end
+
+		it "should be possible to marshal decoders" do
+			mt = Marshal.dump(textdec_int)
+			lt = Marshal.load(mt)
+			expect( lt.to_h ).to eq( textdec_int.to_h )
+		end
+
+		it "should respond to to_h" do
+			expect( textenc_int.to_h ).to eq( {
+				name: 'Integer', oid: 23, format: 0
+			} )
+		end
+
+		it "should have reasonable default values" do
+			t = PG::TextEncoder::String.new
+			expect( t.format ).to eq( 0 )
+			expect( t.oid ).to eq( 0 )
+			expect( t.name ).to be_nil
+		end
+	end
+
+	describe PG::CompositeCoder do
+		describe "Array types" do
+			let!(:textenc_string_array) { PG::TextEncoder::Array.new elements_type: textenc_string }
+			let!(:textdec_string_array) { PG::TextDecoder::Array.new elements_type: textdec_string }
+			let!(:textenc_int_array) { PG::TextEncoder::Array.new elements_type: textenc_int, needs_quotation: false }
+			let!(:textdec_int_array) { PG::TextDecoder::Array.new elements_type: textdec_int, needs_quotation: false }
+			let!(:textenc_float_array) { PG::TextEncoder::Array.new elements_type: textenc_float, needs_quotation: false }
+			let!(:textdec_float_array) { PG::TextDecoder::Array.new elements_type: textdec_float, needs_quotation: false }
+			let!(:textenc_timestamp_array) { PG::TextEncoder::Array.new elements_type: textenc_timestamp, needs_quotation: false }
+			let!(:textdec_timestamp_array) { PG::TextDecoder::Array.new elements_type: textdec_timestamp, needs_quotation: false }
+			let!(:textenc_string_array_with_delimiter) { PG::TextEncoder::Array.new elements_type: textenc_string, delimiter: ';' }
+			let!(:textdec_string_array_with_delimiter) { PG::TextDecoder::Array.new elements_type: textdec_string, delimiter: ';' }
+			let!(:textdec_bytea_array) { PG::TextDecoder::Array.new elements_type: textdec_bytea }
+
+			#
+			# Array parser specs are thankfully borrowed from here:
+			# https://github.com/dockyard/pg_array_parser
+			#
+			describe '#decode' do
+				context 'one dimensional arrays' do
+					context 'empty' do
+						it 'returns an empty array' do
+							expect( textdec_string_array.decode(%[{}]) ).to eq( [] )
+						end
+					end
+
+					context 'no strings' do
+						it 'returns an array of strings' do
+							expect( textdec_string_array.decode(%[{1,2,3}]) ).to eq( ['1','2','3'] )
+						end
+					end
+
+					context 'NULL values' do
+						it 'returns an array of strings, with nils replacing NULL characters' do
+							expect( textdec_string_array.decode(%[{1,NULL,NULL}]) ).to eq( ['1',nil,nil] )
+						end
+					end
+
+					context 'quoted NULL' do
+						it 'returns an array with the word NULL' do
+							expect( textdec_string_array.decode(%[{1,"NULL",3}]) ).to eq( ['1','NULL','3'] )
+						end
+					end
+
+					context 'strings' do
+						it 'returns an array of strings when containing commas in a quoted string' do
+							expect( textdec_string_array.decode(%[{1,"2,3",4}]) ).to eq( ['1','2,3','4'] )
+						end
+
+						it 'returns an array of strings when containing an escaped quote' do
+							expect( textdec_string_array.decode(%[{1,"2\\",3",4}]) ).to eq( ['1','2",3','4'] )
+						end
+
+						it 'returns an array of strings when containing an escaped backslash' do
+							expect( textdec_string_array.decode(%[{1,"2\\\\",3,4}]) ).to eq( ['1','2\\','3','4'] )
+							expect( textdec_string_array.decode(%[{1,"2\\\\\\",3",4}]) ).to eq( ['1','2\\",3','4'] )
+						end
+
+						it 'returns an array containing empty strings' do
+							expect( textdec_string_array.decode(%[{1,"",3,""}]) ).to eq( ['1', '', '3', ''] )
+						end
+
+						it 'returns an array containing unicode strings' do
+							expect( textdec_string_array.decode(%[{"Paragraph 399(b)(i) – “valid leave” – meaning"}]) ).to eq(['Paragraph 399(b)(i) – “valid leave” – meaning'])
+						end
+
+						it 'respects a different delimiter' do
+							expect( textdec_string_array_with_delimiter.decode(%[{1;2;3}]) ).to eq( ['1','2','3'] )
+						end
+					end
+
+					context 'bytea' do
+						it 'returns an array of binary strings' do
+							expect( textdec_bytea_array.decode(%[{"\\\\x00010203EF","2,3",\\377}]) ).to eq( ["\x00\x01\x02\x03\xef".b,"2,3".b,"\xff".b] )
+						end
+					end
+
+				end
+
+				context 'two dimensional arrays' do
+					context 'empty' do
+						it 'returns an empty array' do
+							expect( textdec_string_array.decode(%[{{}}]) ).to eq( [[]] )
+							expect( textdec_string_array.decode(%[{{},{}}]) ).to eq( [[],[]] )
+						end
+					end
+					context 'no strings' do
+						it 'returns an array of strings with a sub array' do
+							expect( textdec_string_array.decode(%[{1,{2,3},4}]) ).to eq( ['1',['2','3'],'4'] )
+						end
+					end
+					context 'strings' do
+						it 'returns an array of strings with a sub array' do
+							expect( textdec_string_array.decode(%[{1,{"2,3"},4}]) ).to eq( ['1',['2,3'],'4'] )
+						end
+						it 'returns an array of strings with a sub array and a quoted }' do
+							expect( textdec_string_array.decode(%[{1,{"2,}3",NULL},4}]) ).to eq( ['1',['2,}3',nil],'4'] )
+						end
+						it 'returns an array of strings with a sub array and a quoted {' do
+							expect( textdec_string_array.decode(%[{1,{"2,{3"},4}]) ).to eq( ['1',['2,{3'],'4'] )
+						end
+						it 'returns an array of strings with a sub array and a quoted { and escaped quote' do
+							expect( textdec_string_array.decode(%[{1,{"2\\",{3"},4}]) ).to eq( ['1',['2",{3'],'4'] )
+						end
+						it 'returns an array of strings with a sub array with empty strings' do
+							expect( textdec_string_array.decode(%[{1,{""},4,{""}}]) ).to eq( ['1',[''],'4',['']] )
+						end
+					end
+					context 'timestamps' do
+						it 'decodes an array of timestamps with sub arrays' do
+							expect( textdec_timestamp_array.decode('{2014-12-31 00:00:00,{NULL,2016-01-02 23:23:59.0000000}}') ).
+								to eq( [Time.new(2014,12,31),[nil, Time.new(2016,01,02, 23, 23, 59)]] )
+						end
+					end
+				end
+				context 'three dimensional arrays' do
+					context 'empty' do
+						it 'returns an empty array' do
+							expect( textdec_string_array.decode(%[{{{}}}]) ).to eq( [[[]]] )
+							expect( textdec_string_array.decode(%[{{{},{}},{{},{}}}]) ).to eq( [[[],[]],[[],[]]] )
+						end
+					end
+					it 'returns an array of strings with sub arrays' do
+						expect( textdec_string_array.decode(%[{1,{2,{3,4}},{NULL,6},7}]) ).to eq( ['1',['2',['3','4']],[nil,'6'],'7'] )
+					end
+				end
+
+				it 'should decode array of types with decoder in ruby space' do
+					array_type = PG::TextDecoder::Array.new elements_type: intdec_incrementer
+					expect( array_type.decode(%[{3,4}]) ).to eq( [4,5] )
+				end
+
+				it 'should decode array of nil types' do
+					array_type = PG::TextDecoder::Array.new elements_type: nil
+					expect( array_type.decode(%[{3,4}]) ).to eq( ['3','4'] )
+				end
+
+				context 'identifier quotation' do
+					it 'should build an array out of an quoted identifier string' do
+						quoted_type = PG::TextDecoder::Identifier.new elements_type: textdec_string
+						expect( quoted_type.decode(%["A.".".B"]) ).to eq( ["A.", ".B"] )
+						expect( quoted_type.decode(%["'A"".""B'"]) ).to eq( ['\'A"."B\''] )
+					end
+
+					it 'should split unquoted identifier string' do
+						quoted_type = PG::TextDecoder::Identifier.new elements_type: textdec_string
+						expect( quoted_type.decode(%[a.b]) ).to eq( ['a','b'] )
+						expect( quoted_type.decode(%[a]) ).to eq( ['a'] )
+					end
+				end
+			end
+
+			describe '#encode' do
+				context 'three dimensional arrays' do
+					it 'encodes an array of strings and numbers with sub arrays' do
+						expect( textenc_string_array.encode(['1',['2',['3','4']],[nil,6],7.8]) ).to eq( %[{1,{2,{3,4}},{NULL,6},7.8}] )
+					end
+					it 'encodes an array of strings with quotes' do
+						expect( textenc_string_array.encode(['',[' ',['{','}','\\',',','"','\t']]]) ).to eq( %[{"",{" ",{"{","}","\\\\",",","\\"","\\\\t"}}}] )
+					end
+					it 'encodes an array of int8 with sub arrays' do
+						expect( textenc_int_array.encode([1,[2,[3,4]],[nil,6],7]) ).to eq( %[{1,{2,{3,4}},{NULL,6},7}] )
+					end
+					it 'encodes an array of int8 with strings' do
+						expect( textenc_int_array.encode(['1',['2'],'3']) ).to eq( %[{1,{2},3}] )
+					end
+					it 'encodes an array of float8 with sub arrays' do
+						expect( textenc_float_array.encode([1000.11,[-0.00221,[3.31,-441]],[nil,6.61],-7.71]) ).to match(Regexp.new(%[^{1.0001*E+*03,{-2.2*E-*03,{3.3*E+*00,-4.4*E+*02}},{NULL,6.6*E+*00},-7.7*E+*00}$].gsub(/([\.\+\{\}\,])/, "\\\\\\1").gsub(/\*/, "\\d*")))
+					end
+				end
+				context 'two dimensional arrays' do
+					it 'encodes an array of timestamps with sub arrays' do
+						expect( textenc_timestamp_array.encode([Time.new(2014,12,31),[nil, Time.new(2016,01,02, 23, 23, 59.99)]]) ).
+								to eq( %[{2014-12-31 00:00:00.000000000,{NULL,2016-01-02 23:23:59.990000000}}] )
+					end
+				end
+				context 'one dimensional array' do
+					it 'can encode empty arrays' do
+						expect( textenc_int_array.encode([]) ).to eq( '{}' )
+						expect( textenc_string_array.encode([]) ).to eq( '{}' )
+					end
+					it 'encodes an array of NULL strings w/wo quotes' do
+						expect( textenc_string_array.encode(['NUL', 'NULL', 'NULLL', 'nul', 'null', 'nulll']) ).to eq( %[{NUL,"NULL",NULLL,nul,"null",nulll}] )
+					end
+					it 'respects a different delimiter' do
+						expect( textenc_string_array_with_delimiter.encode(['a','b,','c']) ).to eq( '{a;b,;c}' )
+					end
+				end
+
+				context 'array of types with encoder in ruby space' do
+					it 'encodes with quotation' do
+						array_type = PG::TextEncoder::Array.new elements_type: intenc_incrementer, needs_quotation: true
+						expect( array_type.encode([3,4]) ).to eq( %[{"4 ","5 "}] )
+					end
+
+					it 'encodes without quotation' do
+						array_type = PG::TextEncoder::Array.new elements_type: intenc_incrementer, needs_quotation: false
+						expect( array_type.encode([3,4]) ).to eq( %[{4 ,5 }] )
+					end
+
+					it "should raise when ruby encoder returns non string values" do
+						array_type = PG::TextEncoder::Array.new elements_type: intenc_incrementer_with_int_result, needs_quotation: false
+						expect{ array_type.encode([3,4]) }.to raise_error(TypeError)
+					end
+				end
+
+				context 'identifier quotation' do
+					it 'should quote and escape identifier' do
+						quoted_type = PG::TextEncoder::Identifier.new elements_type: textenc_string
+						expect( quoted_type.encode(['schema','table','col']) ).to eq( %["schema"."table"."col"] )
+						expect( quoted_type.encode(['A.','.B']) ).to eq( %["A.".".B"] )
+						expect( quoted_type.encode(%['A"."B']) ).to eq( %["'A"".""B'"] )
+					end
+
+					it 'shouldn\'t quote or escape identifier if requested to not do' do
+						quoted_type = PG::TextEncoder::Identifier.new elements_type: textenc_string,
+								needs_quotation: false
+						expect( quoted_type.encode(['a','b']) ).to eq( %[a.b] )
+						expect( quoted_type.encode(%[a.b]) ).to eq( %[a.b] )
+					end
+				end
+
+				context 'literal quotation' do
+					it 'should quote and escape literals' do
+						quoted_type = PG::TextEncoder::QuotedLiteral.new elements_type: textenc_string_array
+						expect( quoted_type.encode(["'A\",","\\B'"]) ).to eq( %['{"''A\\",","\\\\B''"}'] )
+					end
+				end
+			end
+
+			it "should be possible to marshal encoders" do
+				mt = Marshal.dump(textenc_int_array)
+				lt = Marshal.load(mt)
+				expect( lt.to_h ).to eq( textenc_int_array.to_h )
+			end
+
+			it "should be possible to marshal encoders" do
+				mt = Marshal.dump(textdec_int_array)
+				lt = Marshal.load(mt)
+				expect( lt.to_h ).to eq( textdec_int_array.to_h )
+			end
+
+			it "should respond to to_h" do
+				expect( textenc_int_array.to_h ).to eq( {
+					name: nil, oid: 0, format: 0,
+					elements_type: textenc_int, needs_quotation: false, delimiter: ','
+				} )
+			end
+
+			it "shouldn't accept invalid elements_types" do
+				expect{ PG::TextEncoder::Array.new elements_type: false }.to raise_error(TypeError)
+			end
+
+			it "should have reasonable default values" do
+				t = PG::TextEncoder::Array.new
+				expect( t.format ).to eq( 0 )
+				expect( t.oid ).to eq( 0 )
+				expect( t.name ).to be_nil
+				expect( t.needs_quotation? ).to eq( true )
+				expect( t.delimiter ).to eq( ',' )
+				expect( t.elements_type ).to be_nil
+			end
+		end
+
+		it "should encode Strings as base64 in TextEncoder" do
+			e = PG::TextEncoder::ToBase64.new
+			expect( e.encode("") ).to eq("")
+			expect( e.encode("x") ).to eq("eA==")
+			expect( e.encode("xx") ).to eq("eHg=")
+			expect( e.encode("xxx") ).to eq("eHh4")
+			expect( e.encode("xxxx") ).to eq("eHh4eA==")
+			expect( e.encode("xxxxx") ).to eq("eHh4eHg=")
+			expect( e.encode("\0\n\t") ).to eq("AAoJ")
+		end
+
+		it "should encode Strings as base64 in BinaryDecoder" do
+			e = PG::BinaryDecoder::ToBase64.new
+			expect( e.decode("x") ).to eq("eA==")
+		end
+
+		it "should encode Integers as base64" do
+			# Not really useful, but ensures that two-pass element and composite element encoders work.
+			e = PG::TextEncoder::ToBase64.new( elements_type: PG::TextEncoder::Array.new( elements_type: PG::TextEncoder::Integer.new, needs_quotation: false ))
+			expect( e.encode([1]) ).to eq(["{1}"].pack("m").chomp)
+			expect( e.encode([12]) ).to eq(["{12}"].pack("m").chomp)
+			expect( e.encode([123]) ).to eq(["{123}"].pack("m").chomp)
+			expect( e.encode([1234]) ).to eq(["{1234}"].pack("m").chomp)
+			expect( e.encode([12345]) ).to eq(["{12345}"].pack("m").chomp)
+			expect( e.encode([123456]) ).to eq(["{123456}"].pack("m").chomp)
+			expect( e.encode([1234567]) ).to eq(["{1234567}"].pack("m").chomp)
+		end
+
+		it "should decode base64 to Strings in TextDecoder" do
+			e = PG::TextDecoder::FromBase64.new
+			expect( e.decode("") ).to eq("")
+			expect( e.decode("eA==") ).to eq("x")
+			expect( e.decode("eHg=") ).to eq("xx")
+			expect( e.decode("eHh4") ).to eq("xxx")
+			expect( e.decode("eHh4eA==") ).to eq("xxxx")
+			expect( e.decode("eHh4eHg=") ).to eq("xxxxx")
+			expect( e.decode("AAoJ") ).to eq("\0\n\t")
+		end
+
+		it "should decode base64 in BinaryEncoder" do
+			e = PG::BinaryEncoder::FromBase64.new
+			expect( e.encode("eA==") ).to eq("x")
+
+			e = PG::BinaryEncoder::FromBase64.new( elements_type: PG::TextEncoder::Integer.new )
+			expect( e.encode(124) ).to eq("124=".unpack("m")[0])
+		end
+
+		it "should decode base64 to Integers" do
+			# Not really useful, but ensures that composite element encoders work.
+			e = PG::TextDecoder::FromBase64.new( elements_type: PG::TextDecoder::Array.new( elements_type: PG::TextDecoder::Integer.new ))
+			expect( e.decode(["{1}"].pack("m")) ).to eq([1])
+			expect( e.decode(["{12}"].pack("m")) ).to eq([12])
+			expect( e.decode(["{123}"].pack("m")) ).to eq([123])
+			expect( e.decode(["{1234}"].pack("m")) ).to eq([1234])
+			expect( e.decode(["{12345}"].pack("m")) ).to eq([12345])
+			expect( e.decode(["{123456}"].pack("m")) ).to eq([123456])
+			expect( e.decode(["{1234567}"].pack("m")) ).to eq([1234567])
+			expect( e.decode(["{12345678}"].pack("m")) ).to eq([12345678])
+
+			e = PG::TextDecoder::FromBase64.new( elements_type: PG::BinaryDecoder::Integer.new )
+			expect( e.decode("ALxhTg==") ).to eq(12345678)
+		end
+
+		it "should decode base64 with garbage" do
+			e = PG::TextDecoder::FromBase64.new format: 1
+			expect( e.decode("=") ).to eq("=".unpack("m")[0])
+			expect( e.decode("==") ).to eq("==".unpack("m")[0])
+			expect( e.decode("===") ).to eq("===".unpack("m")[0])
+			expect( e.decode("====") ).to eq("====".unpack("m")[0])
+			expect( e.decode("a=") ).to eq("a=".unpack("m")[0])
+			expect( e.decode("a==") ).to eq("a==".unpack("m")[0])
+			expect( e.decode("a===") ).to eq("a===".unpack("m")[0])
+			expect( e.decode("a====") ).to eq("a====".unpack("m")[0])
+			expect( e.decode("aa=") ).to eq("aa=".unpack("m")[0])
+			expect( e.decode("aa==") ).to eq("aa==".unpack("m")[0])
+			expect( e.decode("aa===") ).to eq("aa===".unpack("m")[0])
+			expect( e.decode("aa====") ).to eq("aa====".unpack("m")[0])
+			expect( e.decode("aaa=") ).to eq("aaa=".unpack("m")[0])
+			expect( e.decode("aaa==") ).to eq("aaa==".unpack("m")[0])
+			expect( e.decode("aaa===") ).to eq("aaa===".unpack("m")[0])
+			expect( e.decode("aaa====") ).to eq("aaa====".unpack("m")[0])
+			expect( e.decode("=aa") ).to eq("=aa=".unpack("m")[0])
+			expect( e.decode("=aa=") ).to eq("=aa=".unpack("m")[0])
+			expect( e.decode("=aa==") ).to eq("=aa==".unpack("m")[0])
+			expect( e.decode("=aa===") ).to eq("=aa===".unpack("m")[0])
+		end
+	end
+
+	describe PG::CopyCoder do
+		describe PG::TextEncoder::CopyRow do
+			context "with default typemap" do
+				let!(:encoder) do
+					PG::TextEncoder::CopyRow.new
+				end
+
+				it "should encode different types of Ruby objects" do
+					expect( encoder.encode([:xyz, 123, 2456, 34567, 456789, 5678901, [1,2,3], 12.1, "abcdefg", nil]) ).
+						to eq("xyz\t123\t2456\t34567\t456789\t5678901\t[1, 2, 3]\t12.1\tabcdefg\t\\N\n")
+				end
+			end
+
+			context "with TypeMapByMriType" do
+				let!(:tm) do
+					tm = PG::TypeMapByMriType.new
+					tm['T_FIXNUM'] = textenc_int
+					tm['T_FLOAT'] = intenc_incrementer
+					tm['T_ARRAY'] = PG::TextEncoder::Array.new elements_type: textenc_string
+					tm
+				end
+				let!(:encoder) do
+					PG::TextEncoder::CopyRow.new type_map: tm
+				end
+
+				it "should have reasonable default values" do
+					expect( encoder.name ).to be_nil
+					expect( encoder.delimiter ).to eq( "\t" )
+					expect( encoder.null_string ).to eq( "\\N" )
+				end
+
+				it "copies all attributes with #dup" do
+					encoder.name = "test"
+					encoder.delimiter = "#"
+					encoder.null_string = "NULL"
+					encoder.type_map = PG::TypeMapByColumn.new []
+					encoder2 = encoder.dup
+					expect( encoder.object_id ).to_not eq( encoder2.object_id )
+					expect( encoder2.name ).to eq( "test" )
+					expect( encoder2.delimiter ).to eq( "#" )
+					expect( encoder2.null_string ).to eq( "NULL" )
+					expect( encoder2.type_map ).to be_a_kind_of( PG::TypeMapByColumn )
+				end
+
+				describe '#encode' do
+					it "should encode different types of Ruby objects" do
+						expect( encoder.encode([]) ).to eq("\n")
+						expect( encoder.encode(["a"]) ).to eq("a\n")
+						expect( encoder.encode([:xyz, 123, 2456, 34567, 456789, 5678901, [1,2,3], 12.1, "abcdefg", nil]) ).
+							to eq("xyz\t123\t2456\t34567\t456789\t5678901\t{1,2,3}\t13 \tabcdefg\t\\N\n")
+					end
+
+					it "should escape special characters" do
+						expect( encoder.encode([" \0\t\n\r\\"]) ).to eq(" \0#\t#\n#\r#\\\n".gsub("#", "\\"))
+					end
+
+					it "should escape with different delimiter" do
+						encoder.delimiter = " "
+						encoder.null_string = "NULL"
+						expect( encoder.encode([nil, " ", "\0", "\t", "\n", "\r", "\\"]) ).to eq("NULL #  \0 \t #\n #\r #\\\n".gsub("#", "\\"))
+					end
+				end
+			end
+		end
+
+		describe PG::TextDecoder::CopyRow do
+			context "with default typemap" do
+				let!(:decoder) do
+					PG::TextDecoder::CopyRow.new
+				end
+
+				describe '#decode' do
+					it "should decode different types of Ruby objects" do
+						expect( decoder.decode("123\t \0#\t#\n#\r#\\ \t234\t#\x01#\002\n".gsub("#", "\\"))).to eq( ["123", " \0\t\n\r\\ ", "234", "\x01\x02"] )
+					end
+				end
+			end
+
+			context "with TypeMapByColumn" do
+				let!(:tm) do
+					PG::TypeMapByColumn.new [textdec_int, textdec_string, intdec_incrementer, nil]
+				end
+				let!(:decoder) do
+					PG::TextDecoder::CopyRow.new type_map: tm
+				end
+
+				describe '#decode' do
+					it "should decode different types of Ruby objects" do
+						expect( decoder.decode("123\t \0#\t#\n#\r#\\ \t234\t#\x01#\002\n".gsub("#", "\\"))).to eq( [123, " \0\t\n\r\\ ", 235, "\x01\x02"] )
+					end
+				end
+			end
+		end
+	end
+end