duckdb 0.2.9.0 → 0.3.3.0

data/lib/duckdb/prepared_statement.rb

@@ -1,4 +1,5 @@
 require 'date'
+require_relative './converter'
 
 module DuckDB
   # The DuckDB::PreparedStatement encapsulates connection with DuckDB prepared
@@ -12,6 +13,7 @@ module DuckDB
   #   stmt.bind(1, 'email@example.com')
   #   stmt.execute
   class PreparedStatement
+    include DuckDB::Converter
 
     RANGE_INT16 = -32768..32767
     RANGE_INT32 = -2147483648..2147483647
@@ -27,8 +29,113 @@ module DuckDB
     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.
+    # The first argument is index of parameter.
+    # The index of first parameter is 1 not 0.
+    # The second argument value is to expected date.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open('duckdb_database')
+    #   con = db.connect
+    #   sql ='SELECT name FROM users WHERE birth_day = ?'
+    #   stmt = PreparedStatement.new(con, sql)
+    #   stmt.bind(1, Date.today)
+    #   #  or you can specify date string.
+    #   # stmt.bind(1, '2021-02-23')
+    def bind_date(i, value)
+      case value
+      when Date, Time
+        date = value
+      else
+        begin
+          date = Date.parse(value)
+        rescue => e
+          raise(ArgumentError, "Cannot parse argument value to date. #{e.message}")
+        end
+      end
+
+      _bind_date(i, date.year, date.month, date.day)
+    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.
+    # The second argument value is to expected time value.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open('duckdb_database')
+    #   con = db.connect
+    #   sql ='SELECT name FROM users WHERE birth_time = ?'
+    #   stmt = PreparedStatement.new(con, sql)
+    #   stmt.bind(1, Time.now)
+    #   #  or you can specify time string.
+    #   # stmt.bind(1, '07:39:45')
+    def bind_time(i, value)
+      case value
+      when Time
+        time = value
+      else
+        begin
+          time = Time.parse(value)
+        rescue => e
+          raise(ArgumentError, "Cannot parse argument value to time. #{e.message}")
+        end
+      end
+
+      _bind_time(i, time.hour, time.min, time.sec, time.usec)
+    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.
+    # The second argument value is to expected time value.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open('duckdb_database')
+    #   con = db.connect
+    #   sql ='SELECT name FROM users WHERE created_at = ?'
+    #   stmt = PreparedStatement.new(con, sql)
+    #   stmt.bind(1, Time.now)
+    #   #  or you can specify timestamp string.
+    #   # stmt.bind(1, '2022-02-23 07:39:45')
+    def bind_timestamp(i, value)
+      case value
+      when Time
+        time = value
+      else
+        begin
+          time = Time.parse(value)
+        rescue => e
+          raise(ArgumentError, "Cannot parse argument value to time. #{e.message}")
+        end
+      end
+
+      _bind_timestamp(i, time.year, time.month, time.day, time.hour, time.min, time.sec, time.usec)
+    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.
+    # The second argument value is to expected ISO8601 time interval string.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open('duckdb_database')
+    #   con = db.connect
+    #   sql ='SELECT value FROM intervals WHERE interval = ?'
+    #   stmt = PreparedStatement.new(con, sql)
+    #   stmt.bind(1, 'P1Y2D')
+    def bind_interval(i, value)
+      raise ArgumentError, "Argument `#{value}` must be a string." unless value.is_a?(String)
+
+      hash = iso8601_interval_to_hash(value)
+
+      months, days, micros = hash_to__append_interval_args(hash)
+
+      _bind_interval(i, months, days, micros)
+    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.
     # The second argument value is the value of prepared statement parameter.
     #
     #   require 'duckdb'
@@ -40,7 +147,7 @@ module DuckDB
     def bind(i, value)
       case value
       when NilClass
-        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')
+        bind_null(i)
       when Float
         bind_double(i, value)
       when Integer
@@ -51,11 +158,7 @@ module DuckDB
           bind_varchar(i, value.to_s)
         end
       when String
-        if defined?(DuckDB::Blob)
-          blob?(value) ? bind_blob(i, value) : bind_varchar(i, value)
-        else
-          bind_varchar(i, value)
-        end
+        blob?(value) ? bind_blob(i, value) : bind_varchar(i, value)
       when TrueClass, FalseClass
         bind_bool(i, value)
       when Time

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.9.0'.freeze
+  VERSION = '0.3.3.0'.freeze
 end

data/lib/duckdb.rb

@@ -1,11 +1,13 @@
 require 'duckdb/duckdb_native'
 require 'duckdb/version'
+require 'duckdb/converter'
 require 'duckdb/database'
 require 'duckdb/connection'
 require 'duckdb/result'
 require 'duckdb/prepared_statement'
 require 'duckdb/appender'
 require 'duckdb/config'
+require 'duckdb/column'
 
 # 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.9.0
+  version: 0.3.3.0
 platform: ruby
 authors:
 - Masaki Suketa
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-24 00:00:00.000000000 Z
+date: 2022-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -93,6 +93,8 @@ files:
 - ext/duckdb/appender.h
 - ext/duckdb/blob.c
 - ext/duckdb/blob.h
+- ext/duckdb/column.c
+- ext/duckdb/column.h
 - ext/duckdb/config.c
 - ext/duckdb/config.h
 - ext/duckdb/connection.c
@@ -108,10 +110,14 @@ files:
 - ext/duckdb/result.c
 - ext/duckdb/result.h
 - ext/duckdb/ruby-duckdb.h
+- ext/duckdb/util.c
+- ext/duckdb/util.h
 - lib/duckdb.rb
 - lib/duckdb/appender.rb
+- lib/duckdb/column.rb
 - lib/duckdb/config.rb
 - lib/duckdb/connection.rb
+- lib/duckdb/converter.rb
 - lib/duckdb/database.rb
 - lib/duckdb/prepared_statement.rb
 - lib/duckdb/result.rb
@@ -138,7 +144,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.10
 signing_key:
 specification_version: 4
 summary: This module is Ruby binding for DuckDB database engine.