trino-client 2.2.1 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a44518a87285ae0051f9543aa73cb869a5d34c355adea490ee43107a88476e56
-  data.tar.gz: 28a0d53b23d0a74a165e1c83d5c9cfbe87fe926d885c0f5eb8161d7c39c1fa8d
+  metadata.gz: 1c843bb17e992cc4b85e75d9c42b1d28defaab68b26226bd3f5157c9d3f66904
+  data.tar.gz: ade30ecd070ae456b719d3339bde72fd3e869a939f1a51dca5044015fd999f43
 SHA512:
-  metadata.gz: 39630d06e5b300f764c1b861a488c63bbe7c465eee0dc0d8b1979904194429a33c2685a67e47c4c81904fd39e604aa4ed2e4ec93263594f872b924061ad543e3
-  data.tar.gz: 77c635eed6243bdb7eaccace39a2aee3e22fe8c0654b514644f1acb7d374fb365de7c4920daa72e1a647aa3b4406388ab6b59ef5900f5e4d7807053dc081c2c1
+  metadata.gz: 054b13b290fb880b8813a04803fd51d9d131ad225ed496b2fdc9df1c7441314692d6d52809fa3bfcafdb15dbebeebcfa94472e6dacbc4358ecc704c7264d8fed
+  data.tar.gz: 03674c67087e069bbf0976f612260da62987d394fa262d717a5f11dd1677f7e1fd4b326cc6609e0c9676e953052435516114199f4d09c2276955a37dc440e20d

data/.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+---
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: check-json
+      - id: check-case-conflict
+      - id: mixed-line-ending
+        args: ['--fix=lf']
+      - id: forbid-submodules

data/CLAUDE.md

@@ -0,0 +1,74 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+### Testing
+- `bundle exec rake spec` - Run all RSpec tests
+- `bundle exec rspec spec/[filename]_spec.rb` - Run specific test file
+
+### Building
+- `bundle exec rake build` - Build the gem
+- `bundle exec rake` - Default task (runs spec and build)
+
+### Code Quality
+- `bundle exec standardrb` - Run StandardRB linter (code style enforcement)
+- `bundle exec standardrb --fix` - Auto-fix style issues
+
+### Model Generation
+- `bundle exec rake modelgen:latest` - Generate model files from latest Trino version
+- `bundle exec rake modelgen:all` - Generate all model versions
+
+## Architecture Overview
+
+This is a Ruby client library for Trino (distributed SQL query engine). The architecture is layered:
+
+### Core Components
+
+1. **Client Layer** (`lib/trino/client/client.rb`):
+   - `Trino::Client::Client` - Main API entry point
+   - Provides `run()`, `run_with_names()`, `query()`, `kill()` methods
+   - Handles synchronous and streaming query execution
+
+2. **Query Layer** (`lib/trino/client/query.rb`):
+   - `Query` class - Manages query execution lifecycle
+   - Handles streaming results via `each_row`, `each_row_chunk`
+   - Provides column metadata and result transformation
+
+3. **Statement Client** (`lib/trino/client/statement_client.rb`):
+   - `StatementClient` - Low-level HTTP communication with Trino
+   - Manages query state machine (running, finished, failed, aborted)
+   - Handles retries, timeouts, and error conditions
+   - Supports both JSON and MessagePack response formats
+
+4. **HTTP Layer** (`lib/trino/client/faraday_client.rb`):
+   - Uses Faraday for HTTP requests with middleware for gzip and redirects
+   - Handles authentication, SSL configuration, proxy settings
+
+### Model System
+
+- **Versioned Models** (`lib/trino/client/model_versions/`):
+  - Generated from Trino source code for different Trino versions
+  - Each version (351, 316, 303, etc.) has its own model definitions
+  - Default is version 351
+
+- **Model Generation** (`modelgen/`):
+  - Automated model generation from Trino Java source
+  - Downloads Trino source and extracts model definitions
+
+### Key Features
+
+- **Streaming Results**: Query results can be processed row-by-row without loading all data into memory
+- **Timeout Control**: Supports both query-level and plan-level timeouts
+- **Error Recovery**: Built-in retry logic for transient failures (502, 503, 504)
+- **Multiple Result Formats**: Raw arrays, named hashes, or streaming iteration
+- **ROW Type Support**: Can parse Trino ROW types into Ruby hashes via `transform_row`
+
+### Testing
+
+Tests are organized by component:
+- `spec/client_spec.rb` - Client API tests
+- `spec/statement_client_spec.rb` - Low-level protocol tests
+- `spec/column_value_parser_spec.rb` - Data parsing tests
+- `spec/tpch_query_spec.rb` - Integration tests with TPC-H queries

data/ChangeLog.md

@@ -1,5 +1,16 @@
 trino-client-ruby
 ====
+## 2.2.3
+- Add .github/workflows/publisher.yml [[f9643b2](https://github.com/treasure-data/trino-client-ruby/commit/f9643b2)]
+- Bump actions/checkout from 4 to 5 ([#141](https://github.com/treasure-data/trino-client-ruby/issues/141)) [[61372d4](https://github.com/treasure-data/trino-client-ruby/commit/61372d4)]
+- Update standard requirement from ~> 1.35.0 to ~> 1.50.0 ([#139](https://github.com/treasure-data/trino-client-ruby/issues/139)) [[e4c95a6](https://github.com/treasure-data/trino-client-ruby/commit/e4c95a6)]
+- misc: Add CLAUDE.md and etc ([#138](https://github.com/treasure-data/trino-client-ruby/issues/138)) [[1a0e975](https://github.com/treasure-data/trino-client-ruby/commit/1a0e975)]
+
+## 2.2.2
+- Close StatementClient when hitting client-side timeout ([#136](https://github.com/treasure-data/trino-client-ruby/issues/136)) [[b3261b1](https://github.com/treasure-data/trino-client-ruby/commit/b3261b1)]
+- Tune Ruby versions in CI / Drop ruby 2.7, 3.0 and 3.1 supports ([#135](https://github.com/treasure-data/trino-client-ruby/issues/135)) [[da87c84](https://github.com/treasure-data/trino-client-ruby/commit/da87c84)]
+- Update standard requirement from ~> 1.30.1 to ~> 1.35.0 ([#132](https://github.com/treasure-data/trino-client-ruby/issues/132)) [[4f05141](https://github.com/treasure-data/trino-client-ruby/commit/4f05141)]
+
 ## 2.2.1
 - fix: Retry GET against 502, 503 responses ([#129](https://github.com/treasure-data/trino-client-ruby/issues/129)) [[80f342d](https://github.com/treasure-data/trino-client-ruby/commit/80f342d)]
 - Update CODEOWNERS ([#127](https://github.com/treasure-data/trino-client-ruby/issues/127)) [[bad4b34](https://github.com/treasure-data/trino-client-ruby/commit/bad4b34)]

data/lib/trino/client/client.rb

@@ -72,7 +72,7 @@ module Trino::Client
     end
   end
 
-  def self.new(*args)
-    Client.new(*args)
+  def self.new(...)
+    Client.new(...)
   end
 end

data/lib/trino/client/statement_client.rb

@@ -233,6 +233,7 @@ module Trino::Client
         elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - @started_at
 
         if @query_timeout && elapsed > @query_timeout
+          close
           raise_timeout_error!
         end
 
@@ -240,6 +241,7 @@ module Trino::Client
             elapsed > @plan_timeout
           # @results is not set (even first faraday_get_with_retry isn't called yet) or
           # result from Trino doesn't include result schema. Query planning isn't done yet.
+          close
           raise_timeout_error!
         end
       end

data/lib/trino/client/version.rb

@@ -15,6 +15,6 @@
 #
 module Trino
   module Client
-    VERSION = "2.2.1"
+    VERSION = "2.2.3"
   end
 end

data/trino-client.gemspec

@@ -15,18 +15,22 @@ Gem::Specification.new do |gem|
   gem.executables   = gem.files.grep(%r{^bin/}).map { |f| File.basename(f) }
   gem.require_paths = ["lib"]
 
-  gem.required_ruby_version = ">= 2.7.0"
+  gem.required_ruby_version = ">= 3.2.0"
 
   gem.add_dependency "faraday", ">= 1", "< 3"
   gem.add_dependency "faraday-gzip", ">= 1"
   gem.add_dependency "faraday-follow_redirects", ">= 0.3"
   gem.add_dependency "msgpack", [">= 1.5.1"]
 
+  if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("3.4")
+    gem.add_dependency("base64")
+  end
+
   gem.add_development_dependency "rake", [">= 0.9.2", "< 14.0"]
   gem.add_development_dependency "rspec", "~> 3.13.0"
   gem.add_development_dependency "webmock", ["~> 3.0"]
   gem.add_development_dependency "addressable", "~> 2.8.1" # 2.5.0 doesn't support Ruby 1.9.3
   gem.add_development_dependency "simplecov", "~> 0.22.0"
-  gem.add_development_dependency "standard", "~> 1.30.1"
+  gem.add_development_dependency "standard", "~> 1.50.0"
   gem.add_development_dependency "psych", "~> 3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trino-client
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.2.3
 platform: ruby
 authors:
 - Sadayuki Furuhashi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-11 00:00:00.000000000 Z
+date: 2025-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -154,14 +154,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.30.1
+        version: 1.50.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.30.1
+        version: 1.50.0
 - !ruby/object:Gem::Dependency
   name: psych
   requirement: !ruby/object:Gem::Requirement
@@ -183,6 +183,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".pre-commit-config.yaml"
+- CLAUDE.md
 - ChangeLog.md
 - LICENSE
 - README.md
@@ -218,14 +220,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Trino client library