duckdb 0.2.6.1 → 0.3.1.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/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

@@ -22,7 +22,7 @@ module DuckDB
       when Integer
         bind_varchar(i, value.to_s)
       else
-        rb_raise(ArgumentError, "2nd argument `#{value}` must be Integer.")
+        raise(ArgumentError, "2nd argument `#{value}` must be Integer.")
       end
     end
 
@@ -40,7 +40,7 @@ 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
@@ -63,7 +63,7 @@ module DuckDB
       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.1'.freeze
+  VERSION = '0.3.1.0'.freeze
 end

data/lib/duckdb.rb

@@ -5,6 +5,7 @@ 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.1
+  version: 0.3.1.0
 platform: ruby
 authors:
 - Masaki Suketa
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-06-14 00:00:00.000000000 Z
+date: 2021-11-20 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
@@ -107,6 +110,7 @@ files:
 - 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
@@ -127,14 +131,14 @@ 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.2.15
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: This module is Ruby binding for DuckDB database engine.

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/