duckdb 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 599ebecd3f693be06ff46fec535485d6ac6019cd889405a502d21a2f801c9ba8
-  data.tar.gz: '0811911b5f0c3404f8c7ff9c2351d97668013dd576d4f5a98775e9af45df5e52'
+  metadata.gz: 74313dca99b11539431ecfe95cdd3f6392e0993776f292487991cf02e654f78f
+  data.tar.gz: 151e355bd98be14256b1e78e02eeb7c60dff12e1f2a7ef875e3e9604b7bfb2b3
 SHA512:
-  metadata.gz: b4ca8e956de0edbb9aa9ceed9273a48f3cf847e5ff79732b849465c59fa2030af5cd81c62344e953e96990e11c48ff1b2dd8bd3cd87f3bc8271079aeb69a31bd
-  data.tar.gz: 3501865c8c0aa7c70761705e06026aadd95e112d34fd9eed1152ae269407fddc7cdbe6a84f6f3f8cda917022bda45fb0d349b51400b939f43b74ae64bb8e43bf
+  metadata.gz: 6da56e491796d920c3c330d5dd2941b6b23f119ebb0bfed4f8e5ae25e2d2f1a83445cd06cd9d0dfab55a19184b9ed6302f04d2f61c038c8352fec8c0ebc60372
+  data.tar.gz: 8e6f30d324473da40e4e65c7ec8d6a96625eefa835647d8412cc8a8755b5cc29246100ddb2f48f42cc60f006927af4d8b1373b2c1c3e2e6c98f2f891d83fa8e4

data/.github/workflows/test_by_github.yml

@@ -0,0 +1,66 @@
+name: Ubuntu
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: ['2.5.x', '2.6.x']
+        duckdb: ['0.1.2', '0.1.3']
+
+    steps:
+    - uses: actions/checkout@v1
+
+    - name: Set up Ruby
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+
+    - name: duckdb 0.1.2 cache
+      id: duckdb-cache-v0_1_2
+      uses: actions/cache@v1.1.0
+      with:
+        path: duckdb-v0.1.2
+        key: ${{ runner.os }}-duckdb-v0_1_2_007
+        restore-keys: |
+          ${{ runner.os }}-duckdb-v0_1_2
+
+    - name: Build duckdb 0.1.2
+      if: steps.duckdb-cache-v0_1_2.outputs.cache-hit != 'true'
+      run: |
+        git clone -b v0.1.2 https://github.com/cwida/duckdb.git duckdb-tmp-v0.1.2
+        cd duckdb-tmp-v0.1.2 && make && cd ..
+        rm -rf duckdb-v0.1.2
+        mkdir -p duckdb-v0.1.2/build/release/src duckdb-v0.1.2/src
+        cp -rip duckdb-tmp-v0.1.2/build/release/src/*.so duckdb-v0.1.2/build/release/src
+        cp -rip duckdb-tmp-v0.1.2/src/include duckdb-v0.1.2/src/
+
+    - name: duckdb 0.1.3 cache
+      id: duckdb-cache-v0_1_3
+      uses: actions/cache@v1.1.0
+      with:
+        path: duckdb-v0.1.3
+        key: ${{ runner.os }}-duckdb-v0_1_3_001
+        restore-keys: |
+          ${{ runner.os }}-duckdb-v0_1_3
+
+    - name: Build duckdb 0.1.3
+      if: steps.duckdb-cache-v0_1_3.outputs.cache-hit != 'true'
+      run: |
+        git clone -b v0.1.3 https://github.com/cwida/duckdb.git duckdb-tmp-v0.1.3
+        cd duckdb-tmp-v0.1.3 && make && cd ..
+        rm -rf duckdb-v0.1.3
+        mkdir -p duckdb-v0.1.3/build/release/src duckdb-v0.1.3/src
+        cp -rip duckdb-tmp-v0.1.3/build/release/src/*.so duckdb-v0.1.3/build/release/src
+        cp -rip duckdb-tmp-v0.1.3/src/include duckdb-v0.1.3/src/
+
+    - name: Build and test with Rake with Ruby ${{ matrix.ruby }}
+      env:
+        DUCKDB_VERSION: ${{ matrix.duckdb }}
+      run: |
+        gem install bundler
+        bundle install --jobs 4 --retry 3
+        bundle exec rake -- --with-duckdb-include=${GITHUB_WORKSPACE}/duckdb-v${DUCKDB_VERSION}/src/include --with-duckdb-lib=${GITHUB_WORKSPACE}/duckdb-v${DUCKDB_VERSION}/build/release/src/

data/.travis.yml

@@ -0,0 +1,20 @@
+language: ruby
+cache:
+  bundler: true
+  directories:
+    - ${HOME}/duckdb-v0.1.2
+    - ${HOME}/duckdb-v0.1.3
+before_install:
+  - yes | gem update --system
+  - if [[ ! -d ${HOME}/duckdb-v0.1.2/build ]]; then cd ${HOME} && git clone -b v0.1.2 https://github.com/cwida/duckdb.git duckdb-v0.1.2 && cd duckdb-v0.1.2 && make && cd ${TRAVIS_BUILD_DIR}; fi
+  - if [[ ! -d ${HOME}/duckdb-v0.1.3/build ]]; then cd ${HOME} && git clone -b v0.1.3 https://github.com/cwida/duckdb.git duckdb-v0.1.3 && cd duckdb-v0.1.3 && make && cd ${TRAVIS_BUILD_DIR}; fi
+
+env:
+  - DUCKDB_VERSION=0.1.2
+  - DUCKDB_VERSION=0.1.3
+rvm:
+  - 2.5.7
+  - 2.6.5
+  - 2.7.0
+  - ruby-head
+script: bundle exec rake -- --with-duckdb-include=${HOME}/duckdb-v${DUCKDB_VERSION}/src/include --with-duckdb-lib=${HOME}/duckdb-v${DUCKDB_VERSION}/build/release/src/

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # ChangeLog
 
+## 0.0.6
+
+- add alias `execute` of `DuckDB::Connection#query`
+- support `duckdb version 0.1.3`
+- add `DuckDB:PreparedStatement`
+- create CI (GitHub Actions / Travis-CI)
+- create database only once in result_test.rb
+
 ## 0.0.5
 
 - add `DuckDB::Error`

data/Gemfile.lock

@@ -1,14 +1,14 @@
 PATH
   remote: .
   specs:
-    duckdb (0.0.5)
+    duckdb (0.0.6)
 
 GEM
   remote: https://rubygems.org/
   specs:
     minitest (5.13.0)
-    rake (10.5.0)
-    rake-compiler (1.0.8)
+    rake (13.0.1)
+    rake-compiler (1.1.0)
       rake
 
 PLATFORMS
@@ -18,8 +18,8 @@ DEPENDENCIES
   bundler (~> 2.0)
   duckdb!
   minitest (~> 5.0)
-  rake (~> 10.0)
+  rake (~> 13.0)
   rake-compiler
 
 BUNDLED WITH
-   2.0.2
+   2.1.4

data/README.md

@@ -1,5 +1,7 @@
 # ruby-duckdb
 
+[![Build Status](https://travis-ci.com/suketa/ruby-duckdb.svg?branch=master)](https://travis-ci.com/suketa/ruby-duckdb)
+[![](https://github.com/suketa/ruby-duckdb/workflows/Ubuntu/badge.svg)](https://github.com/suketa/ruby-duckdb/actions?query=workflow%3AUbuntu)
 
 ## Description
 

data/duckdb.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |spec|
   spec.extensions    = ["ext/duckdb/extconf.rb"]
 
   spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rake-compiler"
   spec.add_development_dependency "minitest", "~> 5.0"
 end

data/ext/duckdb/connection.c

@@ -1,7 +1,5 @@
 #include "ruby-duckdb.h"
 
-static VALUE cDuckDBConnection;
-
 static void deallocate(void *ctx)
 {
     rubyDuckDBConnection *p = (rubyDuckDBConnection *)ctx;
@@ -16,7 +14,8 @@ static VALUE allocate(VALUE klass)
     return Data_Wrap_Struct(klass, NULL, deallocate, ctx);
 }
 
-VALUE create_connection(VALUE oDuckDBDatabase) {
+VALUE create_connection(VALUE oDuckDBDatabase)
+{
     rubyDuckDB *ctxdb;
     rubyDuckDBConnection *ctxcon;
     VALUE obj;
@@ -34,8 +33,8 @@ VALUE create_connection(VALUE oDuckDBDatabase) {
     return obj;
 }
 
-static VALUE duckdb_connection_query(VALUE self, VALUE str) {
-
+static VALUE duckdb_connection_query_sql(VALUE self, VALUE str)
+{
     rubyDuckDBConnection *ctx;
     rubyDuckDBResult *ctxr;
 
@@ -55,5 +54,5 @@ void init_duckdb_connection(void)
     cDuckDBConnection = rb_define_class_under(mDuckDB, "Connection", rb_cObject);
     rb_define_alloc_func(cDuckDBConnection, allocate);
 
-    rb_define_method(cDuckDBConnection, "query", duckdb_connection_query, 1);
+    rb_define_private_method(cDuckDBConnection, "query_sql", duckdb_connection_query_sql, 1);
 }

data/ext/duckdb/connection.h

@@ -7,6 +7,8 @@ struct _rubyDuckDBConnection {
 
 typedef struct _rubyDuckDBConnection rubyDuckDBConnection;
 
+VALUE cDuckDBConnection;
+
 void init_duckdb_connection(void);
 VALUE create_connection(VALUE oDuckDBDatabase);
 

data/ext/duckdb/database.c

@@ -36,11 +36,13 @@ static VALUE duckdb_database_s_open(int argc, VALUE *argv, VALUE cDuckDBDatabase
     return obj;
 }
 
-static VALUE duckdb_database_connect(VALUE self) {
+static VALUE duckdb_database_connect(VALUE self)
+{
     return create_connection(self);
 }
 
-void init_duckdb_database(void) {
+void init_duckdb_database(void)
+{
     VALUE cDuckDBDatabase = rb_define_class_under(mDuckDB, "Database", rb_cObject);
     rb_define_alloc_func(cDuckDBDatabase, allocate);
     rb_define_singleton_method(cDuckDBDatabase, "open", duckdb_database_s_open, -1);

data/ext/duckdb/duckdb.c

@@ -3,11 +3,13 @@
 VALUE mDuckDB;
 
 void
-Init_duckdb_native(void) {
+Init_duckdb_native(void)
+{
     mDuckDB = rb_define_module("DuckDB");
 
     init_duckdb_error();
     init_duckdb_database();
     init_duckdb_connection();
     init_duckdb_result();
+    init_duckdb_prepared_statement();
 }

data/ext/duckdb/error.c

@@ -1,5 +1,6 @@
 #include "ruby-duckdb.h"
 
-void init_duckdb_error(void) {
+void init_duckdb_error(void)
+{
     eDuckDBError = rb_define_class_under(mDuckDB, "Error", rb_eStandardError);
 }

data/ext/duckdb/extconf.rb

@@ -1,5 +1,7 @@
 require 'mkmf'
 
 dir_config('duckdb')
-have_library('duckdb')
-create_makefile('duckdb/duckdb_native')
+if have_library('duckdb')
+  have_func('duckdb_bind_null', 'duckdb.h')
+  create_makefile('duckdb/duckdb_native')
+end

data/ext/duckdb/prepared_statement.c

@@ -0,0 +1,205 @@
+#include "ruby-duckdb.h"
+
+static VALUE cDuckDBPreparedStatement;
+
+static void deallocate(void *ctx)
+{
+    rubyDuckDBPreparedStatement *p = (rubyDuckDBPreparedStatement *)ctx;
+
+    duckdb_destroy_prepare(&(p->prepared_statement));
+    xfree(p);
+}
+
+static VALUE allocate(VALUE klass)
+{
+    rubyDuckDBPreparedStatement *ctx = xcalloc((size_t)1, sizeof(rubyDuckDBPreparedStatement));
+    return Data_Wrap_Struct(klass, NULL, deallocate, ctx);
+}
+
+static VALUE duckdb_prepared_statement_initialize(VALUE self, VALUE con, VALUE query)
+{
+    rubyDuckDBConnection *ctxcon;
+    rubyDuckDBPreparedStatement *ctx;
+
+    if (!rb_obj_is_kind_of(con, cDuckDBConnection)) {
+        rb_raise(rb_eTypeError, "1st argument should be instance of DackDB::Connection");
+    }
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+    Data_Get_Struct(con, rubyDuckDBConnection, ctxcon);
+
+    if (duckdb_prepare(ctxcon->con, StringValuePtr(query), &(ctx->prepared_statement)) == DuckDBError) {
+        /* TODO: include query parameter information in error message. */
+        rb_raise(eDuckDBError, "failed to prepare statement");
+    }
+    return self;
+}
+
+static VALUE duckdb_prepared_statement_nparams(VALUE self)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+
+    if (duckdb_nparams(ctx->prepared_statement, &(ctx->nparams)) == DuckDBError) {
+        rb_raise(eDuckDBError, "failed to get number of parameters");
+    }
+    return rb_int2big(ctx->nparams);
+}
+
+
+static VALUE duckdb_prepared_statement_execute(VALUE self)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    rubyDuckDBResult *ctxr;
+    VALUE result = create_result();
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+    Data_Get_Struct(result, rubyDuckDBResult, ctxr);
+    if (duckdb_execute_prepared(ctx->prepared_statement, &(ctxr->result)) == DuckDBError) {
+        rb_raise(eDuckDBError, "%s", ctxr->result.error_message);
+    }
+    return result;
+}
+
+static index_t check_index(VALUE vidx)
+{
+    index_t idx = FIX2INT(vidx);
+    if (idx <= 0) {
+        rb_raise(rb_eArgError, "index of parameter must be greater than 0");
+    }
+    return idx;
+}
+
+static VALUE duckdb_prepared_statement_bind_boolean(VALUE self, VALUE vidx, VALUE val)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+    if (val != Qtrue && val != Qfalse) {
+        rb_raise(rb_eArgError, "binding value must be boolean");
+    }
+
+    if (duckdb_bind_boolean(ctx->prepared_statement, idx, (val == Qtrue)) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+
+static VALUE duckdb_prepared_statement_bind_int16(VALUE self, VALUE vidx, VALUE val)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+    int16_t i16val = NUM2INT(val);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+
+    if (duckdb_bind_int16(ctx->prepared_statement, idx, i16val) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+
+static VALUE duckdb_prepared_statement_bind_int32(VALUE self, VALUE vidx, VALUE val)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+    int32_t i32val = NUM2LONG(val);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+
+    if (duckdb_bind_int32(ctx->prepared_statement, idx, i32val) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+
+static VALUE duckdb_prepared_statement_bind_int64(VALUE self, VALUE vidx, VALUE val)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+    int64_t i64val = NUM2LL(val);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+
+    if (duckdb_bind_int64(ctx->prepared_statement, idx, i64val) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+
+static VALUE duckdb_prepared_statement_bind_float(VALUE self, VALUE vidx, VALUE val)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+    double dbl = NUM2DBL(val);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+
+    if (duckdb_bind_float(ctx->prepared_statement, idx, (float)dbl) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+
+static VALUE duckdb_prepared_statement_bind_double(VALUE self, VALUE vidx, VALUE val)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+    double dbl = NUM2DBL(val);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+
+    if (duckdb_bind_double(ctx->prepared_statement, idx, dbl) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+
+static VALUE duckdb_prepared_statement_bind_varchar(VALUE self, VALUE vidx, VALUE str)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+    if (duckdb_bind_varchar(ctx->prepared_statement, idx, StringValuePtr(str)) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+
+#ifdef HAVE_DUCKDB_BIND_NULL
+static VALUE duckdb_prepared_statement_bind_null(VALUE self, VALUE vidx)
+{
+    rubyDuckDBPreparedStatement *ctx;
+    index_t idx = check_index(vidx);
+
+    Data_Get_Struct(self, rubyDuckDBPreparedStatement, ctx);
+    if (duckdb_bind_null(ctx->prepared_statement, idx) == DuckDBError) {
+        rb_raise(eDuckDBError, "fail to bind %ld parameter", idx);
+    }
+    return self;
+}
+#endif
+
+void init_duckdb_prepared_statement(void)
+{
+    cDuckDBPreparedStatement = rb_define_class_under(mDuckDB, "PreparedStatement", rb_cObject);
+
+    rb_define_alloc_func(cDuckDBPreparedStatement, allocate);
+
+    rb_define_method(cDuckDBPreparedStatement, "initialize", duckdb_prepared_statement_initialize, 2);
+    rb_define_method(cDuckDBPreparedStatement, "execute", duckdb_prepared_statement_execute, 0);
+    rb_define_method(cDuckDBPreparedStatement, "nparams", duckdb_prepared_statement_nparams, 0);
+    rb_define_method(cDuckDBPreparedStatement, "bind_boolean", duckdb_prepared_statement_bind_boolean, 2);
+    rb_define_method(cDuckDBPreparedStatement, "bind_int16", duckdb_prepared_statement_bind_int16, 2);
+    rb_define_method(cDuckDBPreparedStatement, "bind_int32", duckdb_prepared_statement_bind_int32, 2);
+    rb_define_method(cDuckDBPreparedStatement, "bind_int64", duckdb_prepared_statement_bind_int64, 2);
+    rb_define_method(cDuckDBPreparedStatement, "bind_float", duckdb_prepared_statement_bind_float, 2);
+    rb_define_method(cDuckDBPreparedStatement, "bind_double", duckdb_prepared_statement_bind_double, 2);
+    rb_define_method(cDuckDBPreparedStatement, "bind_varchar", duckdb_prepared_statement_bind_varchar, 2);
+#ifdef HAVE_DUCKDB_BIND_NULL
+    /* duckdb version > 0.1.1 */
+    rb_define_method(cDuckDBPreparedStatement, "bind_null", duckdb_prepared_statement_bind_null, 1);
+#endif
+}

data/ext/duckdb/prepared_statement.h

@@ -0,0 +1,13 @@
+#ifndef RUBY_DUCKDB_PREPARED_STATEMENT_H
+#define RUBY_DUCKDB_PREPARED_STATEMENT_H
+
+struct _rubyDuckDBPreparedStatement {
+    duckdb_prepared_statement prepared_statement;
+    index_t nparams;
+};
+
+typedef struct _rubyDuckDBPreparedStatement rubyDuckDBPreparedStatement;
+
+void init_duckdb_prepared_statement(void);
+
+#endif

data/ext/duckdb/result.c

@@ -16,37 +16,44 @@ static VALUE allocate(VALUE klass)
     return Data_Wrap_Struct(klass, NULL, deallocate, ctx);
 }
 
-static VALUE to_ruby_obj_boolean(duckdb_result *result, size_t col_idx, size_t row_idx) {
+static VALUE to_ruby_obj_boolean(duckdb_result *result, index_t col_idx, index_t row_idx)
+{
     bool bval = duckdb_value_boolean(result, col_idx, row_idx);
     return bval ? Qtrue : Qnil;
 }
 
-static VALUE to_ruby_obj_smallint(duckdb_result *result, size_t col_idx, size_t row_idx) {
+static VALUE to_ruby_obj_smallint(duckdb_result *result, index_t col_idx, index_t row_idx)
+{
     int16_t i16val = duckdb_value_int16(result, col_idx, row_idx);
     return INT2FIX(i16val);
 }
 
-static VALUE to_ruby_obj_integer(duckdb_result *result, size_t col_idx, size_t row_idx) {
+static VALUE to_ruby_obj_integer(duckdb_result *result, index_t col_idx, index_t row_idx)
+{
     int32_t i32val = duckdb_value_int32(result, col_idx, row_idx);
     return INT2NUM(i32val);
 }
 
-static VALUE to_ruby_obj_bigint(duckdb_result *result, size_t col_idx, size_t row_idx) {
+static VALUE to_ruby_obj_bigint(duckdb_result *result, index_t col_idx, index_t row_idx)
+{
     int64_t i64val = duckdb_value_int64(result, col_idx, row_idx);
     return rb_int2big(i64val);
 }
 
-static VALUE to_ruby_obj_float(duckdb_result *result, size_t col_idx, size_t row_idx) {
+static VALUE to_ruby_obj_float(duckdb_result *result, index_t col_idx, index_t row_idx)
+{
     float fval = duckdb_value_float(result, col_idx, row_idx);
     return DBL2NUM(fval);
 }
 
-static VALUE to_ruby_obj_double(duckdb_result *result, size_t col_idx, size_t row_idx) {
+static VALUE to_ruby_obj_double(duckdb_result *result, index_t col_idx, index_t row_idx)
+{
     double dval = duckdb_value_double(result, col_idx, row_idx);
     return DBL2NUM(dval);
 }
 
-static VALUE to_ruby_obj(duckdb_result *result, size_t col_idx, size_t row_idx) {
+static VALUE to_ruby_obj(duckdb_result *result, index_t col_idx, index_t row_idx)
+{
     char *p;
     VALUE obj = Qnil;
     if (result->columns[col_idx].nullmask[row_idx]) {
@@ -73,8 +80,9 @@ static VALUE to_ruby_obj(duckdb_result *result, size_t col_idx, size_t row_idx)
     return obj;
 }
 
-static VALUE row_array(rubyDuckDBResult *ctx, size_t row_idx) {
-    size_t col_idx;
+static VALUE row_array(rubyDuckDBResult *ctx, index_t row_idx)
+{
+    index_t col_idx;
     VALUE ary = rb_ary_new2(ctx->result.column_count);
     for(col_idx = 0; col_idx < ctx->result.column_count; col_idx++) {
         rb_ary_store(ary, col_idx, to_ruby_obj(&(ctx->result), col_idx, row_idx));
@@ -82,16 +90,18 @@ static VALUE row_array(rubyDuckDBResult *ctx, size_t row_idx) {
     return ary;
 }
 
-static VALUE duckdb_result_row_size(VALUE oDuckDBResult, VALUE args, VALUE obj) {
+static VALUE duckdb_result_row_size(VALUE oDuckDBResult, VALUE args, VALUE obj)
+{
     rubyDuckDBResult *ctx;
     Data_Get_Struct(oDuckDBResult, rubyDuckDBResult, ctx);
 
     return LONG2FIX(ctx->result.row_count);
 }
 
-static VALUE duckdb_result_each(VALUE oDuckDBResult) {
+static VALUE duckdb_result_each(VALUE oDuckDBResult)
+{
     rubyDuckDBResult *ctx;
-    size_t row_idx = 0;
+    index_t row_idx = 0;
 
     RETURN_SIZED_ENUMERATOR(oDuckDBResult, 0, 0, duckdb_result_row_size);
 
@@ -102,7 +112,8 @@ static VALUE duckdb_result_each(VALUE oDuckDBResult) {
     return oDuckDBResult;
 }
 
-VALUE create_result(void) {
+VALUE create_result(void)
+{
     return allocate(cDuckDBResult);
 }
 

data/ext/duckdb/ruby-duckdb.h

@@ -7,6 +7,7 @@
 #include "./database.h"
 #include "./connection.h"
 #include "./result.h"
+#include "./prepared_statement.h"
 
 extern VALUE mDuckDB;
 

data/lib/duckdb.rb

@@ -1,6 +1,10 @@
 require 'duckdb/version'
+require 'duckdb/database'
+require 'duckdb/connection'
 require 'duckdb/duckdb_native'
 require 'duckdb/result'
+require 'duckdb/prepared_statement'
 
+# DuckDB provides Ruby interface of DuckDB.
 module DuckDB
 end

data/lib/duckdb/connection.rb

@@ -0,0 +1,34 @@
+module DuckDB
+  # The DuckDB::Connection encapsulates connection with DuckDB database.
+  #
+  #   require 'duckdb'
+  #   db = DuckDB::Database.open
+  #   con = db.connect
+  #   con.query(sql)
+  class Connection
+    #
+    # executes sql with args.
+    # The first argument sql must be SQL string.
+    # The rest arguments are parameters of SQL string.
+    # The parameters must be '?' in SQL statement.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open('duckdb_file')
+    #   con = db.connect
+    #   users = con.query('SELECT * FROM users')
+    #   sql = 'SELECT * FROM users WHERE name = ? AND email = ?'
+    #   dave = con.query(sql, 'Dave', 'dave@example.com')
+    #
+    def query(sql, *args)
+      return query_sql(sql) if args.empty?
+
+      stmt = PreparedStatement.new(self, sql)
+      args.each_with_index do |arg, i|
+        stmt.bind(i + 1, arg)
+      end
+      stmt.execute
+    end
+
+    alias execute query
+  end
+end

data/lib/duckdb/database.rb

@@ -0,0 +1,24 @@
+module DuckDB
+  # The Database class encapsulates a DuckDB database.
+  #
+  # The usage is as follows:
+  #
+  #   require 'duckdb'
+  #
+  #   db = DuckDB::Database.open # database in memory
+  #   con = db.connect
+  #
+  #   con.query('CREATE TABLE users (id INTEGER, name VARCHAR(30))')
+  #
+  #   con.query("INSERT into users VALUES(1, 'Alice')")
+  #   con.query("INSERT into users VALUES(2, 'Bob')")
+  #   con.query("INSERT into users VALUES(3, 'Cathy')")
+  #
+  #   result = con.query('SELECT * from users')
+  #   result.each do |row|
+  #     p row
+  #   end
+  #
+  class Database
+  end
+end

data/lib/duckdb/prepared_statement.rb

@@ -0,0 +1,48 @@
+require 'date'
+
+module DuckDB
+  # The DuckDB::PreparedStatement encapsulates connection with DuckDB prepared
+  # statement.
+  #
+  #   require 'duckdb'
+  #   db = DuckDB::Database.open('duckdb_database')
+  #   con = db.connect
+  #   sql ='SELECT name, email FROM users WHERE email = ?'
+  #   stmt = PreparedStatement.new(con, sql)
+  #   stmt.bind(1, 'email@example.com')
+  #   stmt.execute
+  class PreparedStatement
+
+    # binds i-th parameter with SQL prepared statement.
+    # The first argument is index of parameter. The index of first parameter is
+    # 1 not 0.
+    # The second argument value is the value of prepared statement parameter.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open('duckdb_database')
+    #   con = db.connect
+    #   sql ='SELECT name, email FROM users WHERE email = ?'
+    #   stmt = PreparedStatement.new(con, sql)
+    #   stmt.bind(1, 'email@example.com')
+    def bind(i, value)
+      case value
+      when NilClass
+        respond_to?(:bind_null) ? bind_null(i) : rb_raise(DuckDB::Error, 'This bind method does not support nil value. Re-compile ruby-duckdb with DuckDB version >= 0.1.1')
+      when Float
+        bind_double(i, value)
+      when Integer
+        bind_int64(i, value)
+      when String
+        bind_varchar(i, value)
+      when TrueClass, FalseClass
+        bind_boolean(i, value)
+      when Time
+        bind_varchar(i, value.strftime('%Y-%m-%d %H:%M:%S.%N'))
+      when Date
+        bind_varchar(i, value.strftime('%Y-%m-%d'))
+      else
+        rb_raise(DuckDB::Error, "not supported type #{value} (value.class)")
+      end
+    end
+  end
+end

data/lib/duckdb/result.rb

@@ -1,4 +1,23 @@
 module DuckDB
+  # The Result class encapsulates a execute result of DuckDB database.
+  #
+  # The usage is as follows:
+  #
+  #   require 'duckdb'
+  #
+  #   db = DuckDB::Database.open # database in memory
+  #   con = db.connect
+  #
+  #   con.execute('CREATE TABLE users (id INTEGER, name VARCHAR(30))')
+  #
+  #   con.execute("INSERT into users VALUES(1, 'Alice')")
+  #   con.execute("INSERT into users VALUES(2, 'Bob')")
+  #   con.execute("INSERT into users VALUES(3, 'Cathy')")
+  #
+  #   result = con.execute('SELECT * from users')
+  #   result.each do |row|
+  #     p row
+  #   end
   class Result
     include Enumerable
   end

data/lib/duckdb/version.rb

@@ -1,3 +1,5 @@
 module DuckDB
-  VERSION = '0.0.5'.freeze
+  # The version string of ruby-duckdb.
+  # Currently, ruby-duckdb is NOT semantic versioning.
+  VERSION = '0.0.6'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: duckdb
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - Masaki Suketa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-04 00:00:00.000000000 Z
+date: 2020-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rake-compiler
   requirement: !ruby/object:Gem::Requirement
@@ -75,14 +75,15 @@ extensions:
 - ext/duckdb/extconf.rb
 extra_rdoc_files: []
 files:
+- ".github/workflows/test_by_github.yml"
 - ".gitignore"
+- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
-- TODO
 - bin/console
 - bin/setup
 - duckdb.gemspec
@@ -94,10 +95,15 @@ files:
 - ext/duckdb/error.c
 - ext/duckdb/error.h
 - ext/duckdb/extconf.rb
+- ext/duckdb/prepared_statement.c
+- ext/duckdb/prepared_statement.h
 - ext/duckdb/result.c
 - ext/duckdb/result.h
 - ext/duckdb/ruby-duckdb.h
 - lib/duckdb.rb
+- lib/duckdb/connection.rb
+- lib/duckdb/database.rb
+- lib/duckdb/prepared_statement.rb
 - lib/duckdb/result.rb
 - lib/duckdb/version.rb
 homepage: https://github.com/suketa/ruby-duckdb
@@ -122,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: This module is Ruby binding for DuckDB database engine.

data/TODO

@@ -1,2 +0,0 @@
-- add test
-- support prepared statement