duckdb 1.5.1.1 → 1.5.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0982b8680fcd79b493773dbbf39fd3f366fe11ccc952a8bfb4be0a140657e8fe'
-  data.tar.gz: 34cc46de733b8bc215197e5ceab3eb3022b0067ac34376b828ded5106d4b1261
+  metadata.gz: 4c7c57e0282ec2213b1efb3844445804e5fbbc09e03496f2ba71c1bd24152843
+  data.tar.gz: 9057fa45fafeba0dc2110562f98cd49eecf53ec0f0a48a989756742525c82b4a
 SHA512:
-  metadata.gz: 2b3043a60bbb99bd449f709befb3b84d1036d1e0643c9ed3a93eb50e88df48962095caa537f23881bfc9434a035b240230c8d81004b1d863742916baa6540902
-  data.tar.gz: 34ff46b0100769147684a4092005838ba418ab1907fc5b0690bd37f883007b0004e4838a5fdfd04ca276d157d91d39523aba74eced99133f46a8039d52b3c036
+  metadata.gz: 78bbd166f587491085267791ffca949f2b310597f802424b7e0525c8c4f35f345c2362b17b33401bee374601d5f52746d10ac21f60ea8344bd3bf08e28d7f4b5
+  data.tar.gz: 6fc88b5e289ef3451691f57cb404c390b9deabbafddf81e8aedd300121276a9df62b0492559f2602eb4aeaa57ed2a83cc98ccfbef3a728771c34a565a022f78a

data/CHANGELOG.md

@@ -4,6 +4,53 @@ All notable changes to this project will be documented in this file.
 
 # Unreleased
 
+# 1.5.2.1 - 2026-04-24
+
+- add `DuckDB::AggregateFunction.create`.
+- add `DuckDB::Appender#clear_columns`.
+- add `DuckDB::Appender#add_column`.
+- add `DuckDB::Appender#clear` to discard all unflushed data from the appender without writing it to the table (requires DuckDB >= 1.5.0).
+- add `DuckDB::Value.create_decimal`.
+- fix gemspec to use `git ls-files`, preventing precompiled x86_64 `.so` from being bundled into the gem and breaking non-x86 platforms.
+
+# 1.5.2.0 - 2026-04-16
+
+- add `DuckDB::DataChunk#reset` to clear a chunk's contents so it can be reused across multiple `Appender#append_data_chunk` calls without reallocation.
+- add `DuckDB::Database.new(path = :memory, config: nil, &block)` to create a database instance. `path` is a positional argument (default `:memory` for in-memory database, or a String path for file database). `config:` accepts an optional `DuckDB::Config` object. When a block is given, the database is yielded and automatically closed afterwards.
+- add `TIME_NS` column support to `DuckDB::Result`. `TIME_NS` values are returned as `Time` objects with nanoseconds truncated to microseconds.
+- add `INTERVAL` as a supported `return_type` for `DuckDB::ScalarFunction`. The scalar function block can now return a `DuckDB::Interval` object and it will be written back to the result vector correctly.
+- add `UUID` as a supported `return_type` for `DuckDB::ScalarFunction`. The scalar function block can now return a UUID string and it will be written back to the result vector correctly.
+- add `DuckDB::Connection#extract` to extract multiple SQL statements as prepared statements without executing them.
+- add `DuckDB::Connection#register_logical_type` to register a custom logical type with a connection.
+- add `DuckDB::PreparedStatement#bind_value`.
+- add `DuckDB::Value.create_bool`.
+- add `DuckDB::Value.create_int8`.
+- add `DuckDB::Value.create_int16`.
+- add `DuckDB::Value.create_int32`.
+- add `DuckDB::Value.create_int64`.
+- add `DuckDB::Value.create_uint8`.
+- add `DuckDB::Value.create_uint16`.
+- add `DuckDB::Value.create_uint32`.
+- add `DuckDB::Value.create_uint64`.
+- add `DuckDB::Value.create_null`.
+- add `DuckDB::Value.create_float`.
+- add `DuckDB::Value.create_double`.
+- add `DuckDB::Value.create_varchar`.
+- add `DuckDB::Value.create_blob`.
+- add `DuckDB::Value.create_hugeint`.
+- add `DuckDB::Value.create_uhugeint`.
+- add `DuckDB::Appender#append_value`.
+- add `DuckDB::Appender#append_data_chunk` to append a `DuckDB::DataChunk` in one call.
+- add `DuckDB::DataChunk.new(types)` to create an owned data chunk from Ruby logical types.
+- add `DuckDB::AggregateFunction`.
+- add `DuckDB::TableDescription` to retrieve metadata about a table (with DuckDB >= 1.5.0).
+- add `DuckDB::ColumnDescription` to describe a column's name, logical type, and whether it has a default value (with DuckDB >= 1.5.0).
+
+## Breaking Changes
+- rename `DuckDB::ValueImpl` to `DuckDB::Value`
+- remove `DuckDB::ExtractedStatementsImpl`. use `DuckDB::ExtractedStatements`
+- `DuckDB::Database.open` to delegate to `DuckDB::Database.new`. The signature changes from `open(dbpath = nil, config = nil)` to `open(path = :memory, config: nil)`. `DuckDB::Database.open` now accepts `:memory` symbol and `config:` keyword argument.
+
 # 1.5.1.1 - 2026-04-04
 
 - fix `DuckDB::ScalarFunction` to allow `HUGEINT` and `UHUGEINT` as `return_type` and parameter type (the C extension's vector write path was missing those cases).

data/README.md

@@ -265,3 +265,21 @@ res.first.first # => 4
 #### Global configuration
 
 Set `DuckDB.default_timezone` to control how TIMESTAMP and TIME values without time zone are converted to Ruby `Time` objects. The default is `:local`, but you can use `:utc` for UTC conversion.
+
+## Versioning and DuckDB support
+
+The first three digits of the gem version track the DuckDB release that the
+gem is aligned with. For example, ruby-duckdb `1.5.1.0` runs with DuckDB
+`1.5.1`.
+
+All releases in the same `1.5.1.x` series target DuckDB `1.5.1`. The fourth
+digit is reserved for ruby-duckdb-only releases, such as gem bug fixes or new
+gem features. For example, `1.5.1.1` still targets DuckDB `1.5.1`.
+
+We also aim to support the latest release from the previous minor series, so
+the `1.5.1.x` series should also support DuckDB `1.4.x`.
+
+In addition, we try to support DuckDB LTS releases whenever practical.
+
+This gem aims to support most DuckDB minor releases, but we may occasionally
+skip a minor series.

data/duckdb.gemspec

@@ -1,33 +1,37 @@
 # frozen_string_literal: true
 
-lib = File.expand_path('lib', __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'duckdb/version'
+require_relative 'lib/duckdb/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'duckdb'
   spec.version       = DuckDB::VERSION
   spec.authors       = ['Masaki Suketa']
   spec.email         = ['masaki.suketa@nifty.ne.jp']
-
-  spec.summary       = 'This module is Ruby binding for DuckDB database engine.'
-  spec.description   = 'This module is Ruby binding for DuckDB database engine. ' \
-                       'You must have the DuckDB engine installed to build/use this module.'
   spec.homepage      = 'https://github.com/suketa/ruby-duckdb'
   spec.license       = 'MIT'
 
+  spec.summary = 'Ruby bindings for the DuckDB database engine.'
+  spec.description = <<~TEXT
+    This gem provides bindings for DuckDB, which is an in-process SQL database optimized for analytical queries on structured data.
+    It's lightweight, embeddable, and works directly with files like Parquet and CSV, making it popular for data analysis tasks.
+  TEXT
+
   spec.metadata['rubygems_mfa_required'] = 'true'
   spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://github.com/suketa/ruby-duckdb'
-  spec.metadata['changelog_uri'] = 'https://github.com/suketa/ruby-duckdb/blob/master/CHANGELOG.md'
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
 
   # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{^(test|spec|features|sample|benchmark)/|^\.(?!rdoc_options)|
+                 ^(HACKING|CONTRIBUTION)\.md$|
+                 ^(Dockerfile|docker-compose\.yml|getduckdb\.sh|Gemfile(\.lock)?)$}x)
+    end
   end
+
   spec.require_paths = ['lib']
-  spec.extensions    = ['ext/duckdb/extconf.rb']
+  spec.extensions = ['ext/duckdb/extconf.rb']
   spec.required_ruby_version = '>= 3.2.0'
   spec.add_dependency 'bigdecimal', '>= 3.1.4'
 end