pg 1.6.1 → 1.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c220f1cc5cfd8e07690949fcf30a96abd8f710bc64f0c358eb6452288966a5b4
-  data.tar.gz: cd5f28d3098e2537e04dc218c8809b83308cb541e6b17891220559d33e2ada82
+  metadata.gz: b98dcd23695bd37aca4e9769e5b55a26ab53b7de01e4b44ff22d1849df08088a
+  data.tar.gz: d9610b8ca74c772db98aff8ff661fa29ea44d8917e0ef48f1e89f9cdfd3158b3
 SHA512:
-  metadata.gz: f5de3fb30c6da95937d6c8913c9e172a348fa376edc6f06cc9333669c908a25cb2af85853aafbdc6839407f6b4aea93ca97e3b5b53f7182732664ecd6cd81e33
-  data.tar.gz: 00f5c6e8c359e81bf7c9145b7322583e511d440f681d32192430d9ce96772f1d71f8abce35e12ccf126d96a552205e799efee2533c54a84c623fa0aeee5c1c3c
+  metadata.gz: 531c1c61fdb41ea77a8e8e657a536f5734fecc117f7b3a93c04707b7f16a034a841859944e097e75db12ea630ff2679ed90054e0132b96f23ee92c5807d8c07f
+  data.tar.gz: 7d7d8d8c0ff76687d63912d41cf4dea890eb63bf361378b9da075ad1f8ccda9b34353e0de0f462bff5cae2740ee17988c3aef417c92d9b38d3a1b635e6ed19f5

data/CHANGELOG.md

@@ -1,3 +1,29 @@
+## v1.6.3 [2025-12-29] Lars Kanis <lars@greiz-reinsdorf.de>
+
+Added:
+- Add binary gems for ruby-4.0, now providing ruby-3.0 to 4.0. #682
+- Improve documentation of PG::Result and README. #676
+- Update errorcodes to PostgreSQL-18.
+- Use `rb_hash_new_capa` on Ruby-3.2+ . #674
+- Deny any server communication on a frozen PG::Connection . #677
+- Fix possible race condition in PG::Result in Ractor context. #674
+
+Removed:
+- Drop binary gem support for platform `x86-mingw32`. #682
+- Drop binary gems for ruby-2.7.
+
+
+## v1.6.2 [2025-09-02] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Remove several absolute paths from native binaries which pointed to build directories. [#668](https://github.com/ged/ruby-pg/pull/668)
+- Fix bad fallback path to `pg_service.conf`. [#666](https://github.com/ged/ruby-pg/pull/666)
+- Use `rbpg_` prefix for `base64_*` functions to avoid name clashes with functions provided by other libraries like Heimdal on Macos. [#667](https://github.com/ged/ruby-pg/pull/667)
+- Raise a more descriptive error message in case of `pg_ext` LoadError. [#664](https://github.com/ged/ruby-pg/pull/664)
+- Freeze some constants to make them available in a Ractor context. [#660](https://github.com/ged/ruby-pg/pull/660)
+- Several documentation improvements.
+- Update native binary gems to OpenSSL-3.5.2, krb5-1.22.1 and PostgreSQL-17.6.
+
+
 ## v1.6.1 [2025-08-03] Lars Kanis <lars@greiz-reinsdorf.de>
 
 - Add binary gems for platforms `aarch64-linux-musl` and `x86_64-linux-musl` without the need to install package `gcompat`. [#657](https://github.com/ged/ruby-pg/pull/657).

data/Gemfile

@@ -1,7 +1,7 @@
 # -*- ruby -*-
 
-# Specify your gem's runtime dependencies in pg.gemspec
-gemspec
+# No pg gem, since "bundle package" fails on bundler-2.7+, if the extension isn't built
+# gemspec
 
 source "https://rubygems.org/"
 
@@ -11,9 +11,9 @@ group :development do
 end
 
 group :test do
-  gem "bundler", ">= 1.16", "< 3.0"
+  gem "bundler", ">= 1.16", "< 5.0"
   gem "rake-compiler", "~> 1.0"
-  gem "rake-compiler-dock", "~> 1.9.1"
+  gem "rake-compiler-dock", "~> 1.11.0" #, git: "https://github.com/rake-compiler/rake-compiler-dock"
   gem "rspec", "~> 3.5"
   # "bigdecimal" is a gem on ruby-3.4+ and it's optional for ruby-pg.
   # Specs should succeed without it, but 4 examples are then excluded.

data/README.md

@@ -1,7 +1,7 @@
 # pg
 
 * home :: https://github.com/ged/ruby-pg
-* docs :: http://deveiate.org/code/pg (English) ,
+* docs :: http://deveiate.org/code/pg/README_md.html (English) ,
           https://deveiate.org/code/pg/README_ja_md.html (Japanese)
 * clog :: link:/CHANGELOG.md
 
@@ -30,6 +30,9 @@ A small example usage:
   end
 ```
 
+See the PG::Connection class for query methods and the PG::Result class for information on working with the results of a query.
+
+
 ## Build Status
 
 [![Build Status Github Actions](https://github.com/ged/ruby-pg/actions/workflows/source-gem.yml/badge.svg?branch=master)](https://github.com/ged/ruby-pg/actions/workflows/source-gem.yml)
@@ -57,9 +60,7 @@ This installs the binary gem, specific to the running platform by default.
 The binary gems don't depend on the libpq package on the running system.
 They have libpq builtin.
 
-The gems for platform `x86_64-linux` and `aarch64-linux` run on Alpine Linux, but require the package `gcompat` there as long as we don't provide a native gem for platform `x86_64-linux-musl`. Install this package like so:
-
-    apk add gcompat
+The gems for platform `x86_64-linux` and `aarch64-linux` run on Alpine Linux, but require the package `gcompat`, while the native gems for platform `*-linux-musl` work without that dependency.
 
 There is one use case the binary gems don't support: Retrieval of connection [options from LDAP](https://www.postgresql.org/docs/current/libpq-ldap.html). To support this `libldap` would be necessary, but it has a lot of dependencies. It doesn't seem to be a widely used feature and that it's worth to support it. If it's necessary, the source gem can be forced.
 
@@ -67,6 +68,7 @@ There is one use case the binary gems don't support: Retrieval of connection [op
 
 The source gem can be forced by:
 
+    gem uninstall pg --all
     gem install pg --platform ruby
 
 You may need to specify the path to the 'pg_config' program installed with
@@ -148,7 +150,7 @@ Very basic type casting can be enabled by:
 But Pg's type casting is highly customizable. That's why it's divided into
 2 layers:
 
-### Encoders / Decoders (ext/pg_*coder.c, lib/pg/*coder.rb)
+### Encoders / Decoders (ext/pg_\*coder.c, lib/pg/\*coder.rb)
 
 This is the lower layer, containing encoding classes that convert Ruby
 objects for transmission to the DBMS and decoding classes to convert
@@ -190,9 +192,9 @@ The following text and binary formats can also be encoded although they are not
 * Literal for insertion into SQL string: [TE](rdoc-ref:PG::TextEncoder::QuotedLiteral)
 * SQL-Identifier: [TE](rdoc-ref:PG::TextEncoder::Identifier), [TD](rdoc-ref:PG::TextDecoder::Identifier)
 
-### PG::TypeMap and derivations (ext/pg_type_map*.c, lib/pg/type_map*.rb)
+### TypeMap and derivations (ext/pg_type_map\*.c, lib/pg/type_map\*.rb)
 
-A TypeMap defines which value will be converted by which encoder/decoder.
+A PG::TypeMap defines which value will be converted by which encoder/decoder.
 There are different type map strategies, implemented by several derivations
 of this class. They can be chosen and configured according to the particular
 needs for type casting. The default type map is PG::TypeMapAllStrings.
@@ -219,8 +221,8 @@ Several type maps can be chained by setting PG::TypeMap::DefaultTypeMappable#def
 
 ## Thread support
 
-PG is thread safe in such a way that different threads can use different PG::Connection objects concurrently.
-However it is not safe to access any Pg objects simultaneously from more than one thread.
+PG is thread safe in such a way that different threads or fibers can use different PG::Connection objects concurrently.
+However it is not safe to access any PG object simultaneously from more than one thread or fiber unless the object is frozen.
 So make sure to open a new database server connection for every new thread or use a wrapper library like ActiveRecord that manages connections in a thread safe way.
 
 If messages like the following are printed to stderr, you're probably using one connection from several threads:

data/Rakefile

@@ -47,7 +47,6 @@ CrossLibrary = Struct.new :platform, :openssl_config, :toolchain
 CrossLibraries = [
 	['aarch64-mingw-ucrt', 'mingwarm64', 'aarch64-w64-mingw32'],
 	['x64-mingw-ucrt', 'mingw64', 'x86_64-w64-mingw32'],
-	['x86-mingw32', 'mingw', 'i686-w64-mingw32'],
 	['x64-mingw32', 'mingw64', 'x86_64-w64-mingw32'],
 	['x86_64-linux', 'linux-x86_64', 'x86_64-linux-gnu'],
 	['x86_64-linux-musl', 'linux-x86_64', 'x86_64-unknown-linux-musl'],
@@ -74,7 +73,7 @@ Rake::ExtensionTask.new do |ext|
 	# Activate current cross compiled platform only.
 	# This is to work around the issue that `linux` platform is selected in `linux-musl` image.
 	ext.cross_platform = CrossLibraries.map(&:platform).select do |pl|
-		m = ENV["RCD_IMAGE"]&.match(/:(?<ruby_ver>[\d\.]+)-mri-(?<platform>[-\w]+)$/)
+		m = ENV["RCD_IMAGE"]&.match(/:(?<ruby_ver>[\w\.]+)-mri-(?<platform>[-\w]+)$/)
 		m && m[:platform] == pl
 	end
 
@@ -94,7 +93,7 @@ Rake::ExtensionTask.new do |ext|
 		spec.files << "ports/#{spec.platform.to_s}/lib/libpq-ruby-pg.1.dylib" if spec.platform.to_s =~ /darwin/
 		spec.files << "ports/#{spec.platform.to_s}/lib/libpq.dll" if spec.platform.to_s =~ /mingw|mswin/
 
-		# Binary gems don't postgresql header+lib files
+		# Binary gems don't need postgresql header+lib files
 		spec.metadata.delete("msys2_mingw_dependencies")
 	end
 end
@@ -106,6 +105,7 @@ task 'gem:native:prepare' do
 	# Copy gem signing key and certs to be accessible from the docker container
 	mkdir_p 'build/gem'
 	sh "cp ~/.gem/gem-*.pem build/gem/ || true"
+	sh "bundle config set cache_all false"
 	sh "bundle package"
 	begin
 		OpenSSL::PKey.read(File.read(File.expand_path("~/.gem/gem-private_key.pem")), ENV["GEM_PRIVATE_KEY_PASSPHRASE"] || "")
@@ -115,19 +115,6 @@ task 'gem:native:prepare' do
 	end
 end
 
-task 'install_darwin_mig', [:arch] do |t, args|
-	sh <<~EOT
-		rm -rf bootstrap_cmds &&
-		git clone --branch=cross_platform https://github.com/markmentovai/bootstrap_cmds &&
-		cd bootstrap_cmds &&
-		autoreconf --install &&
-		sh configure &&
-		make &&
-		sed -E -i 's/^cppflags=(.*)/cppflags=(\\1 "-D#{args[:arch]}" "-I\\/opt\\/osxcross\\/target\\/SDK\\/MacOSX11.1.sdk\\/usr\\/include")/' migcom.tproj/mig.sh &&
-		sudo make install
-	EOT
-end
-
 CrossLibraries.each do |xlib|
 	platform = xlib.platform
 	desc "Build fat binary gem for platform #{platform}"
@@ -139,9 +126,7 @@ CrossLibraries.each do |xlib|
 			sudo apt-get update && sudo apt-get install -y bison flex &&
 			(cp build/gem/gem-*.pem ~/.gem/ || true) &&
 			bundle install --local &&
-			#{ "rake install_darwin_mig[__arm64__]" if platform =~ /arm64-darwin/ }
-			#{ "rake install_darwin_mig[__x86_64__]" if platform =~ /x86_64-darwin/ }
-			rake native:#{platform} pkg/#{$gem_spec.full_name}-#{platform}.gem MAKEOPTS=-j`nproc` RUBY_CC_VERSION=#{RakeCompilerDock.ruby_cc_version("~>2.7", "~>3.0")}
+			rake native:#{platform} pkg/#{$gem_spec.full_name}-#{platform}.gem MAKEFLAGS="-j`nproc` V=1" RUBY_CC_VERSION=#{RakeCompilerDock.ruby_cc_version("~>4.0", "~>3.0")}
 		EOT
 	end
 	desc "Build the native binary gems"
@@ -172,7 +157,8 @@ end
 
 desc "Update list of server error codes"
 task :update_error_codes do
-	URL_ERRORCODES_TXT = "http://git.postgresql.org/gitweb/?p=postgresql.git;a=blob_plain;f=src/backend/utils/errcodes.txt;hb=refs/tags/REL_17_0"
+	# URL_ERRORCODES_TXT = "https://git.postgresql.org/gitweb/?p=postgresql.git;a=blob_plain;f=src/backend/utils/errcodes.txt;hb=refs/tags/REL_18_0"
+	URL_ERRORCODES_TXT = "https://raw.githubusercontent.com/postgres/postgres/refs/tags/REL_18_0/src/backend/utils/errcodes.txt"
 
 	ERRORCODES_TXT = "ext/errorcodes.txt"
 	sh "wget #{URL_ERRORCODES_TXT.inspect} -O #{ERRORCODES_TXT.inspect} || curl #{URL_ERRORCODES_TXT.inspect} -o #{ERRORCODES_TXT.inspect}"

data/ext/errorcodes.def

@@ -87,6 +87,11 @@
   VALUE klass = define_error_class( "StackedDiagnosticsAccessedWithoutActiveHandler", "0Z" );
   register_error_class( "0Z002", klass );
 }
+{
+  VALUE klass = define_error_class( "InvalidArgumentForXquery", NULL );
+  register_error_class( "10608", klass );
+  register_error_class( "10", klass );
+}
 {
   VALUE klass = define_error_class( "CaseNotFound", NULL );
   register_error_class( "20000", klass );
@@ -889,6 +894,10 @@
   VALUE klass = define_error_class( "DuplicateFile", "58" );
   register_error_class( "58P02", klass );
 }
+{
+  VALUE klass = define_error_class( "FileNameTooLong", "58" );
+  register_error_class( "58P03", klass );
+}
 {
   VALUE klass = define_error_class( "ConfigFileError", NULL );
   register_error_class( "F0000", klass );

data/ext/errorcodes.rb

@@ -28,7 +28,7 @@ EOCODE
 			sqlstate, ews, errcode_macro_name = $1, $2, $3
 			next unless ews=='E'
 
-			is_sqlclass = sqlstate[2..-1] == '000'
+			is_sqlclass = sqlstate[2..-1] == '000' || sqlstate == '10608'
 			class_code = sqlstate[0,2]
 			baseclass_code = is_sqlclass ? 'NULL' : class_code.inspect
 			class_name = camelize(errcode_macro_name.sub('ERRCODE_', '').downcase)

data/ext/errorcodes.txt

@@ -2,7 +2,7 @@
 # errcodes.txt
 #      PostgreSQL error codes
 #
-# Copyright (c) 2003-2024, PostgreSQL Global Development Group
+# Copyright (c) 2003-2025, PostgreSQL Global Development Group
 #
 # This list serves as the basis for generating source files containing error
 # codes. It is kept in a common format to make sure all these source files have
@@ -141,6 +141,12 @@ Section: Class 0Z - Diagnostics Exception
 0Z000    E    ERRCODE_DIAGNOSTICS_EXCEPTION                                  diagnostics_exception
 0Z002    E    ERRCODE_STACKED_DIAGNOSTICS_ACCESSED_WITHOUT_ACTIVE_HANDLER    stacked_diagnostics_accessed_without_active_handler
 
+Section: Class 10 - XQuery Error
+
+# recent SQL versions define quite a few codes in this class, but for now
+# we are only using this generic one
+10608    E    ERRCODE_INVALID_ARGUMENT_FOR_XQUERY                            invalid_argument_for_xquery
+
 Section: Class 20 - Case Not Found
 
 20000    E    ERRCODE_CASE_NOT_FOUND                                         case_not_found
@@ -439,6 +445,7 @@ Section: Class 58 - System Error (errors external to PostgreSQL itself)
 58030    E    ERRCODE_IO_ERROR                                               io_error
 58P01    E    ERRCODE_UNDEFINED_FILE                                         undefined_file
 58P02    E    ERRCODE_DUPLICATE_FILE                                         duplicate_file
+58P03    E    ERRCODE_FILE_NAME_TOO_LONG                                     file_name_too_long
 
 Section: Class F0 - Configuration File Error
 

data/ext/extconf.rb

@@ -27,13 +27,13 @@ if gem_platform=with_config("cross-build")
 	gem 'mini_portile2', '~>2.1'
 	require 'mini_portile2'
 
-	OPENSSL_VERSION = ENV['OPENSSL_VERSION'] || '3.5.1'
+	OPENSSL_VERSION = ENV['OPENSSL_VERSION'] || '3.6.0'
 	OPENSSL_SOURCE_URI = "http://www.openssl.org/source/openssl-#{OPENSSL_VERSION}.tar.gz"
 
-	KRB5_VERSION = ENV['KRB5_VERSION'] || '1.21.3'
+	KRB5_VERSION = ENV['KRB5_VERSION'] || '1.22.1'
 	KRB5_SOURCE_URI = "http://kerberos.org/dist/krb5/#{KRB5_VERSION[/^(\d+\.\d+)/]}/krb5-#{KRB5_VERSION}.tar.gz"
 
-	POSTGRESQL_VERSION = ENV['POSTGRESQL_VERSION'] || '17.5'
+	POSTGRESQL_VERSION = ENV['POSTGRESQL_VERSION'] || '18.1'
 	POSTGRESQL_SOURCE_URI = "http://ftp.postgresql.org/pub/source/v#{POSTGRESQL_VERSION}/postgresql-#{POSTGRESQL_VERSION}.tar.bz2"
 
 	class BuildRecipe < MiniPortile
@@ -49,6 +49,12 @@ if gem_platform=with_config("cross-build")
 			"#{target}/#{RUBY_PLATFORM}"
 		end
 
+		# Add "--prefix=/", to avoid our actual build install path compiled into the binary.
+		# Instead use DESTDIR variable of make to set our install path.
+		def configure_prefix
+			"--prefix="
+		end
+
 		def cook_and_activate
 			checkpoint = File.join(self.target, "#{self.name}-#{self.version}-#{RUBY_PLATFORM}.installed")
 			unless File.exist?(checkpoint)
@@ -70,13 +76,13 @@ if gem_platform=with_config("cross-build")
 				envs = []
 				envs << "CFLAGS=-DDSO_WIN32 -DOPENSSL_THREADS" if RUBY_PLATFORM =~ /mingw|mswin/
 				envs << "CFLAGS=-fPIC -DOPENSSL_THREADS" if RUBY_PLATFORM =~ /linux|darwin/
-				execute('configure', ['env', *envs, "./Configure", openssl_platform, "threads", "-static", "CROSS_COMPILE=#{host}-", configure_prefix], altlog: "config.log")
+				execute('configure', ['env', *envs, "./Configure", openssl_platform, "threads", "-static", "CROSS_COMPILE=#{host}-", "--prefix=/"], altlog: "config.log")
 			end
 			def compile
 				execute('compile', "#{make_cmd} build_libs")
 			end
 			def install
-				execute('install', "#{make_cmd} install_dev")
+				execute('install', "#{make_cmd} install_dev DESTDIR=#{path}")
 			end
 		end
 
@@ -104,6 +110,9 @@ if gem_platform=with_config("cross-build")
 					end
 					super
 				end
+				def install
+					execute('install', "#{make_cmd} install DESTDIR=#{path}")
+				end
 			end
 			# We specify -fcommon to get around duplicate definition errors in recent gcc.
 			# See https://github.com/cockroachdb/cockroach/issues/49734
@@ -112,6 +121,7 @@ if gem_platform=with_config("cross-build")
 			recipe.configure_options << "--without-keyutils"
 			recipe.configure_options << "--disable-nls"
 			recipe.configure_options << "--disable-silent-rules"
+			recipe.configure_options << "--disable-rpath"
 			recipe.configure_options << "--without-system-verto"
 			recipe.configure_options << "krb5_cv_attr_constructor_destructor=yes"
 			recipe.configure_options << "ac_cv_func_regcomp=yes"
@@ -146,12 +156,13 @@ if gem_platform=with_config("cross-build")
 					'--without-zlib',
 					'--without-icu',
 					'--without-readline',
+					'--disable-rpath',
 					'ac_cv_search_gss_store_cred_into=',
 				]
 			end
 			def compile
-				execute 'compile include', "#{make_cmd} -C src/include install"
-				execute 'compile interfaces', "#{make_cmd} -C src/interfaces install"
+				execute 'compile include', "#{make_cmd} -C src/include install DESTDIR=#{path}"
+				execute 'compile interfaces', "#{make_cmd} -C src/interfaces install DESTDIR=#{path}"
 			end
 			def install
 			end
@@ -169,6 +180,9 @@ if gem_platform=with_config("cross-build")
 	# Use our own library name for libpq to avoid loading of system libpq by accident.
 	FileUtils.ln_sf File.join(postgresql_recipe.port_path, "lib/#{libpq_orig}"),
 			File.join(postgresql_recipe.port_path, "lib/#{libpq_rubypg}")
+	# Link to libpq_rubypg in our ports directory without adding it as rpath (like dir_config does)
+	$CFLAGS << " -I#{postgresql_recipe.path}/include"
+	$LDFLAGS << " -L#{postgresql_recipe.path}/lib"
 	# Avoid dependency to external libgcc.dll on x86-mingw32
 	$LDFLAGS << " -static-libgcc" if RUBY_PLATFORM =~ /mingw|mswin/
 	# Avoid: "libpq.so: undefined reference to `dlopen'" in cross-ruby-2.7.8
@@ -176,8 +190,6 @@ if gem_platform=with_config("cross-build")
 	# Find libpq in the ports directory coming from lib/3.x
 	# It is shared between all compiled ruby versions.
 	$LDFLAGS << " '-Wl,-rpath=$$ORIGIN/../../ports/#{gem_platform}/lib'" if RUBY_PLATFORM =~ /linux/
-	# Don't use pg_config for cross build, but --with-pg-* path options
-	dir_config('pg', "#{postgresql_recipe.path}/include", "#{postgresql_recipe.path}/lib")
 
 	$defs.push( "-DPG_IS_BINARY_GEM")
 else
@@ -307,6 +319,7 @@ have_func 'PQsetChunkedRowsMode', 'libpq-fe.h' # since PostgreSQL-17
 have_func 'timegm'
 have_func 'rb_io_wait' # since ruby-3.0
 have_func 'rb_io_descriptor' # since ruby-3.1
+have_func 'rb_hash_new_capa' # since ruby-3.2
 
 have_header 'inttypes.h'
 have_header('ruby/fiber/scheduler.h') if RUBY_PLATFORM=~/mingw|mswin/
@@ -318,3 +331,20 @@ end
 create_header()
 create_makefile( "pg_ext" )
 
+if gem_platform
+	# exercise the strip command on native binary gems
+	# This approach borrowed from
+	# https://github.com/rake-compiler/rake-compiler-dock/blob/38066d479050f4fdb3956469255b35a05e5949ef/test/rcd_test/ext/mri/extconf.rb#L97C1-L110C42
+	strip_tool = RbConfig::CONFIG['STRIP']
+	strip_tool += ' -x' if RUBY_PLATFORM =~ /darwin/
+		File.open('Makefile.new', 'w') do |o|
+		o.puts 'hijack: all strip'
+		o.puts
+		o.write(File.read('Makefile'))
+		o.puts
+		o.puts 'strip: $(DLLIB)'
+		o.puts "\t$(ECHO) Stripping $(DLLIB)"
+		o.puts "\t$(Q) #{strip_tool} $(DLLIB)"
+	end
+	File.rename('Makefile.new', 'Makefile')
+end

data/ext/pg.h

@@ -76,6 +76,10 @@ typedef long suseconds_t;
 	#define PG_MAX_COLUMNS 4000
 #endif
 
+#ifndef HAVE_RB_HASH_NEW_CAPA
+#define rb_hash_new_capa(x) rb_hash_new()
+#endif
+
 #define pg_gc_location(x) x = rb_gc_location(x)
 
 /* For compatibility with ruby < 3.0 */
@@ -157,10 +161,8 @@ typedef struct {
 	/* Size of PGresult as published to ruby memory management. */
 	ssize_t result_size;
 
-	/* Prefilled tuple Hash with fnames[] as keys. */
-	VALUE tuple_hash;
-
-	/* Hash with fnames[] to field number mapping. */
+	/* Hash with fnames[] to field number mapping.
+	 * Init on-demand to create PG::Tuple objects, otherwise Qnil. */
 	VALUE field_map;
 
 	/* List of field names as frozen String or Symbol objects.

data/ext/pg_binary_decoder.c

@@ -117,7 +117,7 @@ pg_bin_dec_to_base64(t_pg_coder *conv, const char *val, int len, int tuple, int
 	/* create a buffer of the encoded length */
 	VALUE out_value = rb_str_new(NULL, encoded_len);
 
-	base64_encode( RSTRING_PTR(out_value), val, len );
+	rbpg_base64_encode( RSTRING_PTR(out_value), val, len );
 
 	/* Is it a pure String conversion? Then we can directly send out_value to the user. */
 	if( this->comp.format == 0 && dec_func == pg_text_dec_string ){

data/ext/pg_binary_encoder.c

@@ -524,7 +524,7 @@ pg_bin_enc_from_base64(t_pg_coder *conv, VALUE value, char *out, VALUE *intermed
 	if(out){
 		/* Second encoder pass, if required */
 		strlen = enc_func(this->elem, value, out, intermediate, enc_idx);
-		strlen = base64_decode( out, out, strlen );
+		strlen = rbpg_base64_decode( out, out, strlen );
 
 		return strlen;
 	} else {
@@ -538,7 +538,7 @@ pg_bin_enc_from_base64(t_pg_coder *conv, VALUE value, char *out, VALUE *intermed
 			strlen = RSTRING_LENINT(subint);
 			out_str = rb_str_new(NULL, BASE64_DECODED_SIZE(strlen));
 
-			strlen = base64_decode( RSTRING_PTR(out_str), RSTRING_PTR(subint), strlen);
+			strlen = rbpg_base64_decode( RSTRING_PTR(out_str), RSTRING_PTR(subint), strlen);
 			rb_str_set_len( out_str, strlen );
 			*intermediate = out_str;
 

data/ext/pg_connection.c

@@ -66,6 +66,7 @@ pg_get_connection_safe( VALUE self )
 	t_pg_connection *this;
 	TypedData_Get_Struct( self, t_pg_connection, &pg_connection_type, this);
 
+	rb_check_frozen(self);
 	if ( !this->pgconn )
 		pg_raise_conn_error( rb_eConnectionBad, self, "connection is closed");
 
@@ -2382,7 +2383,7 @@ pgconn_notifies(VALUE self)
 		return Qnil;
 	}
 
-	hash = rb_hash_new();
+	hash = rb_hash_new_capa(3);
 	relname = rb_str_new2(notification->relname);
 	be_pid = INT2NUM(notification->be_pid);
 	extra = rb_str_new2(notification->extra);
@@ -4425,9 +4426,11 @@ pgconn_set_default_encoding( VALUE self )
  *    res.type_map_for_queries = typemap
  *
  * Set the default TypeMap that is used for type casts of query bind parameters.
+ * It can be overwritten per +type_map+ parameter of #exec_params and siblings.
  *
  * +typemap+ must be a kind of PG::TypeMap .
  *
+ * See also #type_map_for_queries
  */
 static VALUE
 pgconn_type_map_for_queries_set(VALUE self, VALUE typemap)
@@ -4452,6 +4455,9 @@ pgconn_type_map_for_queries_set(VALUE self, VALUE typemap)
  * Returns the default TypeMap that is currently set for type casts of query
  * bind parameters.
  *
+ * Default is PG::TypeMapAllStrings .
+ *
+ * See also #type_map_for_queries=
  */
 static VALUE
 pgconn_type_map_for_queries_get(VALUE self)
@@ -4466,9 +4472,11 @@ pgconn_type_map_for_queries_get(VALUE self)
  *    res.type_map_for_results = typemap
  *
  * Set the default TypeMap that is used for type casts of result values.
+ * It can be overwritten per PG::Result#type_map= .
  *
  * +typemap+ must be a kind of PG::TypeMap .
  *
+ * See also #type_map_for_results
  */
 static VALUE
 pgconn_type_map_for_results_set(VALUE self, VALUE typemap)
@@ -4490,6 +4498,9 @@ pgconn_type_map_for_results_set(VALUE self, VALUE typemap)
  *
  * Returns the default TypeMap that is currently set for type casts of result values.
  *
+ * Default is PG::TypeMapAllStrings .
+ *
+ * See also #type_map_for_results=
  */
 static VALUE
 pgconn_type_map_for_results_get(VALUE self)
@@ -4506,11 +4517,13 @@ pgconn_type_map_for_results_get(VALUE self)
  *
  * Set the default coder that is used for type casting of parameters
  * to #put_copy_data .
+ * It can be overwritten per +encoder+ parameter of #put_copy_data and +coder+ parameter of #copy_data.
  *
  * +encoder+ can be:
  * * a kind of PG::Coder
  * * +nil+ - disable type encoding, data must be a String.
  *
+ * See also #encoder_for_put_copy_data
  */
 static VALUE
 pgconn_encoder_for_put_copy_data_set(VALUE self, VALUE encoder)
@@ -4540,6 +4553,8 @@ pgconn_encoder_for_put_copy_data_set(VALUE self, VALUE encoder)
  * * a kind of PG::Coder
  * * +nil+ - type encoding is disabled, data must be a String.
  *
+ * Default is +nil+ .
+ * See also #encoder_for_put_copy_data=
  */
 static VALUE
 pgconn_encoder_for_put_copy_data_get(VALUE self)
@@ -4555,11 +4570,13 @@ pgconn_encoder_for_put_copy_data_get(VALUE self)
  *
  * Set the default coder that is used for type casting of received data
  * by #get_copy_data .
+ * It can be overwritten per +decoder+ parameter of #get_copy_data and +coder+ parameter of #copy_data.
  *
  * +decoder+ can be:
  * * a kind of PG::Coder
  * * +nil+ - disable type decoding, returned data will be a String.
  *
+ * See also #decoder_for_get_copy_data
  */
 static VALUE
 pgconn_decoder_for_get_copy_data_set(VALUE self, VALUE decoder)
@@ -4589,6 +4606,9 @@ pgconn_decoder_for_get_copy_data_set(VALUE self, VALUE decoder)
  * * a kind of PG::Coder
  * * +nil+ - type encoding is disabled, returned data will be a String.
  *
+ * Default is +nil+ .
+ *
+ * See also #decoder_for_get_copy_data=
  */
 static VALUE
 pgconn_decoder_for_get_copy_data_get(VALUE self)
@@ -4611,7 +4631,7 @@ pgconn_decoder_for_get_copy_data_get(VALUE self)
  *
  * Settings the type of field names affects only future results.
  *
- * See further description at PG::Result#field_name_type=
+ * See further description at PG::Result#field_name_type= and #field_name_type .
  *
  */
 static VALUE