duckdb 1.5.1.0 → 1.5.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c55213e9e388de53b04f29987c7714975ab5c1a8fa10a40ae378189507dae752
-  data.tar.gz: a96e6256ce85583fd395d936994d2a871727af8f7ba11fadc40a9d9ca79c15fa
+  metadata.gz: 295ef9eeb24957c23fe7b581094e8961b3c6ce818040246e6b027fd97d462984
+  data.tar.gz: 01e6c633d11f6c25ed15a3326250a4c3c107c8257e0a29b6149ea66bde2c4d46
 SHA512:
-  metadata.gz: 67c2d5de633c5999ca07e3deb7c98a091b4eaedb70eacce2d2f7c34b9e8795b012d4415e197d5996ca80eb9c526dc28e86ced8f1d977cc040fcfd8c59a9a3ad2
-  data.tar.gz: 38de479e2069a0b4dd1fa8684b2174d6f42c15375d54269f56983b530e2b7ea43150284b8825879cdceca1fe959f1c05b8043bb1c2202b30456c63eac8dbc6ab
+  metadata.gz: e3472308ea3a5fd362ebe0d2f048451e88b40d35bd14f987f6adc31c050355e340a47897b73ff1c272f409a161950b1ce7dd26c29e63598acfba8695eb4a7249
+  data.tar.gz: b31c79510aab7118f0ef0b60d3704135a6e3920eca7bef4835e866b919ea45c796bad353a06c0c0274fab3baac215be763a63bb1911958350abc0acb9c545939

data/CHANGELOG.md

@@ -4,6 +4,55 @@ All notable changes to this project will be documented in this file.
 
 # Unreleased
 
+# 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).
+- add `DuckDB::ScalarFunctionSet` to register multiple overloads of a scalar function under one name (wraps `duckdb_scalar_function_set`).
+- add `DuckDB::ScalarFunctionSet#add` to add a `DuckDB::ScalarFunction` overload to the set (wraps `duckdb_add_scalar_function_to_set`).
+- add `DuckDB::Connection#register_scalar_function_set` to register a `DuckDB::ScalarFunctionSet` with the connection (wraps `duckdb_register_scalar_function_set`).
+- `DuckDB::ScalarFunction.create` now accepts `name: nil` (optional) to allow creating nameless functions for use inside a `ScalarFunctionSet`.
+- add `DuckDB::LogicalType.create_struct` to create a struct logical type.
+- add `DuckDB::LogicalType.create_enum` to create an enum logical type.
+- add `DuckDB::LogicalType.create_decimal` to create a decimal logical type.
+
 # 1.5.1.0 - 2026-03-29
 
 - add `DuckDB::ScalarFunction#varargs_type=` to register a scalar function that accepts a variable number of arguments of a given type (wraps `duckdb_scalar_function_set_varargs`).
@@ -17,6 +66,7 @@ All notable changes to this project will be documented in this file.
 - add `DuckDB::ScalarFunction::BindInfo#get_argument(index)` to return the expression at the given argument index as a `DuckDB::Expression` object (wraps `duckdb_scalar_function_bind_get_argument`). Raises `ArgumentError` for out-of-range index.
 - add `DuckDB::Expression#foldable?` to check whether an expression can be folded to a constant at query planning time (wraps `duckdb_expression_is_foldable`). Returns `true` for literals and constant arithmetic, `false` for column references and non-deterministic functions.
 - add `DuckDB::LogicalType.create_map` to create a map logical type.
+- add `DuckDB::LogicalType.create_union` to create a union logical type.
 - bump duckdb to 1.5.1 on CI
 - add `DuckDB::ScalarFunction::BindInfo#client_context` to return the client context of the bind phase as a `DuckDB::ClientContext` object (wraps `duckdb_scalar_function_get_client_context`).
 - add `DuckDB::ClientContext#connection_id` to return the connection id of the client context (wraps `duckdb_client_context_get_connection_id`).

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.