duckdb 1.1.3.0 → 1.2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d9c9c9844335a39c1c154534cb50c031f872679c98eb5434a9d664805091c96
-  data.tar.gz: ca48e19a321441194515ad781ebcedb5010bca519e53bdfe9469af6a83add301
+  metadata.gz: 4ed07310471afbddcd5b4facd1720eeae0868af7d2682754a30361bafdf45b5a
+  data.tar.gz: 984fd1ac1d47a72c0d20a2b1225656baf8838a47c70c3edc54d58bde0490cf25
 SHA512:
-  metadata.gz: 2fa6587abdac4d639630c0a605704ed76ff5f3373dcf56f83355dcc999913689e6628db690b8004ccdfc510ade6440b7ca088d9e9ac3a71e228a68ce2a8b359f
-  data.tar.gz: 1776ead93436933f732ec46c573ef7ef056c2cb86b9d601ac6574cf252c0a9774a3f78b464ddb8fe32deb61d5f626f4e6a379276898d08176a429def29f90a10
+  metadata.gz: 5e85e65243f72ac9d1d8bab1ec44a18b7ac31dccba3cfd12dc81c075f44ea79592b7357dde7f30b4276fda2eee769aa93986ca216061ea2aa497a7e7038872df
+  data.tar.gz: ee8db3baf4385b71e4c4d4765200baacef1df273702281e33809d2b4037bc25b4bae008e0501c178f615ba22f5a1b99021a22d15d5982054dbe675a769ca1cd8

data/.github/workflows/make_documents.yml

@@ -0,0 +1,34 @@
+name: Deploy RDoc to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Build and Deploy RDoc
+    runs-on: ubuntu-latest
+
+    steps:
+    # リポジトリをクローン
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    # Ruby をセットアップ
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.4
+
+    # RDoc ドキュメントを生成
+    - name: Generate RDoc
+      run: rdoc -o docs
+
+    # GitHub Pages 用にデプロイ
+    - name: Deploy to GitHub Pages
+      uses: peaceiris/actions-gh-pages@v3
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_branch: gh-pages
+        publish_dir: ./docs

data/.github/workflows/test_on_macos.yml

@@ -15,8 +15,8 @@ jobs:
     runs-on: macos-latest
     strategy:
       matrix:
-        ruby: ['3.1.6', '3.2.6', '3.3.6', '3.4.0-preview2', 'head']
-        duckdb: ['1.1.3', '1.1.1', '1.0.0']
+        ruby: ['3.1.6', '3.2.6', '3.3.6', '3.4.2', 'head']
+        duckdb: ['1.2.0', '1.1.3', '1.1.1', '1.0.0']
 
     steps:
     - uses: actions/checkout@v4

data/.github/workflows/test_on_ubuntu.yml

@@ -15,8 +15,8 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby: ['3.1.6', '3.2.6', '3.3.6', '3.4.0-preview2', 'head']
-        duckdb: ['1.1.3', '1.1.1', '1.0.0']
+        ruby: ['3.1.6', '3.2.6', '3.3.6', '3.4.2', 'head']
+        duckdb: ['1.2.0', '1.1.3', '1.1.1', '1.0.0']
 
     steps:
     - uses: actions/checkout@v4

data/.github/workflows/test_on_windows.yml

@@ -15,8 +15,8 @@ jobs:
     runs-on: windows-latest
     strategy:
       matrix:
-        ruby: ['3.1.6', '3.2.5', '3.3.5', 'ucrt', 'mingw', 'mswin', 'head']
-        duckdb: ['1.1.3', '1.1.1', '1.0.0']
+        ruby: ['3.1.6', '3.2.6', '3.3.6', '3.4.1', 'ucrt', 'mingw', 'mswin', 'head']
+        duckdb: ['1.2.0', '1.1.3', '1.1.1', '1.0.0']
 
     steps:
     - uses: actions/checkout@v4

data/.gitignore

@@ -16,3 +16,4 @@
 *.so
 Makefile
 ng_test
+/docs/

data/.rdoc_options

@@ -0,0 +1,22 @@
+---
+encoding: UTF-8
+static_path: []
+rdoc_include: []
+charset: UTF-8
+exclude:
+- "~\\z"
+- "\\.orig\\z"
+- "\\.rej\\z"
+- "\\.bak\\z"
+- "\\.gemspec\\z"
+- "ext/duckdb/extconf.rb"
+- "Gemfile"
+- "Gemfile.lock"
+- "Rakefile"
+- "getduckdb.sh"
+- "rdoc.log"
+- "tmp"
+- "mkmf.log"
+- "Dockerfile"
+- "bin"
+main_page: "README.md"

data/CHANGELOG.md

@@ -3,6 +3,55 @@
 All notable changes to this project will be documented in this file.
 # Unreleased
 
+# 1.2.0.0 - 2025-02-24
+- bump duckdb to 1.2.0.
+- add `DuckDB::LogicalType` class(Thanks to @otegami).
+  - `DuckDB::LogicalType` class is under construction. `DuckDB::LogicalType#type`, `DuckDB::LogicalType#width`,
+    `DuckDB::LogicalType#scale`, `DuckDB::LogicalType#child_type`, `DuckDB::LogicalType#size`,
+    `DuckDB::LogicalType#key_type`, and `DuckDB::LogicalType#value_type` are available.
+- add `DuckDB::Appender#error_message`.
+- fix error message when `DuckDB::Appender#flush`, `DuckDB::Appender#close`, `DuckDB::Appender#end_row`,
+  `DuckDB::Appender#append_bool`, `DuckDB::Appender#append_int8`, `DuckDB::Appender#append_int16`,
+  `DuckDB::Appender#append_int32`, `DuckDB::Appender#append_int64`, `DuckDB::Appender#append_uint8` failed.
+- `DuckDB::Appender#begin_row` does nothing. Only returns self. `DuckDB::Appender#end_row` is only required.
+- bump ruby in CI. use 3.4.2 on MacOS and Ubuntu, 3.4.1 on Windows.
+
+## Breaking changes
+- `DuckDB::Result#row_count`, `DuckDB::Result#row_size` are deprecated.
+- `DuckDB::Result#use_chunk_each?`, `DuckDB::Result#use_chunk_each=` are deprecated.
+- `DuckDB::Result#chunk_each` is deprecated.
+-  `DuckDB::Result#each` only works at first time because duckdb_chunk_each C-API is deprecated.
+   Calling `DuckDB::Result#each` twice or more does not work.
+   ```ruby
+   result = con.query('SELECT * FROM table')
+   result.each do |record|
+     p record # <= this works fine.
+   end
+   # calling each again does not work.
+   result.each do |record|
+     p record # <= this will not work
+   end
+   ```
+   If you prefer to use `DuckDB::Result#each` multiple times, set `DuckDB::Result.use_chunk_each = true`.
+   But this behavior will be removed in the future release.
+   ```ruby
+   DuckDB::Result.use_chunk_each = true
+   result = con.query('SELECT * FROM table')
+   result.each do |record|
+     p record # <= this works fine.
+   end
+   # calling each again works.
+   result.each do |record|
+     p record # <= this works fine.
+   end
+   ```
+- `DuckDB::Result#streaming?` will be deprecated.
+
+# 1.1.3.1 - 2024-11-27
+- fix to `DuckDB::Connection#query` with multiple SQL statements. Calling PreparedStatement#destroy after each statement executed.
+- install valgrind in docker development environment.
+- add `DuckDB::Appender#append_default`.
+
 # 1.1.3.0 - 2024-11-10
 - add `DuckDB::PreparedStatement#bind_decimal`. (Thanks to @otegami)
 - bump duckdb to 1.1.3.

data/Dockerfile

@@ -1,21 +1,32 @@
-ARG RUBY_VERSION=3.3.6
+ARG RUBY_VERSION=3.4.2
 FROM ruby:${RUBY_VERSION}
 
-ARG DUCKDB_VERSION=1.1.3
+ARG DUCKDB_VERSION=1.2.0
+ARG VALGRIND_VERSION=3.21.0
 
 RUN apt update -qq && \
-    apt install -y build-essential curl git wget
+    apt install -y build-essential curl git wget libc6-dbg
 
 COPY getduckdb.sh .
 RUN ./getduckdb.sh
 
-RUN unzip duckdb.zip -d libduckdb
-RUN mv libduckdb/duckdb.* /usr/local/include
-RUN mv libduckdb/libduckdb.so /usr/local/lib
-RUN ldconfig /usr/local/lib
+RUN unzip duckdb.zip -d libduckdb && \
+    mv libduckdb/duckdb.* /usr/local/include && \
+    mv libduckdb/libduckdb.so /usr/local/lib && \
+    ldconfig /usr/local/lib
+
+RUN mkdir valgrind-tmp && \
+    cd valgrind-tmp && \
+    wget https://sourceware.org/pub/valgrind/valgrind-${VALGRIND_VERSION}.tar.bz2 && \
+    tar xf valgrind-${VALGRIND_VERSION}.tar.bz2 && \
+    cd valgrind-${VALGRIND_VERSION} && \
+    ./configure && \
+    make -s && \
+    make -s install && \
+    cd .. && \
+    rm -rf /valgrind-tmp
 
 COPY . /root/ruby-duckdb
 WORKDIR /root/ruby-duckdb
 RUN git config --global --add safe.directory /root/ruby-duckdb
-RUN bundle install
-RUN rake build
+RUN bundle install && rake build

data/Gemfile.lock

@@ -1,31 +1,43 @@
 PATH
   remote: .
   specs:
-    duckdb (1.1.3.0)
+    duckdb (1.2.0.0)
       bigdecimal (>= 3.1.4)
 
 GEM
   remote: https://rubygems.org/
   specs:
     benchmark-ips (2.14.0)
-    bigdecimal (3.1.8)
-    mini_portile2 (2.8.7)
-    minitest (5.25.1)
-    nokogiri (1.16.7)
+    bigdecimal (3.1.9)
+    mini_portile2 (2.8.8)
+    minitest (5.25.4)
+    nokogiri (1.18.3)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.16.7-x86_64-linux)
+    nokogiri (1.18.3-aarch64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.3-arm-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.3-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.3-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.3-x86_64-linux-gnu)
       racc (~> 1.4)
     racc (1.8.1)
     rake (13.2.1)
-    rake-compiler (1.2.8)
+    rake-compiler (1.2.9)
       rake
-    ruby_memcheck (3.0.0)
+    ruby_memcheck (3.0.1)
       nokogiri
-    stackprof (0.2.26)
+    stackprof (0.2.27)
 
 PLATFORMS
-  ruby
+  aarch64-linux
+  arm-linux
+  arm64-darwin
+  x86-linux
+  x86_64-darwin
   x86_64-linux
 
 DEPENDENCIES
@@ -39,4 +51,4 @@ DEPENDENCIES
   stackprof
 
 BUNDLED WITH
-   2.5.9
+   2.5.22

data/README.md

@@ -46,7 +46,7 @@ brew install duckdb
 
 Using [Ruby + Devkit](https://rubyinstaller.org/downloads/) is recommended.
 
-1. Download libduckdb-windows-amd64.zip from [DuckDB](https://github.com/duckdb/duckdb/releases) and extranct it.
+1. Download libduckdb-windows-amd64.zip from [DuckDB](https://github.com/duckdb/duckdb/releases) and extract it.
 2. Copy `duckdb.dll` into `C:\Windows\System32`
 
 ## How to install
@@ -65,6 +65,8 @@ gem install duckdb -- --with-duckdb-include=/duckdb_header_directory --with-duck
 
 ## Usage
 
+The followings are some examples, for more detailed information, please refer to the [documentation](https://suketa.github.io/ruby-duckdb/index.html).
+
 ```ruby
 require 'duckdb'
 
@@ -115,7 +117,7 @@ con.query('SELECT * FROM users WHERE name = $name AND email = $email', name: 'Al
 ```
 ### Using prepared statement
 
-You can use prepared statement.
+You can use prepared statement. Prepared statement object is created by `Connection#prepare` method or `DuckDB::PreparedStatement.new`.
 
 ```ruby
 stmt = con.prepare('SELECT * FROM users WHERE name = $name AND email = $email')
@@ -125,7 +127,20 @@ stmt = con.prepare('SELECT * FROM users WHERE name = $name AND email = $email')
 # stmt = DuckDB::PreparedStatement.new(con, 'SELECT * FROM users WHERE name = $name AND email = $email')
 stmt.bind(name: 'Alice', email: 'alice@example.com')
 result = stmt.execute
+stmt.destroy
+```
+You must call `PreparedStatement#destroy` method after using prepared statement. Otherwise, automatically destroyed
+when the PreparedStatement object is garbage collected.
+
+Instead of calling `PreparedStatement#destroy`, you can use block.
+
+```ruby
+result = con.prepare('SELECT * FROM users WHERE name = $name AND email = $email') do |stmt|
+           stmt.bind(name: 'Alice', email: 'alice@example.com')
+           stmt.execute
+         end
 ```
+
 ### Using async query
 
 You can use async query.
@@ -205,7 +220,6 @@ def append
       appender = con.appender('users')
 
       10000.times do
-        appender.begin_row
         appender.append(1)
         appender.append('Alice')
         appender.end_row

data/duckdb.gemspec

@@ -15,6 +15,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/suketa/ruby-duckdb'
   spec.license       = 'MIT'
 
+  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'