pg 1.5.9 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0abb6cbfa5134825baaaa3cab5bbb2d88a5092559331239ccb977c24579d27d
-  data.tar.gz: 53d6fd115d923b9654b2928791309d290a87f01275a13f3489025d673ba967ab
+  metadata.gz: 01ff8f72c20e6b96364acee8cc436df0d1305861cd3edba88be07c81fc0e2e55
+  data.tar.gz: e1dce91f9a03eaf081e11705175902c43471710612d299d626e2bb796c6990f6
 SHA512:
-  metadata.gz: c7b1c92f223b4250fd56d37bbfa94dadf19d9e03518e7a3426bb19800745f031ab133a3d8921ec2f63045762e46bbfe7ac5a01f0144c4eb3d5b3ad8cf2f1197d
-  data.tar.gz: 3fd53f91bfc2880da42fddcc5ae6a9334c419025636e0d1626b533da7fa62a6f87942629ed6c24c1183002295dcbdf56a33c96af2323e3a9fb0396bcb68e673e
+  metadata.gz: 1326d36f1ebcd07e755615fa2bdc78c46bcf937f1d085c080816dee7f93790ce3aedcb58ff3be4840e6f1c713c7a81e2879bfa934d4fbcdea3faa891f83fc534
+  data.tar.gz: 80b0474f35ffd2ef4339fbb635a375b4de216ef3a0c8f3b9ad5da6b4f5e6767edae9794fe15364ca6f27667867e137cba809b1770c63436102f3389c3c42f27a

data/{History.md → CHANGELOG.md}

@@ -1,3 +1,129 @@
+## v1.7.0 [2026-10-02] Lars Kanis <lars@greiz-reinsdorf.de>
+
+Added:
+
+- Add PG::Connection#embed_params and keyword `:typename` for its parameter casting. [#726](https://github.com/ged/ruby-pg/pull/726)
+  This allows to generate SQL strings with embedded parameters for easier debugging.
+- Add PG::Connection#full_protocol_version which is new in PostgreSQL-18 [#695](https://github.com/ged/ruby-pg/pull/695)
+- Add PG::Result#each_tuple [#675](https://github.com/ged/ruby-pg/pull/675)
+- Add PG::TypeMap#query_param_encoders to retrieve encoders. [#726](https://github.com/ged/ruby-pg/pull/726)
+- Deduplicate result field name strings for better performance. [#750](https://github.com/ged/ruby-pg/pull/750)
+
+Removed:
+
+- Remove compatibility to ruby < 3.1 and drops support of ruby-2.7 and ruby-3.0. [#749](https://github.com/ged/ruby-pg/pull/749)
+- Remove GLV unlocking at all functions which process data modifiable in a second thread. [#721](https://github.com/ged/ruby-pg/pull/721)
+  This avoids possible premature garbage collection of query parameters and possible VM crash due to concurrent data manipulation.
+- Remove `:static_symbol` result field names. [#691](https://github.com/ged/ruby-pg/pull/691)
+- Remove enforced rpath addition when no rpath is configured in rbconfig. [#699](https://github.com/ged/ruby-pg/pull/699)
+
+Fixes:
+
+- Limit memory allocation on invalid input into PG::BinaryDecoder::Array. [#743](https://github.com/ged/ruby-pg/pull/743)
+- Free COPY buffers when decoders raise to avoid possible memory leak in get_copy_data. [#742](https://github.com/ged/ruby-pg/pull/742)
+- Prevent SQL injection in set_client_encoding. [#741](https://github.com/ged/ruby-pg/pull/741)
+- Add GC_GUARD to temporary ruby objects for conninfo string to avoid it's GC'ed prematurely. [#739](https://github.com/ged/ruby-pg/pull/739)
+- Remove option "quirks_mode" from JSON en/decoder to fix compat with json-3.0 gem. [#737](https://github.com/ged/ruby-pg/pull/737)
+- Respect calendar type of Ruby and PostgreSQL. [#725](https://github.com/ged/ruby-pg/pull/725)
+- Fix broken set_notice_(receiver|processor) callback after GC.compact. [#734](https://github.com/ged/ruby-pg/pull/734)
+- Disable DNS resolution in ruby when a service file is used, so that the priority of parameters is equal to libpq. [#635](https://github.com/ged/ruby-pg/pull/635)
+- Use RARRAY_LENINT to avoid possible overflow. [#728](https://github.com/ged/ruby-pg/pull/728)
+- Fix possible integer overflow at PG::BinaryEncoder::CopyRow and PG::TextEncoder::CopyRow. [#714](https://github.com/ged/ruby-pg/pull/714), [#715](https://github.com/ged/ruby-pg/pull/715)
+- Avoid possible integer overflow in query parameter encoding. [#719](https://github.com/ged/ruby-pg/pull/719)
+- Ensure conninfo is a valid C string before closing the connection to avoid a double free of PGconn. [#709](https://github.com/ged/ruby-pg/pull/709)
+- Raise on a too large input string to PG::TextEncoder::Bytea. [#717](https://github.com/ged/ruby-pg/pull/717)
+- Check PG::BinaryEncoder::CopyRow array input size instead of producing an invalid output.
+- Remove accidentally copied "static" keyword from Copy and Record encoder. [#711](https://github.com/ged/ruby-pg/pull/711)
+- Avoid possibility to replace typemap while being used in Copy and Record encoders and decoders. [#707](https://github.com/ged/ruby-pg/pull/707)
+- Add GC_GUARD's for encoding converted strings sent to the server. [#705](https://github.com/ged/ruby-pg/pull/705)
+- Fix incomplete transaction commit when thread is shutdown ungracefully. [#704](https://github.com/ged/ruby-pg/pull/704)
+- Assign VALUE after registration per rb_gc_register_address() [#703](https://github.com/ged/ruby-pg/pull/703)
+- Update dependencies for binary gems to PostgreSQL-18.6, OpenSSL-3.6.5, krb5-1.22.2 [#752](https://github.com/ged/ruby-pg/pull/752)
+
+
+## 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](https://github.com/ged/ruby-pg/pull/682)
+- Update fat binary gem to OpenSSL-3.6.0 and PostgreSQL-18.1.
+- Improve documentation of PG::Result and README. [#676](https://github.com/ged/ruby-pg/pull/676)
+- Update errorcodes to PostgreSQL-18.
+- Use `rb_hash_new_capa` on Ruby-3.2+ . [#674](https://github.com/ged/ruby-pg/pull/674)
+- Deny any server communication on a frozen PG::Connection . [#677](https://github.com/ged/ruby-pg/pull/677)
+- Fix possible race condition in PG::Result in Ractor context. [#674](https://github.com/ged/ruby-pg/pull/674)
+
+Removed:
+
+- Drop binary gem support for platform `x86-mingw32`. [#682](https://github.com/ged/ruby-pg/pull/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,20 +1,24 @@
 # -*- 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.
   # That way we can check both situations in CI.
   # gem "bigdecimal", "~> 3.0"
+  gem "drb"
 end

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

@@ -1,8 +1,8 @@
 # pg
 
 * ホーム :: https://github.com/ged/ruby-pg
-* ドキュメント :: http://deveiate.org/code/pg （英語）、 https://deveiate.org/code/pg/README_ja_md.html （日本語）
-* 変更履歴 :: link:/History.md
+* ドキュメント :: http://deveiate.org/code/pg/README_md.html （英語）、 https://deveiate.org/code/pg/README_ja_md.html （日本語）
+* 変更履歴 :: 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
@@ -31,6 +31,10 @@ RDBMS](http://www.postgresql.org/)へのRubyのインターフェースです。
   end
 ```
 
+問い合わせのメソッドについては PG::Connection クラスを、問い合わせの結果を取り回す際の情報については PG::Result
+クラスを参照してください。
+
+
 ## ビルド状況
 
 [![Github
@@ -41,29 +45,38 @@ Actionsのビルド状況](https://github.com/ged/ruby-pg/actions/workflows/sour
 
 ## 要件
 
-* Ruby 2.5かそれより新しいバージョン
-* PostgreSQL 9.3.xかそれ以降のバージョン（ヘッダー付属のもの、例えば-devの名前のパッケージ）。
+* Ruby 3.1かそれより新しいバージョン
+* PostgreSQL 10.x以降
+* ソースからgemをインストールする場合：-devのパッケージなど、ヘッダ付きのlibpq
 
-それより前のバージョンのRubyやPostgreSQLでも通常は同様に動作しますが、定期的なテストはされていません。
 
+## インストール方法
 
-## バージョン管理
+RubyGemsを経由してインストールするには以下とします。
 
-[セマンティックバージョニング](http://semver.org/)の原則にしたがってgemをタグ付けしてリリースしています。
+    gem install pg
 
-この方針の結果として、2つの数字を指定する[悲観的バージョン制約](http://guides.rubygems.org/patterns/#pessimistic-version-constraint)を使ってこのgemへの依存関係を指定することができます（またそうすべきです）。
+こうするとバイナリgem、とりわけ実行しているプラットフォームに固有のものが既定でインストールされます。
 
-例えば次の通りです。
+### バイナリgem
 
-```ruby
-  spec.add_dependency 'pg', '~> 1.0'
-```
+バイナリgemは実行中のシステムのlibpqパッケージに依存しません。
+組込みでlibpqを持ちます。
 
-## インストール方法
+`x86_64-linux`と`aarch64-linux`のプラットフォームのgemはAlpine
+Linuxで走りますが、`gcompat`パッケージが要求されます。一方、`*-linux-musl`のプラットフォームのネイティブgemはその依存関係なしに動作します。
 
-RubyGemsを経由してインストールするには以下とします。
+バイナリgemが対応していない用途が1つあり、それが[LDAPからの接続オプション](https://www.postgresql.org/docs/current/libpq-ldap.html)の取得です。
+これに対応するには`libldap`が必要でしょうが、沢山の依存関係があります。
+広く使われている機能のようにも対応する価値があるとも思われません。
+必要であれば、ソースgemに強制できます。
 
-    gem install pg
+### ソースgem
+
+ソースgemは次のように強制できます。
+
+    gem uninstall pg --all
+    gem install pg --platform ruby
 
 Postgresと一緒にインストールされた'pg_config'プログラムへのパスを指定する必要があるかもしれません。
 
@@ -73,6 +86,29 @@ Bundlerを介してインストールした場合は次のようにコンパイ
 
     bundle config build.pg --with-pg-config=<path to pg_config>
 
+### Bundler
+
+必要なプラットフォームとソースgemがbundlerにより取得されることを確実にするためには、次のように加えられます。
+
+```
+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
+```
+
+`bundle package`の再実行は`bundle
+update`後にも必須であり、これはすべてのプラットフォームの新しい特定のgemを取得するためです。
+
+バイナリgemが何らかの理由で動作しないなら、Gemfileでソースgemの利用を簡単に強制できます。
+
+```
+gem "pg", force_ruby_platform: true
+```
+
+### その他
+
 MacOS Xへインストールする詳しい情報については README-OS_X.rdoc を、Windows用のビルドやインストールの説明については
 README-Windows.rdoc を参照してください。
 
@@ -81,9 +117,22 @@ README-Windows.rdoc を参照してください。
 署名されたgemとしてインストールしたい場合は、リポジトリの[`certs`ディレクトリ](https://github.com/ged/ruby-pg/tree/master/certs)にgemの署名をする公開証明書があります。
 
 
+## バージョン管理
+
+[セマンティックバージョニング](http://semver.org/)の原則にしたがってgemをタグ付けしてリリースしています。
+
+この方針の結果として、2つの数字を指定する[悲観的バージョン制約](http://guides.rubygems.org/patterns/#pessimistic-version-constraint)を使ってこのgemへの依存関係を指定することができます（またそうすべきです）。
+
+例えば次の通りです。
+
+```ruby
+  spec.add_dependency 'pg', '~> 1.0'
+```
+
+
 ## 型変換
 
-Pgでは任意でRubyと素のCコードにある結果の値やクエリ引数の型変換ができます。
+Pgでは任意でRubyと素のCコードにある結果の値や問い合わせ引数の型変換ができます。
 こうすることでデータベースとのデータの往来を加速させられます。
 なぜなら文字列のアロケーションが減り、（比較的遅い）Rubyのコードでの変換部分が省かれるからです。
 
@@ -102,10 +151,10 @@ Pgでは任意でRubyと素のCコードにある結果の値やクエリ引数
 
 しかしPgの型変換はかなり調整が効きます。2層に分かれているのがその理由です。
 
-### エンコーダーとデコーダー (ext/pg_*coder.c, lib/pg/*coder.rb)
+### エンコーダーとデコーダー (ext/pg_\*coder.c, lib/pg/\*coder.rb)
 
 こちらはより低層で、DBMSへ転送するためにRubyのオブジェクトを変換するエンコーディングクラスと、取得してきたデータをRubyのオブジェクトに変換し戻すデコーディングクラスが含まれています。
-クラスはそれぞれの形式によって名前空間 PG::TextEncoder, PG::TextDecoder, PG::BinaryEncoder, そして
+クラスはそれぞれの形式によって名前空間 PG::TextEncoder, PG::TextDecoder, PG::BinaryEncoder,
 PG::BinaryDecoder に分かれています。
 
 エンコーダーないしデコーダーオブジェクトにOIDデータ型や形式コード（テキストないしバイナリ）や任意で名前を割り当てることができます。
@@ -145,13 +194,14 @@ Binary Encoder、BD = Binary Decoder）。
       [現地時間](rdoc-ref:PG::BinaryEncoder::TimestampLocal)、[UTC](rdoc-ref:PG::BinaryEncoder::TimestampUtc)
     * BD:
       [現地時間](rdoc-ref:PG::BinaryDecoder::TimestampLocal)、[UTC](rdoc-ref:PG::BinaryDecoder::TimestampUtc)、[UTCから現地時間へ](rdoc-ref:PG::BinaryDecoder::TimestampUtcToLocal)
-* 日付：[TE](rdoc-ref:PG::TextEncoder::Date)、[TD](rdoc-ref:PG::TextDecoder::Date)、[BE](rdoc-ref:PG::BinaryEncoder::Date)、[BD](rdoc-ref:PG::BinaryDecoder::Date)
+* 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と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)
+  [TE](rdoc-ref:PG::TextEncoder::Array)、[TD](rdoc-ref:PG::TextDecoder::Array)、[BE](rdoc-ref:PG::BinaryEncoder::Array)、[BD](rdoc-ref:PG::BinaryDecoder::Array)
 * 複合型（「行」や「レコード」などとも言います）：[TE](rdoc-ref:PG::TextEncoder::Record)、[TD](rdoc-ref:PG::TextDecoder::Record)
 
 カラム型として使われていませんが、以下のテキスト形式とバイナリ形式もエンコードできます。
@@ -163,14 +213,14 @@ Binary Encoder、BD = Binary Decoder）。
 * SQLの識別子:
   [TE](rdoc-ref:PG::TextEncoder::Identifier)、[TD](rdoc-ref:PG::TextDecoder::Identifier)
 
-### PG::TypeMap とその派生 (ext/pg_type_map*.c, lib/pg/type_map*.rb)
+### TypeMap とその派生 (ext/pg_type_map\*.c, lib/pg/type_map\*.rb)
 
-TypeMapはエンコーダーまたはデコーダーのどちらによってどの値を変換するかを定義します。
-様々な型の対応付け戦略があるので、このクラスにはいくつかの派生が実装されています。
-型変換の特有の需要に合わせてそれらの派生から選んで調整を加えることができます。
+PG::TypeMap はどのエンコーダーないしデコーダーによってどの値が変換されるかを定義します。
+様々な型の対応付けの戦略があり、このクラスの複数の派生により実装されています。
+型変換の特有の需要に合わせてそれらから選んで構成できます。
 既定の型の対応付けは PG::TypeMapAllStrings です。
 
-型の対応付けは、結果の集合それぞれに対し、接続毎ないしクエリ毎に割り当てることができます。
+型の対応付けは、結果の集合それぞれに対し、接続毎ないし問い合わせ毎に割り当てることができます。
 型の対応付けはCOPYの入出力データストリーミングでも使うことができます。
 PG::Connection#copy_data を参照してください。
 
@@ -191,12 +241,14 @@ PG::Connection#copy_data を参照してください。
 * PG::BasicTypeMapForQueries - PG::TypeMapByClass
   によくあるRubyの値クラス用にエンコーダーが入った状態になっています
 
+PG::TypeMap::DefaultTypeMappable#default_type_map
+を設定することで複数の型の対応付けを連鎖させられます。
 
 ## スレッド対応
 
-PGには個々のスレッドが別々の PG::Connection オブジェクトを同時に使えるという点でスレッド安全性があります。
-しかし1つ以上のスレッドから同時にPgのオブジェクトにアクセスすると安全ではありません。
-そのため必ず、毎回新しいスレッドを作るときに新しいデータベースサーバー接続を開くか、スレッド安全性のある方法で接続を管理するActiveRecordのようなラッパーライブラリを使うようにしてください。
+PG には個々のスレッドないしファイバが個々の PG::Connection オブジェクトを並行に使えるという点でスレッド安全です。
+しかしながら1つ以上のスレッドないしファイバから同時に何らかの PG のオブジェクトにアクセスするのは安全ではありません。
+そのため必ず、新しいスレッドないしファイバの一つ一つに対して新しいデータベースサーバー接続を開くか、スレッド安全な方法で接続を管理するActiveRecordのようなラッパーライブラリを使ってください。
 
 以下のようなメッセージが標準エラー出力に表示された場合、恐らく複数のスレッドが1つの接続を使っています。
 
@@ -210,13 +262,12 @@ PGには個々のスレッドが別々の PG::Connection オブジェクトを
 ## Fiber IOスケジューラー対応
 
 pg-1.3.0以降で、PgはRuby-3.0で導入された`Fiber.scheduler`に完全に対応しています。
-Windowsでは、`Fiber.scheduler`対応はRuby-3.1以降で使えます。
 `Fiber.scheduler`が走らせているスレッドに登録されている場合、起こりうる全てのブロッキングIO操作はそのスケジューラーを経由します。
 同期的であったりブロックしたりするメソッド呼び出しについてもpgが内部的に非同期のlibpqインターフェースを使っているのはそれが理由です。
 またlibpqの組み込み関数に代えてRubyのDNS解決を使っています。
 
-内部的にPgは常にlibpqのノンブロッキング接続モードを使います。
-それからブロッキングモードで走っているように振舞いますが、もし`Fiber.scheduler`が登録されていれば全てのブロッキングIOはそのスケジューラーを通じてRubyで制御されます。
+内部的に Pg は常にlibpqのノンブロッキング接続モードを使います。
+それからブロッキングモードで走っているように振舞いますが、すべてのブロッキングIOが、可能であれば登録された`Fiber.schedular`を通じて、確実にRubyで制御されます。
 `PG::Connection.setnonblocking(true)`が呼ばれたらノンブロッキング状態が有効になったままになりますが、それ以降のブロッキング状態の制御が無効になるので、呼び出しているプログラムはブロッキング状態を自力で制御しなければなりません。
 
 この規則の1つの例外には、`PG::Connection#lo_create`や外部ライブラリを使う認証メソッド（GSSAPI認証など）のような、大きめのオブジェクト用のメソッドがあります。これらは`Fiber.scheduler`と互換性がないため、ブロッキング状態は登録されたIOスケジューラに渡されません。つまり操作は適切に実行されますが、IO待ち状態に別のIOを扱うFiberから使用を切り替えてくることができなくなります。

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 3.1 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:
@@ -194,18 +237,25 @@ If messages like the following are printed to stderr, you're probably using one
 ## Fiber IO scheduler support
 
 Pg is fully compatible with `Fiber.scheduler` introduced in Ruby-3.0 since pg-1.3.0.
-On Windows support for `Fiber.scheduler` is available on Ruby-3.1 or newer.
 All possibly blocking IO operations are routed through the `Fiber.scheduler` if one is registered for the running thread.
 That is why pg internally uses the asynchronous libpq interface even for synchronous/blocking method calls.
 It also uses Ruby's DNS resolution instead of libpq's builtin functions.
 
 Internally Pg always uses the nonblocking connection mode of libpq.
 It then behaves like running in blocking mode but ensures, that all blocking IO is handled in Ruby through a possibly registered `Fiber.scheduler`.
-When `PG::Connection.setnonblocking(true)` is called then the nonblocking state stays enabled, but the additional handling of blocking states is disabled, so that the calling program has to handle blocking states on its own.
-
-An exception to this rule are the methods for large objects like `PG::Connection#lo_create` and authentication methods using external libraries (like GSSAPI authentication).
-They are not compatible with `Fiber.scheduler`, so that blocking states are not passed to the registered IO scheduler.
-That means the operation will work properly, but IO waiting states can not be used to switch to another Fiber doing IO.
+When `PG::Connection#setnonblocking(true)` is called then the nonblocking state stays enabled, but the additional handling of blocking states is disabled, so that the calling program has to handle blocking states on its own.
+
+There are some exceptions to the `Fiber.scheduler` compatibility, so that blocking states are not passed to the registered IO scheduler.
+That means the operation will work properly, but IO waiting states can not be used to switch to another Fiber doing IO:
+
+* Methods for large objects like `PG::Connection#lo_create`
+* Authentication methods using external libraries (like GSSAPI or LDAP authentication)
+* LDAP lookup of connection parameters: https://www.postgresql.org/docs/current/libpq-ldap.html
+* A connection string/hash with the `service` parameter set but not `host` and `port`.
+  `Thread.scheduler` compatible alternatives are:
+    * Set the service via `PGSERVICE`environment variable
+    * Set the `host` and `port` parameters explicit in the connection string/hash.
+    * Set the `hostaddr` in the service file.
 
 
 ## Ractor support