pg 1.4.6 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c13f68e0e75751b8b4abc7981de62045998fdf4e8685fd90e74bcd609dc85a8
-  data.tar.gz: 33c65915b3c04a9232bacbf39486738e7a3cd033fefd2f2947107fd9a3b70ebc
+  metadata.gz: 012dafe387d9f1fe9444dee7674ff5fdfcebce3b8ca61500b0ccbba847e28721
+  data.tar.gz: 2a3d537246a65cb6c86822296d723154abbab3be71ca772cfa71678535eb3369
 SHA512:
-  metadata.gz: 3d7144fb8feaa713aae83a12f90890d82c554cb26b81e76f245f47f0f99bac8f2a290bdfbf27deb069f6e4852ff692203799f1a9bf5914e616abb4d3037e6b7a
-  data.tar.gz: 06fb1dbe5e4ff3626c4c1fb24ef2862f32c97baa983400585379ffbbde55079fd449c1ae895296947c29a9316bacfa1f8c173059c426aa8659bccdb676c461f7
+  metadata.gz: 9d395a1d05e7bafda559f0a5041579b5d15c7f8b5c50b8ff0e37ae0b577a21e20b0f3471fb874ed23f6101e0fe21591f22efd60c230b59106029d7f1713b3023
+  data.tar.gz: 2456f8130e18b84aebd95aa08254fb79747024ce1e4747237aa36909e3031039fdfede8b315a2ad4b7ab03daf79f067e634336abeb675151e5d9a2950cb7ec13

data/{History.md → CHANGELOG.md}

@@ -1,3 +1,177 @@
+## 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)
+- Remove raising `conect_timeout` from 1 to 2 seconds. [#590](https://github.com/ged/ruby-pg/pull/590)
+- Fix binary copy_data in Ractor context. [#594](https://github.com/ged/ruby-pg/pull/594)
+- Exclude CI files and hidden files from built gem. [#591](https://github.com/ged/ruby-pg/pull/591)
+  This is to simplify security inspection.
+- Update error classes to PostgreSQL-17.
+- Update Windows fat binary gem to OpenSSL-3.4.0 and PostgreSQL-17.0.
+
+
+## v1.5.8 [2024-09-06] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Fix host list duplication every time conn.reset is used. [#586](https://github.com/ged/ruby-pg/pull/586)
+- Add default decoder for anonymous record types to BasicTypeRegistry [#579](https://github.com/ged/ruby-pg/pull/579)
+- Update Windows fat binary gem to OpenSSL-3.3.2 and PostgreSQL-16.4.
+
+
+## v1.5.7 [2024-07-28] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Remove deprecated use of fptr->fd.[#562](https://github.com/ged/ruby-pg/pull/562)
+  Direct access is disallowed since ruby-3.4.
+- Make `pgconn_connect_poll` close the socket prior to calling `PQconnectPoll`. [#564](https://github.com/ged/ruby-pg/pull/564)
+  This could result in an exception while connecting when used multi threaded.
+- Fix several typos and improve spelling in documentation and code. [#566](https://github.com/ged/ruby-pg/pull/566)
+- Add missing PG::RollbackTransaction as an option to exit conn.transaction. [#560](https://github.com/ged/ruby-pg/pull/560)
+  Usage like in rails: https://api.rubyonrails.org/classes/ActiveRecord/Rollback.html
+- Don't print a warning when bigdecimal is required on ruby-3.4+ [#574](https://github.com/ged/ruby-pg/pull/574)
+- Update Windows fat binary gem to OpenSSL-3.3.1 and PostgreSQL-16.3.
+
+
+## v1.5.6 [2024-03-01] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Renew address resolution (DNS) in conn.reset. [#558](https://github.com/ged/ruby-pg/pull/558)
+  This is important, if DNS is used for load balancing, etc.
+- Make bigdecimal an optional dependency. [#556](https://github.com/ged/ruby-pg/pull/556)
+  It's a gem in ruby-3.4+, so that users shouldn't be forced to use it.
+
+
+## v1.5.5 [2024-02-15] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Explicitly retype timespec fields to int64_t to fix compatibility with 32bit arches. [#547](https://github.com/ged/ruby-pg/pull/547)
+- Fix possible buffer overflows in PG::BinaryDecoder::CopyRow on 32 bit systems. [#548](https://github.com/ged/ruby-pg/pull/548)
+- Add binary Windows gems for Ruby 3.3.
+- Update Windows fat binary gem to OpenSSL-3.2.1 and PostgreSQL-16.2.
+
+
+## v1.5.4 [2023-09-01] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Fix compiling the pg extension with MSVC 2022. [#535](https://github.com/ged/ruby-pg/pull/535)
+- Set PG::Connection's encoding even if setting client_encoding on connection startup fails. [#541](https://github.com/ged/ruby-pg/pull/541)
+- Don't set the server's client_encoding if it's unnecessary. [#542](https://github.com/ged/ruby-pg/pull/542)
+  This is important for connection proxies, who disallow configuration settings.
+- Update Windows fat binary gem to OpenSSL-3.1.2 and PostgreSQL-15.4.
+
+
+## v1.5.3 [2023-04-28] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Fix possible segfault when creating a new PG::Result with type map. [#530](https://github.com/ged/ruby-pg/pull/530)
+- Add category to deprecation warnings of Coder.new, so that they are suppressed for most users. [#528](https://github.com/ged/ruby-pg/pull/528)
+
+
+## v1.5.2 [2023-04-26] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Fix regression in copy_data regarding binary format when using no coder. [#527](https://github.com/ged/ruby-pg/pull/527)
+
+
+## v1.5.1 [2023-04-24] Lars Kanis <lars@greiz-reinsdorf.de>
+
+- Don't overwrite flags of timestamp coders. [#524](https://github.com/ged/ruby-pg/pull/524)
+  Fixes a regression in rails: https://github.com/rails/rails/issues/48049
+
+
+## v1.5.0 [2023-04-24] Lars Kanis <lars@greiz-reinsdorf.de>
+
+Enhancements:
+
+- Better support for binary format:
+    - Extend PG::Connection#copy_data to better support binary transfers [#511](https://github.com/ged/ruby-pg/pull/511)
+    - Add binary COPY encoder and decoder:
+        * PG::BinaryEncoder::CopyRow
+        * PG::BinaryDecoder::CopyRow
+    - Add binary timestamp encoders:
+        * PG::BinaryEncoder::TimestampUtc
+        * PG::BinaryEncoder::TimestampLocal
+        * PG::BinaryEncoder::Timestamp
+    - Add PG::BinaryEncoder::Float4 and Float8
+    - Add binary date type: [#515](https://github.com/ged/ruby-pg/pull/515)
+        * PG::BinaryEncoder::Date
+        * PG::BinaryDecoder::Date
+    - Add PG::Result#binary_tuples [#511](https://github.com/ged/ruby-pg/pull/511)
+      It is useful for COPY and not deprecated in that context.
+    - Add PG::TextEncoder::Bytea to BasicTypeRegistry [#506](https://github.com/ged/ruby-pg/pull/506)
+- Ractor support: [#519](https://github.com/ged/ruby-pg/pull/519)
+    - Pg is now fully compatible with Ractor introduced in Ruby-3.0 and doesn't use any global mutable state.
+    - All type en/decoders and type maps are shareable between ractors if they are made frozen by `Ractor.make_shareable`.
+    - Also frozen PG::Result and PG::Tuple objects can be shared.
+    - All frozen objects (except PG::Connection) can still be used to do communication with the PostgreSQL server or to read retrieved data.
+    - PG::Connection is not shareable and must be created within each Ractor to establish a dedicated connection.
+- Use keyword arguments instead of hashes for Coder initialization and #to_h. [#511](https://github.com/ged/ruby-pg/pull/511)
+- Add PG::Result.res_status as a class method and extend Result#res_status to return the status of self. [#508](https://github.com/ged/ruby-pg/pull/508)
+- Reduce the number of files loaded at `require 'pg'` by using autoload. [#513](https://github.com/ged/ruby-pg/pull/513)
+  Previously stdlib libraries `date`, `json`, `ipaddr` and `bigdecimal` were static dependencies, but now only `socket` is mandatory.
+- Improve garbage collector performance by adding write barriers to all PG classes. [#518](https://github.com/ged/ruby-pg/pull/518)
+  Now they can be promoted to the old generation, which means they only get marked on major GC.
+- New method PG::Connection#check_socket to check the socket state. [#521](https://github.com/ged/ruby-pg/pull/521)
+- Mark many internal constants as private. [#522](https://github.com/ged/ruby-pg/pull/522)
+- Update Windows fat binary gem to OpenSSL-3.1.0.
+
+Bugfixes:
+
+- Move nfields-check of stream-methods after result status check [#507](https://github.com/ged/ruby-pg/pull/507)
+  This ensures that the nfield-check doesn't hide errors like statement timeout.
+
+Removed:
+
+- Remove deprecated PG::BasicTypeRegistry.register_type and co. [Part of #519](https://github.com/ged/ruby-pg/commit/2919ee1a0c6b216e18e1d06c95c2616ef69d2f97)
+- Add deprecation warning about PG::Coder initialization per Hash argument. [#514](https://github.com/ged/ruby-pg/pull/514)
+  It is recommended to use keyword arguments instead.
+- The internal encoding cache was removed. [#516](https://github.com/ged/ruby-pg/pull/516)
+  It shouldn't have a practical performance impact.
+
+Repository:
+
+- `rake test` tries to find PostgreSQL server commands by pg_config [#503](https://github.com/ged/ruby-pg/pull/503)
+  So there's no need to set the PATH manually any longer.
+
+
 ## v1.4.6 [2023-02-26] Lars Kanis <lars@greiz-reinsdorf.de>
 
 - Add japanese README file. [#502](https://github.com/ged/ruby-pg/pull/502)
@@ -64,7 +238,7 @@ Added:
 Bugfixes:
 
 - Try IPv6 and IPv4 addresses, if DNS resolves to both. [#452](https://github.com/ged/ruby-pg/pull/452)
-- Re-add block-call semantics to PG::Connection.new accidently removed in pg-1.3.0. [#454](https://github.com/ged/ruby-pg/pull/454)
+- Re-add block-call semantics to PG::Connection.new accidentally removed in pg-1.3.0. [#454](https://github.com/ged/ruby-pg/pull/454)
 - Handle client error after all data consumed in #copy_data for output. [#455](https://github.com/ged/ruby-pg/pull/455)
 - Avoid spurious keyword argument warning on Ruby 2.7. [#456](https://github.com/ged/ruby-pg/pull/456)
 - Change connection setup to respect connect_timeout parameter. [#459](https://github.com/ged/ruby-pg/pull/459)
@@ -103,7 +277,7 @@ Bugfixes:
 
 - Don't leak IO in case of connection errors. [#439](https://github.com/ged/ruby-pg/pull/439)
   Previously it was kept open until the PG::Connection was garbage collected.
-- Fix a performance regession in conn.get_result noticed in single row mode. [#442](https://github.com/ged/ruby-pg/pull/442)
+- Fix a performance regression in conn.get_result noticed in single row mode. [#442](https://github.com/ged/ruby-pg/pull/442)
 - Fix occasional error Errno::EBADF (Bad file descriptor) while connecting. [#444](https://github.com/ged/ruby-pg/pull/444)
 - Fix compatibility of res.stream_each* methods with Fiber.scheduler. [#446](https://github.com/ged/ruby-pg/pull/446)
 - Remove FL_TEST and FL_SET, which are MRI-internal. [#437](https://github.com/ged/ruby-pg/pull/437)
@@ -189,7 +363,7 @@ Type cast enhancements:
 - Add PG::BasicTypeMapForQueries::BinaryData for encoding of bytea columns. [#348](https://github.com/ged/ruby-pg/pull/348)
 - Reduce time to build coder maps and permit to reuse them for several type maps per PG::BasicTypeRegistry::CoderMapsBundle.new(conn) . [#376](https://github.com/ged/ruby-pg/pull/376)
 - Make BasicTypeRegistry a class and use a global default instance of it.
-  Now a local type registry can be instanciated and given to the type map, to avoid changing shared global states.
+  Now a local type registry can be instantiated and given to the type map, to avoid changing shared global states.
 - Allow PG::BasicTypeMapForQueries to take a Proc as callback for undefined types.
 
 Other Enhancements:

data/Gemfile

@@ -5,10 +5,19 @@ gemspec
 
 source "https://rubygems.org/"
 
-group :development, :test do
+group :development do
+  gem "rdoc", "~> 6.4"
+  gem "mini_portile2", "~> 2.1"
+end
+
+group :test do
   gem "bundler", ">= 1.16", "< 3.0"
   gem "rake-compiler", "~> 1.0"
-  gem "rake-compiler-dock", "~> 1.0"
-  gem "rdoc", "~> 6.4"
+  gem "rake-compiler-dock", "~> 1.9.1"
   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.
+  # 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"
 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
 
-* home :: https://github.com/ged/ruby-pg
-* docs :: http://deveiate.org/code/pg
-* clog :: link:/History.md
+* ホーム :: https://github.com/ged/ruby-pg
+* ドキュメント :: http://deveiate.org/code/pg （英語）、 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
@@ -41,8 +41,8 @@ Actionsのビルド状況](https://github.com/ged/ruby-pg/actions/workflows/sour
 
 ## 要件
 
-* Ruby 2.4かそれより新しいバージョン
-* PostgreSQL 9.3.xかそれ以降のバージョン（ヘッダー付属のもの、例えば-devの名前のパッケージ）。
+* Ruby 2.7かそれより新しいバージョン
+* PostgreSQL 10.xかそれ以降のバージョン（ヘッダー付属のもの、例えば-devの名前のパッケージ）。
 
 それより前のバージョンのRubyやPostgreSQLでも通常は同様に動作しますが、定期的なテストはされていません。
 
@@ -83,8 +83,9 @@ README-Windows.rdoc を参照してください。
 
 ## 型変換
 
-PgにはおまけとしてRubyとネイティブCコードにある結果の値やクエリ引数の型変換ができます。
-こうすることでデータベースとのデータの往来を加速させられますが、それは文字列のアロケーションが減り、（より遅い）Rubyのコードでの変換部分が除かれるからです。
+Pgでは任意でRubyと素のCコードにある結果の値やクエリ引数の型変換ができます。
+こうすることでデータベースとのデータの往来を加速させられます。
+なぜなら文字列のアロケーションが減り、（比較的遅い）Rubyのコードでの変換部分が省かれるからです。
 
 とても基本的な型変換は次のようにできます。
 ```ruby
@@ -103,9 +104,13 @@ PgにはおまけとしてRubyとネイティブCコードにある結果の値
 
 ### エンコーダーとデコーダー (ext/pg_*coder.c, lib/pg/*coder.rb)
 
-こちらはより低層で、DBMSへ転送するためにRubyのオブジェクトを変換するエンコーディングクラスと取得してきたデータをRubyのオブジェクトに変換し戻すデコーディングクラスが含まれています。クラスはそれぞれの形式によって名前空間PG::TextEncoder、PG::TextDecoder、PG::BinaryEncoder、そしてPG::BinaryDecoderに分かれています。
+こちらはより低層で、DBMSへ転送するためにRubyのオブジェクトを変換するエンコーディングクラスと、取得してきたデータをRubyのオブジェクトに変換し戻すデコーディングクラスが含まれています。
+クラスはそれぞれの形式によって名前空間 PG::TextEncoder, PG::TextDecoder, PG::BinaryEncoder, そして
+PG::BinaryDecoder に分かれています。
 
-エンコーダーないしデコーダーオブジェクトにOIDデータ型や形式コード（テキストないしバイナリ）や任意で名前を割り当てることができます。要素のエンコーダーないしデコーダーを割り当てることによって複合型を構築することもできます。PG::CoderオブジェクトはPG::TypeMapをセットアップしたりその代わりに単一の値と文字列表現とを相互に変換したりするのに使えます。
+エンコーダーないしデコーダーオブジェクトにOIDデータ型や形式コード（テキストないしバイナリ）や任意で名前を割り当てることができます。
+要素のエンコーダーないしデコーダーを割り当てることによって複合型を構築することもできます。
+PG::Coder オブジェクトは PG::TypeMap をセットアップしたり、その代わりに単一の値と文字列表現とを相互に変換したりするのに使えます。
 
 ruby-pgでは以下のPostgreSQLカラム型に対応しています（TE = Text Encoder、TD = Text Decoder、BE =
 Binary Encoder、BD = Binary Decoder）。
@@ -115,10 +120,12 @@ Binary Encoder、BD = Binary Decoder）。
   💡
   リンクがないでしょうか。[こちら](https://deveiate.org/code/pg/README_ja_md.html#label-E5-9E-8B-E5-A4-89-E6-8F-9B)を代わりに見てください
   💡
-  * BE:
-    [Int2](rdoc-ref:PG::BinaryEncoder::Int2)、[Int4](rdoc-ref:PG::BinaryEncoder::Int4)、[Int8](rdoc-ref:PG::BinaryEncoder::Int8)
+    * BE:
+      [Int2](rdoc-ref:PG::BinaryEncoder::Int2)、[Int4](rdoc-ref:PG::BinaryEncoder::Int4)、[Int8](rdoc-ref:PG::BinaryEncoder::Int8)
 * Float:
   [TE](rdoc-ref:PG::TextEncoder::Float)、[TD](rdoc-ref:PG::TextDecoder::Float)、[BD](rdoc-ref:PG::BinaryDecoder::Float)
+    * BE: [Float4](rdoc-ref:PG::BinaryEncoder::Float4),
+      [Float8](rdoc-ref:PG::BinaryEncoder::Float8)
 * Numeric:
   [TE](rdoc-ref:PG::TextEncoder::Numeric)、[TD](rdoc-ref:PG::TextDecoder::Numeric)
 * Boolean:
@@ -130,14 +137,15 @@ Binary Encoder、BD = Binary Decoder）。
 * Base64:
   [TE](rdoc-ref:PG::TextEncoder::ToBase64)、[TD](rdoc-ref:PG::TextDecoder::FromBase64)、[BE](rdoc-ref:PG::BinaryEncoder::FromBase64)、[BD](rdoc-ref:PG::BinaryDecoder::ToBase64)
 * Timestamp:
-  * TE:
-    [現地時間](rdoc-ref:PG::TextEncoder::TimestampWithoutTimeZone)、[UTC](rdoc-ref:PG::TextEncoder::TimestampUtc)、[タイムゾーン付き](rdoc-ref:PG::TextEncoder::TimestampWithTimeZone)
-  * TD:
-    [現地時間](rdoc-ref:PG::TextDecoder::TimestampLocal)、[UTC](rdoc-ref:PG::TextDecoder::TimestampUtc)、[UTCから現地時間へ](rdoc-ref:PG::TextDecoder::TimestampUtcToLocal)
-  * BD:
-    [現地時間](rdoc-ref:PG::BinaryDecoder::TimestampLocal)、[UTC](rdoc-ref:PG::BinaryDecoder::TimestampUtc)、[UTCから現地時間へ](rdoc-ref:PG::BinaryDecoder::TimestampUtcToLocal)
-* Date:
-  [TE](rdoc-ref:PG::TextEncoder::Date)、[TD](rdoc-ref:PG::TextDecoder::Date)
+    * TE:
+      [現地時間](rdoc-ref:PG::TextEncoder::TimestampWithoutTimeZone)、[UTC](rdoc-ref:PG::TextEncoder::TimestampUtc)、[タイムゾーン付き](rdoc-ref:PG::TextEncoder::TimestampWithTimeZone)
+    * TD:
+      [現地時間](rdoc-ref:PG::TextDecoder::TimestampLocal)、[UTC](rdoc-ref:PG::TextDecoder::TimestampUtc)、[UTCから現地時間へ](rdoc-ref:PG::TextDecoder::TimestampUtcToLocal)
+    * BE:
+      [現地時間](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)
 * JSONとJSONB:
   [TE](rdoc-ref:PG::TextEncoder::JSON)、[TD](rdoc-ref:PG::TextDecoder::JSON)
 * Inet:
@@ -146,18 +154,25 @@ Binary Encoder、BD = Binary Decoder）。
   [TE](rdoc-ref:PG::TextEncoder::Array)、[TD](rdoc-ref:PG::TextDecoder::Array)
 * 複合型（「行」や「レコード」などとも言います）：[TE](rdoc-ref:PG::TextEncoder::Record)、[TD](rdoc-ref:PG::TextDecoder::Record)
 
-カラム型として使われていませんが以下のテキスト形式もエンコードできます。
+カラム型として使われていませんが、以下のテキスト形式とバイナリ形式もエンコードできます。
 
-* COPYの入出力データ：[TE](rdoc-ref:PG::TextEncoder::CopyRow)、[TD](rdoc-ref:PG::TextDecoder::CopyRow)
+* COPYの入出力データ：[TE](rdoc-ref:PG::TextEncoder::CopyRow)、[TD](rdoc-ref:PG::TextDecoder::CopyRow),
+  [BE](rdoc-ref:PG::BinaryEncoder::CopyRow),
+  [BD](rdoc-ref:PG::BinaryDecoder::CopyRow)
 * SQL文字列に挿入するリテラル：[TE](rdoc-ref:PG::TextEncoder::QuotedLiteral)
 * 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)
+### PG::TypeMap とその派生 (ext/pg_type_map*.c, lib/pg/type_map*.rb)
 
-TypeMapはエンコーダーまたはデコーダーのどちらによってどの値を変換するかを定義します。様々な型の対応付け戦略があるので、このクラスにはいくつかの派生が実装されています。型変換の特有の需要に合わせてそれらの派生から選んで調整を加えることができます。既定の型の対応付けはPG::TypeMapAllStringsです。
+TypeMapはエンコーダーまたはデコーダーのどちらによってどの値を変換するかを定義します。
+様々な型の対応付け戦略があるので、このクラスにはいくつかの派生が実装されています。
+型変換の特有の需要に合わせてそれらの派生から選んで調整を加えることができます。
+既定の型の対応付けは PG::TypeMapAllStrings です。
 
-型の対応付けは、結果の集合それぞれに対し、接続毎ないしクエリ毎に割り当てることができます。型の対応付けはCOPYの入出力データストリーミングでも使うことができます。PG::Connection#copy_dataを参照してください。
+型の対応付けは、結果の集合それぞれに対し、接続毎ないしクエリ毎に割り当てることができます。
+型の対応付けはCOPYの入出力データストリーミングでも使うことができます。
+PG::Connection#copy_data を参照してください。
 
 以下の基底となる型の対応付けが使えます。
 
@@ -167,19 +182,21 @@ TypeMapはエンコーダーまたはデコーダーのどちらによってど
 * PG::TypeMapByOid - PostgreSQLのOIDデータ型によってデコーダーを選択します
 * PG::TypeMapInRuby - Rubyで独自の型の対応付けを定義します
 
-以下の型の対応付けはPG::BasicTypeRegistry由来の型の対応付けが入った状態になっています。
+以下の型の対応付けは PG::BasicTypeRegistry 由来の型の対応付けが入った状態になっています。
 
-* PG::BasicTypeMapForResults -
-  PG::TypeMapByOidによくあるPostgreSQLカラム型用にデコーダーが入った状態になっています
-* PG::BasicTypeMapBasedOnResult -
-  PG::TypeMapByOidによくあるPostgreSQLカラム型用のエンコーダーが入った状態になっています
-* PG::BasicTypeMapForQueries -
-  PG::TypeMapByClassによくあるRubyの値クラス用にエンコーダーが入った状態になっています
+* PG::BasicTypeMapForResults - PG::TypeMapByOid
+  によくあるPostgreSQLカラム型用にデコーダーが入った状態になっています
+* PG::BasicTypeMapBasedOnResult - PG::TypeMapByOid
+  によくあるPostgreSQLカラム型用のエンコーダーが入った状態になっています
+* PG::BasicTypeMapForQueries - PG::TypeMapByClass
+  によくあるRubyの値クラス用にエンコーダーが入った状態になっています
 
 
 ## スレッド対応
 
-PGには個々のスレッドが別々のPG::Connectionオブジェクトを同時に使えるという点でスレッド安全性があります。しかし1つ以上のスレッドから同時にPgのオブジェクトにアクセスすると安全ではありません。そのため必ず、毎回新しいスレッドを作るときに新しいデータベースサーバー接続を開くか、スレッド安全性のある方法で接続を管理するActiveRecordのようなラッパーライブラリを使うようにしてください。
+PGには個々のスレッドが別々の PG::Connection オブジェクトを同時に使えるという点でスレッド安全性があります。
+しかし1つ以上のスレッドから同時にPgのオブジェクトにアクセスすると安全ではありません。
+そのため必ず、毎回新しいスレッドを作るときに新しいデータベースサーバー接続を開くか、スレッド安全性のある方法で接続を管理するActiveRecordのようなラッパーライブラリを使うようにしてください。
 
 以下のようなメッセージが標準エラー出力に表示された場合、恐らく複数のスレッドが1つの接続を使っています。
 
@@ -192,13 +209,30 @@ PGには個々のスレッドが別々のPG::Connectionオブジェクトを同
 
 ## Fiber IOスケジューラー対応
 
-PgはRuby-3.0で導入された`Fiber.scheduler`に完全に対応しています。`Fiber.scheduler`のWindows対応についてはRuby-3.1以降で使えます。`Fiber.scheduler`が走らせているスレッドに登録されている場合、起こりうる全てのブロッキングIO操作はそのスケジューラーを経由します。同期的であったりブロックしたりするメソッド呼び出しについてもpgが内部的に非同期のlibpqインターフェースを使っているのはそれが理由です。またlibpqの組み込み関数に代えてRubyのDNS解決を使っています。
+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::Connection.setnonblocking(true)`が呼ばれたらノンブロッキング状態が有効になったままになりますが、それ以降のブロッキング状態の制御が無効になるので、呼び出しているプログラムはブロッキング状態を自力で制御しなければなりません。
+内部的にPgは常にlibpqのノンブロッキング接続モードを使います。
+それからブロッキングモードで走っているように振舞いますが、もし`Fiber.scheduler`が登録されていれば全てのブロッキングIOはそのスケジューラーを通じてRubyで制御されます。
+`PG::Connection.setnonblocking(true)`が呼ばれたらノンブロッキング状態が有効になったままになりますが、それ以降のブロッキング状態の制御が無効になるので、呼び出しているプログラムはブロッキング状態を自力で制御しなければなりません。
 
 この規則の1つの例外には、`PG::Connection#lo_create`や外部ライブラリを使う認証メソッド（GSSAPI認証など）のような、大きめのオブジェクト用のメソッドがあります。これらは`Fiber.scheduler`と互換性がないため、ブロッキング状態は登録されたIOスケジューラに渡されません。つまり操作は適切に実行されますが、IO待ち状態に別のIOを扱うFiberから使用を切り替えてくることができなくなります。
 
 
+## Ractor対応
+
+pg-1.5.0以降で、PgはRuby-3.0で導入されたRactorと完全な互換性があります。
+型エンコーダーないしデコーダー、及び型の対応付けが`Ractor.make_shareable`により凍結されている場合、これらをractor間で共有できます。
+また凍結された PG::Result と PG::Tuple オブジェクトも共有できます。
+少なくとも全ての凍結されたオブジェクト（ただし PG::Connection
+を除く）はPostgreSQLサーバーとのやり取りをしたり取得されたデータを読むのに使えます。
+
+PG::Connection は共有できません。個々の接続を確立するために、それぞれのRactor内で作られなければなりません。
+
+
 ## 貢献
 
 バグを報告したり機能を提案したりGitでソースをチェックアウトしたりするには[プロジェクトページをご確認ください](https://github.com/ged/ruby-pg)。
@@ -207,7 +241,7 @@ PgはRuby-3.0で導入された`Fiber.scheduler`に完全に対応していま
 
     $ bundle install
 
-拡張ファイル、パッケージファイル、テストデータベースを一掃するには次のようにします。
+拡張ファイル、パッケージファイル、テストデータベースを一掃するには、このコマンドを走らせてください。PostgreSQLのバージョンも切り替わります。
 
     $ rake clean
 
@@ -215,13 +249,13 @@ PgはRuby-3.0で導入された`Fiber.scheduler`に完全に対応していま
 
     $ rake compile
 
-パスにある`initdb`といったPostgreSQLのツールを使ってテストやスペックを走らせるには次のようにします。
+`pg_config --bindir`が指すPostgreSQLのバージョンでテストやスペックを走らせるには次のようにします。
 
-    $ PATH=$PATH:/usr/lib/postgresql/14/bin rake test
+    $ rake test
 
-あるいは行番号を使って特定のテストを走らせるには次のようにします。
+あるいは特定のPostgreSQLのバージョンで、ファイル中の行番号を使って特定のテストを走らせるには次のようにします。
 
-    $ PATH=$PATH:/usr/lib/postgresql/14/bin rspec -Ilib -fd spec/pg/connection_spec.rb:455
+    $ PATH=/usr/lib/postgresql/14/bin:$PATH rspec -Ilib -fd spec/pg/connection_spec.rb:455
 
 APIドキュメントを生成するには次のようにします。
 
@@ -261,6 +295,6 @@ Portions copyright LAIKA, Inc.
 
 ## 謝辞
 
-長年にわたって貢献してくださった方々についてはContributors.rdocを参照してください。
+長年にわたって貢献してくださった方々については Contributors.rdoc を参照してください。
 
 ruby-listとruby-devメーリングリストの方々に感謝します。またPostgreSQLを開発された方々へも謝意を表します。

data/README.md

@@ -1,8 +1,9 @@
 # pg
 
 * home :: https://github.com/ged/ruby-pg
-* docs :: http://deveiate.org/code/pg
-* clog :: link:/History.md
+* docs :: http://deveiate.org/code/pg (English) ,
+          https://deveiate.org/code/pg/README_ja_md.html (Japanese)
+* 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)
 
@@ -10,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
@@ -38,8 +39,8 @@ A small example usage:
 
 ## Requirements
 
-* Ruby 2.4 or newer
-* PostgreSQL 9.3.x or later (with headers, -dev packages, etc).
+* Ruby 2.7 or newer
+* PostgreSQL 10.x or later (with headers, -dev packages, etc).
 
 It usually works with earlier versions of Ruby/PostgreSQL as well, but those are
 not regularly tested.
@@ -124,26 +125,28 @@ to convert single values to/from their string representation.
 The following PostgreSQL column types are supported by ruby-pg (TE = Text Encoder, TD = Text Decoder, BE = Binary Encoder, BD = Binary Decoder):
 
 * Integer: [TE](rdoc-ref:PG::TextEncoder::Integer), [TD](rdoc-ref:PG::TextDecoder::Integer), [BD](rdoc-ref:PG::BinaryDecoder::Integer) 💡 No links? Switch to [here](https://deveiate.org/code/pg/README_md.html#label-Type+Casts) 💡
-  * BE: [Int2](rdoc-ref:PG::BinaryEncoder::Int2), [Int4](rdoc-ref:PG::BinaryEncoder::Int4), [Int8](rdoc-ref:PG::BinaryEncoder::Int8)
+    * BE: [Int2](rdoc-ref:PG::BinaryEncoder::Int2), [Int4](rdoc-ref:PG::BinaryEncoder::Int4), [Int8](rdoc-ref:PG::BinaryEncoder::Int8)
 * Float: [TE](rdoc-ref:PG::TextEncoder::Float), [TD](rdoc-ref:PG::TextDecoder::Float), [BD](rdoc-ref:PG::BinaryDecoder::Float)
+    * BE: [Float4](rdoc-ref:PG::BinaryEncoder::Float4), [Float8](rdoc-ref:PG::BinaryEncoder::Float8)
 * Numeric: [TE](rdoc-ref:PG::TextEncoder::Numeric), [TD](rdoc-ref:PG::TextDecoder::Numeric)
 * Boolean: [TE](rdoc-ref:PG::TextEncoder::Boolean), [TD](rdoc-ref:PG::TextDecoder::Boolean), [BE](rdoc-ref:PG::BinaryEncoder::Boolean), [BD](rdoc-ref:PG::BinaryDecoder::Boolean)
 * String: [TE](rdoc-ref:PG::TextEncoder::String), [TD](rdoc-ref:PG::TextDecoder::String), [BE](rdoc-ref:PG::BinaryEncoder::String), [BD](rdoc-ref:PG::BinaryDecoder::String)
 * Bytea: [TE](rdoc-ref:PG::TextEncoder::Bytea), [TD](rdoc-ref:PG::TextDecoder::Bytea), [BE](rdoc-ref:PG::BinaryEncoder::Bytea), [BD](rdoc-ref:PG::BinaryDecoder::Bytea)
 * Base64: [TE](rdoc-ref:PG::TextEncoder::ToBase64), [TD](rdoc-ref:PG::TextDecoder::FromBase64), [BE](rdoc-ref:PG::BinaryEncoder::FromBase64), [BD](rdoc-ref:PG::BinaryDecoder::ToBase64)
 * Timestamp:
-  * TE: [local](rdoc-ref:PG::TextEncoder::TimestampWithoutTimeZone), [UTC](rdoc-ref:PG::TextEncoder::TimestampUtc), [with-TZ](rdoc-ref:PG::TextEncoder::TimestampWithTimeZone)
-  * TD: [local](rdoc-ref:PG::TextDecoder::TimestampLocal), [UTC](rdoc-ref:PG::TextDecoder::TimestampUtc), [UTC-to-local](rdoc-ref:PG::TextDecoder::TimestampUtcToLocal)
-  * BD: [local](rdoc-ref:PG::BinaryDecoder::TimestampLocal), [UTC](rdoc-ref:PG::BinaryDecoder::TimestampUtc), [UTC-to-local](rdoc-ref:PG::BinaryDecoder::TimestampUtcToLocal)
-* Date: [TE](rdoc-ref:PG::TextEncoder::Date), [TD](rdoc-ref:PG::TextDecoder::Date)
+    * TE: [local](rdoc-ref:PG::TextEncoder::TimestampWithoutTimeZone), [UTC](rdoc-ref:PG::TextEncoder::TimestampUtc), [with-TZ](rdoc-ref:PG::TextEncoder::TimestampWithTimeZone)
+    * TD: [local](rdoc-ref:PG::TextDecoder::TimestampLocal), [UTC](rdoc-ref:PG::TextDecoder::TimestampUtc), [UTC-to-local](rdoc-ref:PG::TextDecoder::TimestampUtcToLocal)
+    * BE: [local](rdoc-ref:PG::BinaryEncoder::TimestampLocal), [UTC](rdoc-ref:PG::BinaryEncoder::TimestampUtc)
+    * BD: [local](rdoc-ref:PG::BinaryDecoder::TimestampLocal), [UTC](rdoc-ref:PG::BinaryDecoder::TimestampUtc), [UTC-to-local](rdoc-ref:PG::BinaryDecoder::TimestampUtcToLocal)
+* 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 formats can also be encoded although they are not used as column type:
+The following text and binary formats can also be encoded although they are not used as column type:
 
-* COPY input and output data: [TE](rdoc-ref:PG::TextEncoder::CopyRow), [TD](rdoc-ref:PG::TextDecoder::CopyRow)
+* COPY input and output data: [TE](rdoc-ref:PG::TextEncoder::CopyRow), [TD](rdoc-ref:PG::TextDecoder::CopyRow), [BE](rdoc-ref:PG::BinaryEncoder::CopyRow), [BD](rdoc-ref:PG::BinaryDecoder::CopyRow)
 * 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)
 
@@ -172,6 +175,7 @@ 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
 
@@ -190,7 +194,7 @@ 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.
+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.
@@ -205,6 +209,16 @@ They are not compatible with `Fiber.scheduler`, so that blocking states are not
 That means the operation will work properly, but IO waiting states can not be used to switch to another Fiber doing IO.
 
 
+## Ractor support
+
+Pg is fully compatible with Ractor introduced in Ruby-3.0 since pg-1.5.0.
+All type en/decoders and type maps are shareable between ractors if they are made frozen by `Ractor.make_shareable`.
+Also frozen PG::Result and PG::Tuple objects can be shared.
+All frozen objects (except PG::Connection) can still be used to do communication with the PostgreSQL server or to read retrieved data.
+
+PG::Connection is not shareable and must be created within each Ractor to establish a dedicated connection.
+
+
 ## Contributing
 
 To report bugs, suggest features, or check out the source with Git,
@@ -214,7 +228,8 @@ After checking out the source, install all dependencies:
 
     $ bundle install
 
-Cleanup extension files, packaging files, test databases:
+Cleanup extension files, packaging files, test databases.
+Run this to change between PostgreSQL versions:
 
     $ rake clean
 
@@ -222,13 +237,13 @@ Compile extension:
 
     $ rake compile
 
-Run tests/specs with PostgreSQL tools like `initdb` in the path:
+Run tests/specs on the PostgreSQL version that `pg_config --bindir` points to:
 
-    $ PATH=$PATH:/usr/lib/postgresql/14/bin rake test
+    $ rake test
 
-Or run a specific test with the line number:
+Or run a specific test per file and line number on a specific PostgreSQL version:
 
-    $ PATH=$PATH:/usr/lib/postgresql/14/bin rspec -Ilib -fd spec/pg/connection_spec.rb:455
+    $ PATH=/usr/lib/postgresql/14/bin:$PATH rspec -Ilib -fd spec/pg/connection_spec.rb:455
 
 Generate the API documentation: