duckdb 0.2.6.0 → 0.2.9.0

data/lib/duckdb/config.rb

@@ -0,0 +1,65 @@
+module DuckDB
+  if defined?(DuckDB::Config)
+    # The DuckDB::Config encapsulates DuckDB Configuration.
+    #
+    #   require 'duckdb'
+    #   config = DuckDB::Config.new
+    #   config['default_order'] = 'DESC'
+    #   db = DuckDB::Database.open(nil, config)
+    #   con = db.connect
+    #   con.query('CREATE TABLE numbers (number INTEGER)')
+    #   con.query('INSERT INTO numbers VALUES (2), (1), (4), (3)')
+    #
+    #   # number is ordered by descending.
+    #   r = con.query('SELECT number FROM numbers ORDER BY number)
+    #   r.first.first # => 4
+    class Config
+      class << self
+        #
+        # returns available configuration name and the description.
+        # The return value is array object. The first element is the configuration
+        # name. The second is the description.
+        #
+        #   key, desc = DuckDB::Config.key_description(0)
+        #   key # => "access_mode"
+        #   desc # => "Access mode of the database ([AUTOMATIC], READ_ONLY or READ_WRITE)"
+        #
+        alias key_description get_config_flag
+
+        #
+        # returns the Hash object of all available configuration names and
+        # the descriptions.
+        #
+        # configs = DuckDB::Config.key_descriptions
+        # configs['default_order'] # => "The order type used when none is specified ([ASC] or DESC)"
+        #
+        def key_descriptions
+          return @key_descriptions if @key_descriptions
+
+          n = size
+          @key_descriptions = (0...n).each_with_object({}) do |i, hash|
+            key, description = key_description(i)
+            hash[key] = description
+          end
+        end
+      end
+
+      #
+      # set configuration value
+      #
+      #   config = DuckDB::Config.new
+      #   # config.set_config('default_order', 'DESC')
+      #   config['default_order'] = 'DESC'
+      #
+      #   db = DuckDB::Database.open(nil, config)
+      #   con = db.connect
+      #   con.query('CREATE TABLE numbers (number INTEGER)')
+      #   con.query('INSERT INTO numbers VALUES (2), (1), (4), (3)')
+      #
+      #   # numbers are ordered by descending.
+      #   r = con.query('SELECT number FROM numbers ORDER BY number)
+      #   r.first.first # => 4
+      alias []= set_config
+    end
+  end
+end

data/lib/duckdb/connection.rb

@@ -52,6 +52,27 @@ module DuckDB
       PreparedStatement.new(self, str)
     end
 
+    #
+    # returns Appender object.
+    # The first argument is table name
+    #
+    def appender(table)
+      appender = create_appender(table)
+
+      return appender unless block_given?
+
+      yield appender
+      appender.flush
+      appender.close
+    end
+
+    private
+
+    def create_appender(table)
+      t1, t2 = table.split('.')
+      t2 ? Appender.new(self, t1, t2) : Appender.new(self, t2, t1)
+    end
+
     alias execute query
     alias open connect
     alias close disconnect

data/lib/duckdb/database.rb

@@ -21,6 +21,7 @@ module DuckDB
   #
   class Database
     private_class_method :_open
+    private_class_method :_open_ext if defined?(DuckDB::Config)
 
     class << self
       ##
@@ -38,8 +39,8 @@ module DuckDB
       #     con.query('CREATE TABLE users (id INTEGER, name VARCHAR(30))')
       #   end
       #
-      def open(*args)
-        db = _open(*args)
+      def open(dbpath = nil, config = nil)
+        db = _db_open(dbpath, config)
         return db unless block_given?
 
         begin
@@ -48,6 +49,18 @@ module DuckDB
           db.close
         end
       end
+
+      private
+
+      def _db_open(dbpath, config)
+        if defined?(DuckDB::Config) && config
+          _open_ext(dbpath, config)
+        elsif config
+          _open(dbpath, config)
+        else
+          _open(dbpath)
+        end
+      end
     end
 
     ##

data/lib/duckdb/prepared_statement.rb

@@ -13,6 +13,19 @@ module DuckDB
   #   stmt.execute
   class PreparedStatement
 
+    RANGE_INT16 = -32768..32767
+    RANGE_INT32 = -2147483648..2147483647
+    RANGE_INT64 = -9223372036854775808..9223372036854775807
+
+    def bind_hugeint(i, value)
+      case value
+      when Integer
+        bind_varchar(i, value.to_s)
+      else
+        raise(ArgumentError, "2nd argument `#{value}` must be Integer.")
+      end
+    end
+
     # binds i-th parameter with SQL prepared statement.
     # The first argument is index of parameter. The index of first parameter is
     # 1 not 0.
@@ -27,11 +40,16 @@ module DuckDB
     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')
+        respond_to?(:bind_null) ? bind_null(i) : 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)
+        case value
+        when RANGE_INT64
+          bind_int64(i, value)
+        else
+          bind_varchar(i, value.to_s)
+        end
       when String
         if defined?(DuckDB::Blob)
           blob?(value) ? bind_blob(i, value) : bind_varchar(i, value)
@@ -39,13 +57,13 @@ module DuckDB
           bind_varchar(i, value)
         end
       when TrueClass, FalseClass
-        bind_boolean(i, value)
+        bind_bool(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)")
+        raise(DuckDB::Error, "not supported type `#{value}` (#{value.class})")
       end
     end
 

data/lib/duckdb/version.rb

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

data/lib/duckdb.rb

@@ -4,6 +4,8 @@ require 'duckdb/database'
 require 'duckdb/connection'
 require 'duckdb/result'
 require 'duckdb/prepared_statement'
+require 'duckdb/appender'
+require 'duckdb/config'
 
 # DuckDB provides Ruby interface of DuckDB.
 module DuckDB

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: duckdb
 version: !ruby/object:Gem::Version
-  version: 0.2.6.0
+  version: 0.2.9.0
 platform: ruby
 authors:
 - Masaki Suketa
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-22 00:00:00.000000000 Z
+date: 2021-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -77,9 +77,10 @@ extra_rdoc_files: []
 files:
 - ".github/workflows/test_on_macos.yml"
 - ".github/workflows/test_on_ubuntu.yml"
+- ".github/workflows/test_on_windows.yml"
 - ".gitignore"
-- ".travis.yml"
 - CHANGELOG.md
+- CONTRIBUTION.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -92,6 +93,8 @@ files:
 - ext/duckdb/appender.h
 - ext/duckdb/blob.c
 - ext/duckdb/blob.h
+- ext/duckdb/config.c
+- ext/duckdb/config.h
 - ext/duckdb/connection.c
 - ext/duckdb/connection.h
 - ext/duckdb/database.c
@@ -106,6 +109,8 @@ files:
 - ext/duckdb/result.h
 - ext/duckdb/ruby-duckdb.h
 - lib/duckdb.rb
+- lib/duckdb/appender.rb
+- lib/duckdb/config.rb
 - lib/duckdb/connection.rb
 - lib/duckdb/database.rb
 - lib/duckdb/prepared_statement.rb
@@ -118,7 +123,7 @@ metadata:
   homepage_uri: https://github.com/suketa/ruby-duckdb
   source_code_uri: https://github.com/suketa/ruby-duckdb
   changelog_uri: https://github.com/suketa/ruby-duckdb/blob/master/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -126,15 +131,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.0.dev
-signing_key: 
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
 summary: This module is Ruby binding for DuckDB database engine.
 test_files: []

data/.travis.yml

@@ -1,18 +0,0 @@
-language: ruby
-cache:
-  bundler: true
-  directories:
-    - ${HOME}/duckdb-v0.2.6
-before_install:
-  - yes | gem update --system
-  - if [[ ! -d ${HOME}/duckdb-v0.2.6/build ]]; then cd ${HOME} && git clone -b v0.2.6 https://github.com/cwida/duckdb.git duckdb-v0.2.6 && cd duckdb-v0.2.6 && make && cd ${TRAVIS_BUILD_DIR}; fi
-
-env:
-  - DUCKDB_VERSION=0.2.6
-rvm:
-  - 2.5.8
-  - 2.6.7
-  - 2.7.3
-  - 3.0.1
-  - 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/