ch_connect 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 200d184420e49176978c3e733563dee1bce43abd3ae68ec00c8d8dedba2a3d93
-  data.tar.gz: 701d1c607774c4751b78e7abe8deb8f0927ae671887159e2aba4f5386568a63c
+  metadata.gz: 1975451cfb97c84b89c7153fcd18a8057477ea5fd3a13a21a0b11463343b124a
+  data.tar.gz: e5182056af628032f2faf8b8f17732870d8c89e6d16fdddc1ccbf70742cfc649
 SHA512:
-  metadata.gz: 544a541108591c31bbff5381d73b3659f278013f29bd380b25b056fe9a2066402691a70d4fd705dd35513fa425b4267e35d3e8be06885a5e10ec7d5ed9a81701
-  data.tar.gz: 6d1ca3c49203d5c7eea71886aba4dfa70447fa1adbad832fd6b9736a6ffad4a02a58f425c56921a1e1b109a1a879de4178889fa1c33c04beeb7cb01830fcd57f
+  metadata.gz: 64540c1ebc919c74a9f69c738fa47d8d81eab54b39e4b862a3b9651aa0763563cd6cc362739008a7e1020fb0c608f902fcd97e56fd60971b3661d2525958cc33
+  data.tar.gz: 2d064557ed0ce3c84e3e9b0f2ad27b1d05c660d3312842d6ece5ce6e3a56329d08829bd4abdeda06cc2fa4570d86b2ccd7eefcec91037c699387bb60de6a4ebb

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## Unreleased
 
+## [0.2.2] - 2026-05-06
+
+- Added configurable `keep_alive_timeout` for idle persistent connections (default: 8s) ([#7](https://github.com/kukicola/ch_connect/pull/7))
+
+## [0.2.1] - 2026-02-08
+
+- Added automatic retries on connection errors with configurable `max_retries` (default: 3) ([#6](https://github.com/kukicola/ch_connect/pull/6))
+
 ## [0.2.0] - 2026-01-31
 
 - Added benchmark suite comparing against other ClickHouse Ruby gems ([#5](https://github.com/kukicola/ch_connect/pull/5))

data/README.md

@@ -8,6 +8,7 @@ Fast Ruby client for ClickHouse database using the Native binary format for effi
 
 - Native binary format parsing (faster than JSON/TSV)
 - Persistent HTTP connections with built-in connection pooling
+- Automatic retries on connection errors
 - Thread-safe concurrent access
 - Supports all common ClickHouse data types
 
@@ -176,8 +177,10 @@ response = conn.query(
 | `connection_timeout` | `5` | Connection timeout in seconds |
 | `read_timeout` | `60` | Read timeout in seconds |
 | `write_timeout` | `60` | Write timeout in seconds |
+| `keep_alive_timeout` | `8` | Idle persistent connection timeout in seconds |
 | `pool_size` | `100` | Connection pool size |
 | `pool_timeout` | `5` | Pool checkout timeout in seconds |
+| `max_retries` | `3` | Max retry attempts on connection errors (0 to disable) |
 | `instrumenter` | `NullInstrumenter` | Instrumenter for query instrumentation |
 
 ## Instrumentation

data/lib/ch_connect/config.rb

@@ -22,8 +22,10 @@ module ChConnect
       connection_timeout: 5,
       read_timeout: 60,
       write_timeout: 60,
+      keep_alive_timeout: 8,
       pool_size: 100,
       pool_timeout: 5,
+      max_retries: 3,
       instrumenter: NullInstrumenter.new
     }.freeze
 
@@ -36,10 +38,12 @@ module ChConnect
     # @return [Integer] Connection timeout in seconds
     # @return [Integer] Read timeout in seconds
     # @return [Integer] Write timeout in seconds
+    # @return [Integer] Keep-alive timeout for idle persistent connections in seconds
     # @return [Integer] Connection pool size
     # @return [Integer] Pool checkout timeout in seconds
+    # @return [Integer] Max retry attempts on connection errors
     # @return [#instrument] Instrumenter for query instrumentation
-    attr_accessor :scheme, :host, :port, :database, :username, :password, :connection_timeout, :read_timeout, :write_timeout, :pool_size, :pool_timeout, :instrumenter
+    attr_accessor :scheme, :host, :port, :database, :username, :password, :connection_timeout, :read_timeout, :write_timeout, :keep_alive_timeout, :pool_size, :pool_timeout, :max_retries, :instrumenter
 
     # Creates a new configuration instance.
     #
@@ -53,8 +57,10 @@ module ChConnect
     # @option params [Integer] :connection_timeout connection timeout in seconds (default: 5)
     # @option params [Integer] :read_timeout read timeout in seconds (default: 60)
     # @option params [Integer] :write_timeout write timeout in seconds (default: 60)
+    # @option params [Integer] :keep_alive_timeout idle persistent connection timeout in seconds (default: 8)
     # @option params [Integer] :pool_size connection pool size (default: 100)
     # @option params [Integer] :pool_timeout pool checkout timeout (default: 5)
+    # @option params [Integer] :max_retries max retry attempts on connection errors (default: 3)
     def initialize(params = {})
       DEFAULTS.merge(params).each do |key, value|
         send("#{key}=", value)

data/lib/ch_connect/http_transport.rb

@@ -14,11 +14,13 @@ module ChConnect
       @config = config
       @base_url = "#{config.scheme}://#{config.host}:#{config.port}"
       @http_client = HTTPX.plugin(:persistent, close_on_fork: true)
+        .plugin(:retries, max_retries: config.max_retries, retry_change_requests: true)
         .with(
           timeout: {
             connect_timeout: config.connection_timeout,
             read_timeout: config.read_timeout,
-            write_timeout: config.write_timeout
+            write_timeout: config.write_timeout,
+            keep_alive_timeout: config.keep_alive_timeout
           },
           pool_options: {
             max_connections_per_origin: config.pool_size,

data/lib/ch_connect/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ChConnect
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ch_connect
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Karol Bąk