pgmq-ruby 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee008476f444de984ef7413b21bee87043d9e5e87a7eabf85a934cf74b147225
-  data.tar.gz: 1dd10b9b77c9dc4109f6a8e779c970fc6f7ee2e4880cecb467ab3060ecc4f571
+  metadata.gz: 3b279a0ca02d6b0970b00c829df9201f746bc112157d9b782308bbdf2238daae
+  data.tar.gz: b3d46c1e884ff4e362a15c3384f8b0cc1515f16fdc1806606376fbd855011087
 SHA512:
-  metadata.gz: 32cc154c5df5d6501de5bf93daf32857448645b9fe5071bec84b51dbda86cf0efd1fe6cddfd24707fda8201e7d6b8fb10c02f3c7e2bf108226b50a4cbe1b65fd
-  data.tar.gz: ad2630d6736bc49490ccb2eec83da4878dd4b349e9e06cd12f5d9f62a10109922a379c0dab43aa5a0c8a3f33241ca71f6c6ba24386cc6a7cf097db1397ef2518
+  metadata.gz: 9c8b865a9296430fe93b3ab7e7a8fb89857370cd29c8288cd61f8ccc5ddf4ef7a192070e1479079dd8920361997911595c6b2fc7b3239b0d69aee161680c272e
+  data.tar.gz: 92ac6cf951476851bb442d10497317f53496594fd4da05171b0fab0f2e9191a6e5d0251cd5154025501dbac1b802175050b5d9eb712e4dac8f3b9f7ba839a305

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.7.1 (2026-07-09)
+
+### Connection Pool
+- **[Feature]** Add `PGMQ::Connection#reload` (and `PGMQ::Client#reload`, which delegates to it). It drops every
+  connection currently in the pool and lets the pool rebuild fresh ones lazily on the next checkout — unlike `#close`,
+  which shuts the pool down permanently. Use it to recover from a connection that libpq still reports as
+  `CONNECTION_OK` but is in fact wedged, e.g. after a wall-clock `Timeout.timeout` interrupted a query mid-flight and
+  left the socket poisoned so it re-hangs on reuse. `#verify_connection!` cannot catch that case (the connection does
+  not report `CONNECTION_BAD`), so the caller must discard it explicitly; `reload` is the safe, pool-wide way to do so.
+  Connections it drops are closed. Implemented via `ConnectionPool#reload`.
+
 ## 0.7.0 (2026-06-15)
 
 ### Queue Naming

data/lib/pgmq/client.rb

@@ -84,6 +84,17 @@ module PGMQ
       @connection.close
     end
 
+    # Drops every pooled connection and rebuilds lazily on the next checkout,
+    # leaving the pool usable (unlike {#close}). Use it to discard a connection
+    # that reports +CONNECTION_OK+ but is actually wedged — e.g. after a
+    # wall-clock timeout interrupted a query mid-flight and left the socket
+    # poisoned so it would re-hang on reuse. See {PGMQ::Connection#reload}.
+    #
+    # @return [void]
+    def reload
+      @connection.reload
+    end
+
     # Returns connection pool statistics
     #
     # @return [Hash] statistics about the connection pool

data/lib/pgmq/connection.rb

@@ -178,6 +178,29 @@ module PGMQ
       @pool.shutdown { |conn| conn.close unless conn.finished? }
     end
 
+    # Drops every connection currently in the pool and lets the pool build fresh
+    # ones lazily on the next checkout. Unlike {#close} (which shuts the pool
+    # down permanently), the pool stays usable afterwards.
+    #
+    # Use this to recover from a connection that libpq still reports as
+    # +CONNECTION_OK+ but which is in fact wedged — e.g. after a wall-clock
+    # timeout (+Timeout.timeout+) interrupted a query mid-flight, leaving the
+    # socket poisoned so it re-hangs on reuse. {#verify_connection!} cannot catch
+    # that case (the connection does not report +CONNECTION_BAD+), so the caller
+    # must discard it explicitly; +reload+ is the safe, pool-wide way to do so.
+    #
+    # @return [void]
+    # @example Discard the pool after a query had to be force-interrupted
+    #   begin
+    #     Timeout.timeout(5) { connection.with_connection { |conn| conn.exec("SELECT ...") } }
+    #   rescue Timeout::Error
+    #     connection.reload # drop the possibly-poisoned pooled connections
+    #     raise
+    #   end
+    def reload
+      @pool.reload { |conn| conn.close unless conn.finished? }
+    end
+
     # Returns connection pool statistics
     #
     # @return [Hash] statistics about the connection pool

data/lib/pgmq/version.rb

@@ -2,5 +2,5 @@
 
 module PGMQ
   # Current version of the pgmq-ruby gem
-  VERSION = "0.7.0"
+  VERSION = "0.7.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgmq-ruby
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Maciej Mensfeld