trino-client 2.2.2 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43cef8b0e4d066cb1621453d85cd356d0403ce64f261c4a87b1d2dd1b3a89088
-  data.tar.gz: a398c82885cd706560f5aa5dd8bb3ddd285e6af5d380741505be205e24c8dcc1
+  metadata.gz: 1c843bb17e992cc4b85e75d9c42b1d28defaab68b26226bd3f5157c9d3f66904
+  data.tar.gz: ade30ecd070ae456b719d3339bde72fd3e869a939f1a51dca5044015fd999f43
 SHA512:
-  metadata.gz: 1fdced777c13761f88f53a12b8232a7b7aa5bf45511bf9e1035c3a8c22067389e5054383849926b10616985a1926d921b8b5dccf0e2ee06a48f6991c50abb790
-  data.tar.gz: 57b8fd77d3e3909fc620ebb0e0aeb367d04ad6dd5a382230a4dd98b586381c1b9ef9ff0866e830fbeb1b3b2d1fa20f704abf145500c65f404bb36a8cbcad3da7
+  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,11 @@
 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)]

data/lib/trino/client/version.rb

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

data/trino-client.gemspec

@@ -31,6 +31,6 @@ Gem::Specification.new do |gem|
   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.35.0"
+  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.2
+  version: 2.2.3
 platform: ruby
 authors:
 - Sadayuki Furuhashi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-17 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.35.0
+        version: 1.50.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.35.0
+        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
@@ -225,7 +227,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Trino client library