trino-client 2.2.0 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9ecbdf7d017c29ac4e645d54564a701538724367f8ae62551c5e5dce705f91f
-  data.tar.gz: 78f07db77b0c6231c563c4a39a74e07d186c93b0b0ad03327439c9781e5d577d
+  metadata.gz: 1c843bb17e992cc4b85e75d9c42b1d28defaab68b26226bd3f5157c9d3f66904
+  data.tar.gz: ade30ecd070ae456b719d3339bde72fd3e869a939f1a51dca5044015fd999f43
 SHA512:
-  metadata.gz: 2c6c3b16e146d2141df38a4bd10e873cedcb18d3a0f6cb8908122382ac2cc44b471a27a4c243981ff9783da450f497ef4219d6bf4a4cc1c4e94a7d2a6ab084f2
-  data.tar.gz: 71bf6ac5e65dada7e5f02f03f7abf13132a81849520720a41641acc2041ef2bfbd4f8000de476d968dfec3c5666cf94c6acff52ec2771aaabb924bfddd228d44
+  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,23 @@
 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)]
+- Update rspec requirement from ~> 3.12.0 to ~> 3.13.0 ([#124](https://github.com/treasure-data/trino-client-ruby/issues/124)) [[6716716](https://github.com/treasure-data/trino-client-ruby/commit/6716716)]
+- Bump release-drafter/release-drafter from 5 to 6 ([#125](https://github.com/treasure-data/trino-client-ruby/issues/125)) [[0c808c2](https://github.com/treasure-data/trino-client-ruby/commit/0c808c2)]
+- Bump github/codeql-action from 2 to 3 ([#123](https://github.com/treasure-data/trino-client-ruby/issues/123)) [[c9d9356](https://github.com/treasure-data/trino-client-ruby/commit/c9d9356)]
+
 ## 2.2.0
 - Add transform_row and scalar_parser documentation and make them easier to use ([#118](https://github.com/treasure-data/trino-client-ruby/issues/118)) [[41ffca7](https://github.com/treasure-data/trino-client-ruby/commit/41ffca7)]
 

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

@@ -208,7 +208,8 @@ module Trino::Client
             return response
           end
 
-          if response.status != 503  # retry only if 503 Service Unavailable
+          # retry if 502, 503, 504 according to the trino protocol
+          unless [502, 503, 504].include?(response.status)
             # deterministic error
             exception! TrinoHttpError.new(response.status, "Trino API error at #{uri} returned #{response.status}: #{response.body}")
           end
@@ -232,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
 
@@ -239,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.0"
+    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.12.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.0
+  version: 2.2.3
 platform: ruby
 authors:
 - Sadayuki Furuhashi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-28 00:00:00.000000000 Z
+date: 2025-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -98,14 +98,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.12.0
+        version: 3.13.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.12.0
+        version: 3.13.0
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -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