duckdb 1.1.3.1 → 1.2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97d0a0fdf67bcfdd00102540f9dd675e1fe87176e349ef06db6f1c72f78b5219
-  data.tar.gz: da34340b078ae95c6b9fa7ddb872de4be16f3bc298169004761d532a9f378f20
+  metadata.gz: 4ed07310471afbddcd5b4facd1720eeae0868af7d2682754a30361bafdf45b5a
+  data.tar.gz: 984fd1ac1d47a72c0d20a2b1225656baf8838a47c70c3edc54d58bde0490cf25
 SHA512:
-  metadata.gz: 924d05547e0f9bf6f4772db3a93085930cd48961a0eee92d114815ea8286cd4ad6d1454764ffd97caa0cc6be103a2b084d1f402e98a973dc529b674754b4cfd7
-  data.tar.gz: 022f30d9b659b487f109d91b7d9818a26bb6d0a7fffd62fc8ae0375453688b3981b652fcb00826a826f15503ee119ca73830fe251329d51235d46ffa6c17ff50
+  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,9 +15,8 @@ jobs:
     runs-on: macos-latest
     strategy:
       matrix:
-        # ruby: ['3.1.6', '3.2.6', '3.3.6', '3.4.0-preview2', 'head']
-        ruby: ['3.1.6', '3.2.6', '3.3.6', '3.4.0-preview2']
-        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

@@ -2,6 +2,51 @@
 
 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.

data/Dockerfile

@@ -1,7 +1,7 @@
-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 && \

data/Gemfile.lock

@@ -1,34 +1,36 @@
 PATH
   remote: .
   specs:
-    duckdb (1.1.3.1)
+    duckdb (1.2.0.0)
       bigdecimal (>= 3.1.4)
 
 GEM
   remote: https://rubygems.org/
   specs:
     benchmark-ips (2.14.0)
-    bigdecimal (3.1.8)
-    minitest (5.25.2)
-    nokogiri (1.16.7-aarch64-linux)
+    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-arm-linux)
+    nokogiri (1.18.3-aarch64-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.16.7-arm64-darwin)
+    nokogiri (1.18.3-arm-linux-gnu)
       racc (~> 1.4)
-    nokogiri (1.16.7-x86-linux)
+    nokogiri (1.18.3-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.16.7-x86_64-darwin)
+    nokogiri (1.18.3-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.16.7-x86_64-linux)
+    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
   aarch64-linux

data/README.md

@@ -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'
 
@@ -218,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'

data/ext/duckdb/appender.c

@@ -6,14 +6,13 @@ static void deallocate(void *);
 static VALUE allocate(VALUE klass);
 static size_t memsize(const void *p);
 static VALUE appender_initialize(VALUE klass, VALUE con, VALUE schema, VALUE table);
-static VALUE appender_begin_row(VALUE self);
-static VALUE appender_end_row(VALUE self);
-static VALUE appender_append_bool(VALUE self, VALUE val);
-static VALUE appender_append_int8(VALUE self, VALUE val);
-static VALUE appender_append_int16(VALUE self, VALUE val);
-static VALUE appender_append_int32(VALUE self, VALUE val);
-static VALUE appender_append_int64(VALUE self, VALUE val);
-static VALUE appender_append_uint8(VALUE self, VALUE val);
+static VALUE appender_error_message(VALUE self);
+static VALUE appender__append_bool(VALUE self, VALUE val);
+static VALUE appender__append_int8(VALUE self, VALUE val);
+static VALUE appender__append_int16(VALUE self, VALUE val);
+static VALUE appender__append_int32(VALUE self, VALUE val);
+static VALUE appender__append_int64(VALUE self, VALUE val);
+static VALUE appender__append_uint8(VALUE self, VALUE val);
 static VALUE appender_append_uint16(VALUE self, VALUE val);
 static VALUE appender_append_uint32(VALUE self, VALUE val);
 static VALUE appender_append_uint64(VALUE self, VALUE val);
@@ -28,14 +27,16 @@ static VALUE appender_append_null(VALUE self);
 static VALUE appender_append_default(VALUE self);
 #endif
 
+static VALUE appender__end_row(VALUE self);
 static VALUE appender__append_date(VALUE self, VALUE yearval, VALUE monthval, VALUE dayval);
 static VALUE appender__append_interval(VALUE self, VALUE months, VALUE days, VALUE micros);
 static VALUE appender__append_time(VALUE self, VALUE hour, VALUE min, VALUE sec, VALUE micros);
 static VALUE appender__append_timestamp(VALUE self, VALUE year, VALUE month, VALUE day, VALUE hour, VALUE min, VALUE sec, VALUE micros);
 static VALUE appender__append_hugeint(VALUE self, VALUE lower, VALUE upper);
 static VALUE appender__append_uhugeint(VALUE self, VALUE lower, VALUE upper);
-static VALUE appender_flush(VALUE self);
-static VALUE appender_close(VALUE self);
+static VALUE appender__flush(VALUE self);
+static VALUE appender__close(VALUE self);
+static VALUE duckdb_state_to_bool_value(duckdb_state state);
 
 static const rb_data_type_t appender_data_type = {
     "DuckDB/Appender",
@@ -82,27 +83,40 @@ static VALUE appender_initialize(VALUE self, VALUE con, VALUE schema, VALUE tabl
     return self;
 }
 
-static VALUE appender_begin_row(VALUE self) {
+/* call-seq:
+ *   appender.error_message -> String
+ *
+ * Returns the error message of the appender. If there is no error, then it returns nil.
+ *
+ *   require 'duckdb'
+ *   db = DuckDB::Database.open
+ *   con = db.connect
+ *   con.query('CREATE TABLE users (id INTEGER, name VARCHAR)')
+ *   appender = con.appender('users')
+ *   appender.error_message # => nil
+ */
+static VALUE appender_error_message(VALUE self) {
     rubyDuckDBAppender *ctx;
+    const char *msg;
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_appender_begin_row(ctx->appender) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to flush");
+    msg = duckdb_appender_error(ctx->appender);
+    if (msg == NULL) {
+        return Qnil;
     }
-    return self;
+    return rb_str_new2(msg);
 }
 
-static VALUE appender_end_row(VALUE self) {
+/* :nodoc: */
+static VALUE appender__end_row(VALUE self) {
     rubyDuckDBAppender *ctx;
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_appender_end_row(ctx->appender) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to flush");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_appender_end_row(ctx->appender));
 }
 
-static VALUE appender_append_bool(VALUE self, VALUE val) {
+/* :nodoc: */
+static VALUE appender__append_bool(VALUE self, VALUE val) {
     rubyDuckDBAppender *ctx;
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
@@ -110,70 +124,57 @@ static VALUE appender_append_bool(VALUE self, VALUE val) {
         rb_raise(rb_eArgError, "argument must be boolean");
     }
 
-    if (duckdb_append_bool(ctx->appender, (val == Qtrue)) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append boolean");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_append_bool(ctx->appender, (val == Qtrue)));
 }
 
-static VALUE appender_append_int8(VALUE self, VALUE val) {
+/* :nodoc: */
+static VALUE appender__append_int8(VALUE self, VALUE val) {
     rubyDuckDBAppender *ctx;
     int8_t i8val = (int8_t)NUM2INT(val);
 
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_append_int8(ctx->appender, i8val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_append_int8(ctx->appender, i8val));
 }
 
-static VALUE appender_append_int16(VALUE self, VALUE val) {
+/* :nodoc: */
+static VALUE appender__append_int16(VALUE self, VALUE val) {
     rubyDuckDBAppender *ctx;
     int16_t i16val = (int16_t)NUM2INT(val);
 
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_append_int16(ctx->appender, i16val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_append_int16(ctx->appender, i16val));
 }
 
-static VALUE appender_append_int32(VALUE self, VALUE val) {
+/* :nodoc: */
+static VALUE appender__append_int32(VALUE self, VALUE val) {
     rubyDuckDBAppender *ctx;
     int32_t i32val = (int32_t)NUM2INT(val);
 
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_append_int32(ctx->appender, i32val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_append_int32(ctx->appender, i32val));
 }
 
-static VALUE appender_append_int64(VALUE self, VALUE val) {
+/* :nodoc: */
+static VALUE appender__append_int64(VALUE self, VALUE val) {
     rubyDuckDBAppender *ctx;
     int64_t i64val = (int64_t)NUM2LL(val);
 
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_append_int64(ctx->appender, i64val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_append_int64(ctx->appender, i64val));
 }
 
-static VALUE appender_append_uint8(VALUE self, VALUE val) {
+/* :nodoc: */
+static VALUE appender__append_uint8(VALUE self, VALUE val) {
     rubyDuckDBAppender *ctx;
-    int8_t ui8val = (uint8_t)NUM2UINT(val);
+    uint8_t ui8val = (uint8_t)NUM2UINT(val);
 
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_append_uint8(ctx->appender, ui8val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_append_uint8(ctx->appender, ui8val));
 }
 
 static VALUE appender_append_uint16(VALUE self, VALUE val) {
@@ -183,7 +184,7 @@ static VALUE appender_append_uint16(VALUE self, VALUE val) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_uint16(ctx->appender, ui16val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append uint16");
     }
     return self;
 }
@@ -195,7 +196,7 @@ static VALUE appender_append_uint32(VALUE self, VALUE val) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_uint32(ctx->appender, ui32val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append uint32");
     }
     return self;
 }
@@ -207,7 +208,7 @@ static VALUE appender_append_uint64(VALUE self, VALUE val) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_uint64(ctx->appender, ui64val) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append uint64");
     }
     return self;
 }
@@ -219,7 +220,7 @@ static VALUE appender_append_float(VALUE self, VALUE val) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_float(ctx->appender, fval) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append float");
     }
     return self;
 }
@@ -231,7 +232,7 @@ static VALUE appender_append_double(VALUE self, VALUE val) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_double(ctx->appender, dval) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append double");
     }
     return self;
 }
@@ -243,7 +244,7 @@ static VALUE appender_append_varchar(VALUE self, VALUE val) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_varchar(ctx->appender, pval) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append varchar");
     }
     return self;
 }
@@ -257,7 +258,7 @@ static VALUE appender_append_varchar_length(VALUE self, VALUE val, VALUE len) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_varchar_length(ctx->appender, pval, length) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append varchar with length");
     }
     return self;
 }
@@ -271,7 +272,7 @@ static VALUE appender_append_blob(VALUE self, VALUE val) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_blob(ctx->appender, (void *)pval, length) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append blob");
     }
     return self;
 }
@@ -281,7 +282,7 @@ static VALUE appender_append_null(VALUE self) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_null(ctx->appender) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append null");
     }
     return self;
 }
@@ -292,12 +293,13 @@ static VALUE appender_append_default(VALUE self) {
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
     if (duckdb_append_default(ctx->appender) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to append");
+        rb_raise(eDuckDBError, "failed to append default");
     }
     return self;
 }
 #endif
 
+/* :nodoc: */
 static VALUE appender__append_date(VALUE self, VALUE year, VALUE month, VALUE day) {
     duckdb_date dt;
     rubyDuckDBAppender *ctx;
@@ -311,6 +313,7 @@ static VALUE appender__append_date(VALUE self, VALUE year, VALUE month, VALUE da
     return self;
 }
 
+/* :nodoc: */
 static VALUE appender__append_interval(VALUE self, VALUE months, VALUE days, VALUE micros) {
     duckdb_interval interval;
     rubyDuckDBAppender *ctx;
@@ -324,6 +327,7 @@ static VALUE appender__append_interval(VALUE self, VALUE months, VALUE days, VAL
     return self;
 }
 
+/* :nodoc: */
 static VALUE appender__append_time(VALUE self, VALUE hour, VALUE min, VALUE sec, VALUE micros) {
     duckdb_time time;
     rubyDuckDBAppender *ctx;
@@ -337,6 +341,7 @@ static VALUE appender__append_time(VALUE self, VALUE hour, VALUE min, VALUE sec,
     return self;
 }
 
+/* :nodoc: */
 static VALUE appender__append_timestamp(VALUE self, VALUE year, VALUE month, VALUE day, VALUE hour, VALUE min, VALUE sec, VALUE micros) {
     duckdb_timestamp timestamp;
 
@@ -352,6 +357,7 @@ static VALUE appender__append_timestamp(VALUE self, VALUE year, VALUE month, VAL
     return self;
 }
 
+/* :nodoc: */
 static VALUE appender__append_hugeint(VALUE self, VALUE lower, VALUE upper) {
     duckdb_hugeint hugeint;
 
@@ -367,6 +373,7 @@ static VALUE appender__append_hugeint(VALUE self, VALUE lower, VALUE upper) {
     return self;
 }
 
+/* :nodoc: */
 static VALUE appender__append_uhugeint(VALUE self, VALUE lower, VALUE upper) {
     duckdb_uhugeint uhugeint;
 
@@ -382,38 +389,37 @@ static VALUE appender__append_uhugeint(VALUE self, VALUE lower, VALUE upper) {
     return self;
 }
 
-static VALUE appender_flush(VALUE self) {
+/* :nodoc: */
+static VALUE appender__flush(VALUE self) {
     rubyDuckDBAppender *ctx;
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_appender_flush(ctx->appender) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to flush");
-    }
-    return self;
+    return duckdb_state_to_bool_value(duckdb_appender_flush(ctx->appender));
 }
 
-static VALUE appender_close(VALUE self) {
+/* :nodoc: */
+static VALUE appender__close(VALUE self) {
     rubyDuckDBAppender *ctx;
     TypedData_Get_Struct(self, rubyDuckDBAppender, &appender_data_type, ctx);
 
-    if (duckdb_appender_close(ctx->appender) == DuckDBError) {
-        rb_raise(eDuckDBError, "failed to flush");
+    return duckdb_state_to_bool_value(duckdb_appender_close(ctx->appender));
+}
+
+static VALUE duckdb_state_to_bool_value(duckdb_state state) {
+    if (state == DuckDBSuccess) {
+        return Qtrue;
     }
-    return self;
+    return Qfalse;
 }
 
 void rbduckdb_init_duckdb_appender(void) {
+#if 0
+    VALUE mDuckDB = rb_define_module("DuckDB");
+#endif
     cDuckDBAppender = rb_define_class_under(mDuckDB, "Appender", rb_cObject);
     rb_define_alloc_func(cDuckDBAppender, allocate);
     rb_define_method(cDuckDBAppender, "initialize", appender_initialize, 3);
-    rb_define_method(cDuckDBAppender, "begin_row", appender_begin_row, 0);
-    rb_define_method(cDuckDBAppender, "end_row", appender_end_row, 0);
-    rb_define_method(cDuckDBAppender, "append_bool", appender_append_bool, 1);
-    rb_define_method(cDuckDBAppender, "append_int8", appender_append_int8, 1);
-    rb_define_method(cDuckDBAppender, "append_int16", appender_append_int16, 1);
-    rb_define_method(cDuckDBAppender, "append_int32", appender_append_int32, 1);
-    rb_define_method(cDuckDBAppender, "append_int64", appender_append_int64, 1);
-    rb_define_method(cDuckDBAppender, "append_uint8", appender_append_uint8, 1);
+    rb_define_method(cDuckDBAppender, "error_message", appender_error_message, 0);
     rb_define_method(cDuckDBAppender, "append_uint16", appender_append_uint16, 1);
     rb_define_method(cDuckDBAppender, "append_uint32", appender_append_uint32, 1);
     rb_define_method(cDuckDBAppender, "append_uint64", appender_append_uint64, 1);
@@ -428,12 +434,19 @@ void rbduckdb_init_duckdb_appender(void) {
     rb_define_method(cDuckDBAppender, "append_default", appender_append_default, 0);
 #endif
 
+    rb_define_private_method(cDuckDBAppender, "_end_row", appender__end_row, 0);
+    rb_define_private_method(cDuckDBAppender, "_flush", appender__flush, 0);
+    rb_define_private_method(cDuckDBAppender, "_close", appender__close, 0);
+    rb_define_private_method(cDuckDBAppender, "_append_bool", appender__append_bool, 1);
+    rb_define_private_method(cDuckDBAppender, "_append_int8", appender__append_int8, 1);
+    rb_define_private_method(cDuckDBAppender, "_append_int16", appender__append_int16, 1);
+    rb_define_private_method(cDuckDBAppender, "_append_int32", appender__append_int32, 1);
+    rb_define_private_method(cDuckDBAppender, "_append_int64", appender__append_int64, 1);
+    rb_define_private_method(cDuckDBAppender, "_append_uint8", appender__append_uint8, 1);
     rb_define_private_method(cDuckDBAppender, "_append_date", appender__append_date, 3);
     rb_define_private_method(cDuckDBAppender, "_append_interval", appender__append_interval, 3);
     rb_define_private_method(cDuckDBAppender, "_append_time", appender__append_time, 4);
     rb_define_private_method(cDuckDBAppender, "_append_timestamp", appender__append_timestamp, 7);
     rb_define_private_method(cDuckDBAppender, "_append_hugeint", appender__append_hugeint, 2);
     rb_define_private_method(cDuckDBAppender, "_append_uhugeint", appender__append_uhugeint, 2);
-    rb_define_method(cDuckDBAppender, "flush", appender_flush, 0);
-    rb_define_method(cDuckDBAppender, "close", appender_close, 0);
 }

data/ext/duckdb/blob.c

@@ -3,5 +3,8 @@
 VALUE cDuckDBBlob;
 
 void rbduckdb_init_duckdb_blob(void) {
+#if 0
+    VALUE mDuckDB = rb_define_module("DuckDB");
+#endif
     cDuckDBBlob = rb_define_class_under(mDuckDB, "Blob", rb_cString);
 }