pg 1.5.9 → 1.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0abb6cbfa5134825baaaa3cab5bbb2d88a5092559331239ccb977c24579d27d
-  data.tar.gz: 53d6fd115d923b9654b2928791309d290a87f01275a13f3489025d673ba967ab
+  metadata.gz: b98dcd23695bd37aca4e9769e5b55a26ab53b7de01e4b44ff22d1849df08088a
+  data.tar.gz: d9610b8ca74c772db98aff8ff661fa29ea44d8917e0ef48f1e89f9cdfd3158b3
 SHA512:
-  metadata.gz: c7b1c92f223b4250fd56d37bbfa94dadf19d9e03518e7a3426bb19800745f031ab133a3d8921ec2f63045762e46bbfe7ac5a01f0144c4eb3d5b3ad8cf2f1197d
-  data.tar.gz: 3fd53f91bfc2880da42fddcc5ae6a9334c419025636e0d1626b533da7fa62a6f87942629ed6c24c1183002295dcbdf56a33c96af2323e3a9fb0396bcb68e673e
+  metadata.gz: 531c1c61fdb41ea77a8e8e657a536f5734fecc117f7b3a93c04707b7f16a034a841859944e097e75db12ea630ff2679ed90054e0132b96f23ee92c5807d8c07f
+  data.tar.gz: 7d7d8d8c0ff76687d63912d41cf4dea890eb63bf361378b9da075ad1f8ccda9b34353e0de0f462bff5cae2740ee17988c3aef417c92d9b38d3a1b635e6ed19f5

data/{History.md → CHANGELOG.md}

@@ -1,3 +1,83 @@
+## 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).
+- Serialize CompositeCoder#dimensions only when set. [#652](https://github.com/ged/ruby-pg/pull/652)
+  This fixes the compatibility to pg-1.5.9, when deserializing Marshal data from pg-1.6, as long as the new attribute isn't used.
+- Remove dependency to MSYS2 package "postgresql" from binary Windows gem [#654](https://github.com/ged/ruby-pg/pull/654)
+
+
+## v1.6.0 [2025-07-27] Lars Kanis <lars@greiz-reinsdorf.de>
+
+Added:
+
+- Add binary gems for Ruby 3.4.
+- Add fat binary gem for platform `aarch64-mingw-ucrt` aka Windows on ARM [#626](https://github.com/ged/ruby-pg/pull/626), for platform Macos on Intel and ARM [#643](https://github.com/ged/ruby-pg/pull/643), for platform `aarch64-linux` [#646](https://github.com/ged/ruby-pg/pull/646) and for platform `x86_64-linux` [#551](https://github.com/ged/ruby-pg/pull/551#issuecomment-2504715762).
+- Update fat binary gem to OpenSSL-3.5.1 and PostgreSQL-17.5.
+- Add a patch to libpq to avoid starvation on bigger SSL records, which some database engines other than vanilla PostgreSQL use.
+  This patch applies to platform specific binary gems only.
+  [#616](https://github.com/ged/ruby-pg/pull/616)
+- Add support for new query cancel functions of PostgreSQL-17.
+  This adds the new class `PG::CancelConnection` which provides the ability to cancel a query per blocking or per non-blocking functions.
+  If the new functions are available they are used and the older are no longer compiled in.
+  This way we can get rid of reading out the internal `PGcancel` struct by `Connection#backend_key`.
+  [#614](https://github.com/ged/ruby-pg/pull/614)
+- Add PG::BinaryDecoder::Array and PG::BinaryEncoder::Array to parse and encode PostgreSQL arrays in binary format.
+  [#603](https://github.com/ged/ruby-pg/pull/603)
+- Add possibility to define the number of array dimensions to be encoded.
+  Setting dimensions is especially useful, when a Record shall be encoded into an Array, since the Array encoder can not distinguish if the array shall be encoded as a higher dimension or as a record otherwise.
+  [#622](https://github.com/ged/ruby-pg/pull/622)
+- Add Connection#set_chunked_rows_mode [#610](https://github.com/ged/ruby-pg/pull/610)
+- Add PG::Connection#close_prepared, PG::Connection#close_portal, PG::Connection#send_close_prepared and PG::Connection#send_close_portal which are new in PostgreSQL-17.
+  [#611](https://github.com/ged/ruby-pg/pull/611)
+- Add Connection#send_pipeline_sync, async_pipeline_sync and release GVL at PQ(sendP|P)ipelineSync.
+  [#612](https://github.com/ged/ruby-pg/pull/612)
+- Add MINGW package dependency which is resolved by RubyInstaller.
+  [#617](https://github.com/ged/ruby-pg/pull/617)
+- Change `conn.server_version` and `conn.protocol_version` to raise instead of return 0 on error.
+  [#632](https://github.com/ged/ruby-pg/pull/632)
+- Fix connecting to multiple hosts after `connnect_timeout`.
+  [#637](https://github.com/ged/ruby-pg/pull/637)
+- Fix making PG::BasicTypeMapForQueries shareable for Ractor in ruby-3.5.
+  [#636](https://github.com/ged/ruby-pg/pull/636)
+- Fix missing array input verification in PG::TypeMapByColumn.
+  This could cause a segfault.
+  [#620](https://github.com/ged/ruby-pg/pull/620)
+- Rename `History.md` to `CHANGELOG.md`, which is more common.
+  [#642](https://github.com/ged/ruby-pg/pull/642)
+
+Removed:
+
+- Drop support of Ruby < 2.7 [#606](https://github.com/ged/ruby-pg/pull/606)
+- Drop support of PostgreSQL < 10 [#606](https://github.com/ged/ruby-pg/pull/606)
+- Remove workaround for Truffleruby < 21.3.0 [#613](https://github.com/ged/ruby-pg/pull/613)
+
+
 ## v1.5.9 [2024-10-24] Lars Kanis <lars@greiz-reinsdorf.de>
 
 - Enable thread safety in static OpenSSL build for Windows. [#595](https://github.com/ged/ruby-pg/pull/595)

data/Gemfile

@@ -1,17 +1,20 @@
 # -*- 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/"
 
-group :development, :test do
-  gem "bundler", ">= 1.16", "< 3.0"
-  gem "rake-compiler", "~> 1.0"
-  gem "rake-compiler-dock", "~> 1.0"
+group :development do
   gem "rdoc", "~> 6.4"
+  gem "mini_portile2", "~> 2.1"
+end
+
+group :test do
+  gem "bundler", ">= 1.16", "< 5.0"
+  gem "rake-compiler", "~> 1.0"
+  gem "rake-compiler-dock", "~> 1.11.0" #, git: "https://github.com/rake-compiler/rake-compiler-dock"
   gem "rspec", "~> 3.5"
-  gem "ostruct", "~> 0.5" # for Rakefile.cross
   # "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.
   # With bigdecimal commented out here, corresponding tests are omitted on ruby-3.4+ but are executed on ruby < 3.4.

data/README-Windows.rdoc

@@ -41,7 +41,7 @@ sure it is started. A native Docker installation is best on Linux.
 
 Then run:
 
-	rake gem:windows
+	rake gem:native
 
 This will download a docker image suited for building windows gems, and it
 will download and build OpenSSL and PostgreSQL. Finally the gem is built

data/README.ja.md

@@ -2,7 +2,7 @@
 
 * ホーム :: https://github.com/ged/ruby-pg
 * ドキュメント :: http://deveiate.org/code/pg （英語）、 https://deveiate.org/code/pg/README_ja_md.html （日本語）
-* 変更履歴 :: link:/History.md
+* 変更履歴 :: link:/CHANGELOG.md
 
 [![https://gitter.im/ged/ruby-pg
 でチャットに参加](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ged/ruby-pg?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
@@ -12,7 +12,7 @@
 
 Pgは[PostgreSQL
 RDBMS](http://www.postgresql.org/)へのRubyのインターフェースです。[PostgreSQL
-9.3以降](http://www.postgresql.org/support/versioning/)で動作します。
+10以降](http://www.postgresql.org/support/versioning/)で動作します。
 
 簡単な使用例は次の通りです。
 ```ruby
@@ -41,8 +41,8 @@ Actionsのビルド状況](https://github.com/ged/ruby-pg/actions/workflows/sour
 
 ## 要件
 
-* Ruby 2.5かそれより新しいバージョン
-* PostgreSQL 9.3.xかそれ以降のバージョン（ヘッダー付属のもの、例えば-devの名前のパッケージ）。
+* Ruby 2.7かそれより新しいバージョン
+* PostgreSQL 10.xかそれ以降のバージョン（ヘッダー付属のもの、例えば-devの名前のパッケージ）。
 
 それより前のバージョンのRubyやPostgreSQLでも通常は同様に動作しますが、定期的なテストはされていません。
 

data/README.md

@@ -1,9 +1,9 @@
 # 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:/History.md
+* clog :: link:/CHANGELOG.md
 
 [![Join the chat at https://gitter.im/ged/ruby-pg](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ged/ruby-pg?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
@@ -11,7 +11,7 @@
 ## Description
 
 Pg is the Ruby interface to the [PostgreSQL RDBMS](http://www.postgresql.org/).
-It works with [PostgreSQL 9.3 and later](http://www.postgresql.org/support/versioning/).
+It works with [PostgreSQL 10 and later](http://www.postgresql.org/support/versioning/).
 
 A small example usage:
 ```ruby
@@ -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)
@@ -39,30 +42,34 @@ A small example usage:
 
 ## Requirements
 
-* Ruby 2.5 or newer
-* PostgreSQL 9.3.x or later (with headers, -dev packages, etc).
+* Ruby 2.7 or newer
+* PostgreSQL 10.x or later
+* When installing the source gem: libpq with headers, -dev packages, etc.
 
-It usually works with earlier versions of Ruby/PostgreSQL as well, but those are
-not regularly tested.
 
+## How To Install
 
-## Versioning
+Install via RubyGems:
 
-We tag and release gems according to the [Semantic Versioning](http://semver.org/) principle.
+    gem install pg
 
-As a result of this policy, you can (and should) specify a dependency on this gem using the [Pessimistic Version Constraint](http://guides.rubygems.org/patterns/#pessimistic-version-constraint) with two digits of precision.
+This installs the binary gem, specific to the running platform by default.
 
-For example:
+### Binary gem
 
-```ruby
-  spec.add_dependency 'pg', '~> 1.0'
-```
+The binary gems don't depend on the libpq package on the running system.
+They have libpq builtin.
 
-## How To Install
+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.
 
-Install via RubyGems:
+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.
 
-    gem install pg
+### Source gem
+
+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
 Postgres:
@@ -73,6 +80,28 @@ If you're installing via Bundler, you can provide compile hints like so:
 
     bundle config build.pg --with-pg-config=<path to pg_config>
 
+### Bundler
+
+To make sure, the necessary platforms and the source gem are fetched by bundler, they can be added like so
+
+```
+bundle lock --add-platform x86_64-linux
+bundle lock --add-platform arm64-darwin
+bundle lock --add-platform x64-mingw-ucrt
+bundle lock --add-platform ruby
+bundle package --all-platforms
+```
+
+A re-run of `bundle package` is also necessary after `bundle update`, in order to retrieve the new specific gems of all platforms.
+
+If the binary gems don't work for some reason, it's easy to force the usage of the source gem in the Gemfile:
+
+```
+gem "pg", force_ruby_platform: true
+```
+
+### More
+
 See README-OS_X.rdoc for more information about installing under MacOS X, and
 README-Windows.rdoc for Windows build/installation instructions.
 
@@ -85,6 +114,19 @@ can be found in [the `certs` directory](https://github.com/ged/ruby-pg/tree/mast
 of the repository.
 
 
+## Versioning
+
+We tag and release gems according to the [Semantic Versioning](http://semver.org/) principle.
+
+As a result of this policy, you can (and should) specify a dependency on this gem using the [Pessimistic Version Constraint](http://guides.rubygems.org/patterns/#pessimistic-version-constraint) with two digits of precision.
+
+For example:
+
+```ruby
+  spec.add_dependency 'pg', '~> 1.0'
+```
+
+
 ## Type Casts
 
 Pg can optionally type cast result values and query parameters in Ruby or
@@ -108,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
@@ -141,7 +183,7 @@ The following PostgreSQL column types are supported by ruby-pg (TE = Text Encode
 * Date: [TE](rdoc-ref:PG::TextEncoder::Date), [TD](rdoc-ref:PG::TextDecoder::Date), [BE](rdoc-ref:PG::BinaryEncoder::Date), [BD](rdoc-ref:PG::BinaryDecoder::Date)
 * JSON and JSONB: [TE](rdoc-ref:PG::TextEncoder::JSON), [TD](rdoc-ref:PG::TextDecoder::JSON)
 * Inet: [TE](rdoc-ref:PG::TextEncoder::Inet), [TD](rdoc-ref:PG::TextDecoder::Inet)
-* Array: [TE](rdoc-ref:PG::TextEncoder::Array), [TD](rdoc-ref:PG::TextDecoder::Array)
+* Array: [TE](rdoc-ref:PG::TextEncoder::Array), [TD](rdoc-ref:PG::TextDecoder::Array), [BE](rdoc-ref:PG::BinaryEncoder::Array), [BD](rdoc-ref:PG::BinaryDecoder::Array)
 * Composite Type (also called "Row" or "Record"): [TE](rdoc-ref:PG::TextEncoder::Record), [TD](rdoc-ref:PG::TextDecoder::Record)
 
 The following text and binary formats can also be encoded although they are not used as column type:
@@ -150,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.
@@ -175,11 +217,12 @@ The following type maps are prefilled with type mappings from the PG::BasicTypeR
 * PG::BasicTypeMapBasedOnResult - a PG::TypeMapByOid prefilled with encoders for common PostgreSQL column types
 * PG::BasicTypeMapForQueries - a PG::TypeMapByClass prefilled with encoders for common Ruby value classes
 
+Several type maps can be chained by setting PG::TypeMap::DefaultTypeMappable#default_type_map .
 
 ## 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

@@ -11,6 +11,7 @@ require 'rake/clean'
 require 'rspec/core/rake_task'
 require 'bundler'
 require 'bundler/gem_helper'
+require_relative "rakelib/pg_gem_helper"
 
 # Build directory constants
 BASEDIR = Pathname( __FILE__ ).dirname
@@ -31,10 +32,10 @@ CLEAN.include( PKGDIR.to_s, TMPDIR.to_s )
 CLEAN.include "lib/*/libpq.dll"
 CLEAN.include "lib/pg_ext.*"
 CLEAN.include "lib/pg/postgresql_lib_path.rb"
+CLEAN.include "ports/*.installed"
+CLEAN.include "ports/*mingw*", "ports/*linux*", "ports/*darwin*"
 
-load 'Rakefile.cross'
-
-Bundler::GemHelper.install_tasks
+PgGemHelper.install_tasks
 $gem_spec = Bundler.load_gemspec(GEMSPEC)
 
 desc "Turn on warnings and debugging in the build."
@@ -42,6 +43,24 @@ task :maint do
 	ENV['MAINTAINER_MODE'] = 'yes'
 end
 
+CrossLibrary = Struct.new :platform, :openssl_config, :toolchain
+CrossLibraries = [
+	['aarch64-mingw-ucrt', 'mingwarm64', 'aarch64-w64-mingw32'],
+	['x64-mingw-ucrt', 'mingw64', 'x86_64-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'],
+	['aarch64-linux', 'linux-aarch64', 'aarch64-linux-gnu'],
+	['aarch64-linux-musl', 'linux-aarch64', 'aarch64-linux-musl'],
+	['x86_64-darwin', 'darwin64-x86_64', 'x86_64-apple-darwin'],
+	['arm64-darwin', 'darwin64-arm64', 'arm64-apple-darwin'],
+].map do |platform, openssl_config, toolchain|
+	CrossLibrary.new platform, openssl_config, toolchain
+end
+
+# Register binary gems to be pushed to rubygems.org
+Bundler::GemHelper.instance.cross_platforms = CrossLibraries.map(&:platform)
+
 # Rake-compiler task
 Rake::ExtensionTask.new do |ext|
 	ext.name           = 'pg_ext'
@@ -50,24 +69,68 @@ Rake::ExtensionTask.new do |ext|
 	ext.lib_dir        = 'lib'
 	ext.source_pattern = "*.{c,h}"
 	ext.cross_compile  = true
-	ext.cross_platform = CrossLibraries.map(&:for_platform)
 
-	ext.cross_config_options += CrossLibraries.map do |lib|
+	# 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>[\w\.]+)-mri-(?<platform>[-\w]+)$/)
+		m && m[:platform] == pl
+	end
+
+	ext.cross_config_options += CrossLibraries.map do |xlib|
 		{
-			lib.for_platform => [
-				"--enable-windows-cross",
-				"--with-pg-include=#{lib.static_postgresql_incdir}",
-				"--with-pg-lib=#{lib.static_postgresql_libdir}",
-				# libpq-fe.h resides in src/interfaces/libpq/ before make install
-				"--with-opt-include=#{lib.static_postgresql_libdir}",
+			xlib.platform => [
+				"--with-cross-build=#{xlib.platform}",
+				"--with-openssl-platform=#{xlib.openssl_config}",
+				"--with-toolchain=#{xlib.toolchain}",
 			]
 		}
 	end
 
-	# Add libpq.dll to windows binary gemspec
+	# Add libpq.dll/.so to fat binary gemspecs
 	ext.cross_compiling do |spec|
-		spec.files << "lib/#{spec.platform}/libpq.dll"
+		spec.files << "ports/#{spec.platform.to_s}/lib/libpq-ruby-pg.so.1" if spec.platform.to_s =~ /linux/
+		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 need postgresql header+lib files
+		spec.metadata.delete("msys2_mingw_dependencies")
+	end
+end
+
+task 'gem:native:prepare' do
+	require 'io/console'
+	require 'rake_compiler_dock'
+
+	# 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"] || "")
+	rescue OpenSSL::PKey::PKeyError
+		ENV["GEM_PRIVATE_KEY_PASSPHRASE"] = STDIN.getpass("Enter passphrase of gem signature key: ")
+		retry
+	end
+end
+
+CrossLibraries.each do |xlib|
+	platform = xlib.platform
+	desc "Build fat binary gem for platform #{platform}"
+	task "gem:native:#{platform}" => ['gem:native:prepare'] do
+		RakeCompilerDock.sh <<-EOT, platform: platform
+			#{ "sudo apt-get update && sudo apt-get install -y bison flex &&" if platform =~ /darwin/ }
+			#{ # remove nm on Linux to suppress PostgreSQL's check for exit which raises thread_exit as a false positive:
+				"sudo mv `which nm` `which nm`.bak &&" if platform =~ /linux/ }
+			sudo apt-get update && sudo apt-get install -y bison flex &&
+			(cp build/gem/gem-*.pem ~/.gem/ || true) &&
+			bundle install --local &&
+			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"
+	multitask 'gem:native' => "gem:native:#{platform}"
 end
 
 RSpec::Core::RakeTask.new(:spec).rspec_opts = "--profile -cfdoc"
@@ -94,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