duckdb 0.0.12 → 0.2.8.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

@@ -44,6 +44,35 @@ module DuckDB
       end
     end
 
+    #
+    # returns PreparedStatement object.
+    # The first argument is SQL string.
+    #
+    def prepared_statement(str)
+      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
+        rb_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.
@@ -31,7 +44,12 @@ module DuckDB
       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,7 +57,7 @@ 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

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.0.12'.freeze
+  VERSION = '0.2.8.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.0.12
+  version: 0.2.8.0
 platform: ruby
 authors:
 - Masaki Suketa
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-13 00:00:00.000000000 Z
+date: 2021-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -77,6 +77,7 @@ 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
@@ -88,8 +89,12 @@ files:
 - bin/console
 - bin/setup
 - duckdb.gemspec
+- ext/duckdb/appender.c
+- 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
@@ -104,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
@@ -116,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
@@ -131,8 +138,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
-signing_key: 
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
 summary: This module is Ruby binding for DuckDB database engine.
 test_files: []