duckdb 1.5.2.0 → 1.5.3.0

data/lib/duckdb/prepared_statement.rb

@@ -250,6 +250,24 @@ module DuckDB
       _bind_timestamp(index, time.year, time.month, time.day, time.hour, time.min, time.sec, time.usec)
     end
 
+    # binds i-th parameter of TIMESTAMP WITH TIME ZONE (TIMESTAMPTZ) type 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_timestamp_tz(1, Time.now)
+    #   #  or you can specify timestamp string.
+    #   # stmt.bind_timestamp_tz(1, '2022-02-23 07:39:45+00')
+    def bind_timestamp_tz(index, value)
+      time = _parse_time(value).utc
+      _bind_timestamp_tz(index, 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.
@@ -281,7 +299,7 @@ module DuckDB
     def bind_decimal(index, value)
       decimal = _parse_deciaml(value)
       lower, upper = decimal_to_hugeint(decimal)
-      width = decimal.to_s('F').gsub(/[^0-9]/, '').length
+      width = _decimal_width(decimal)
       _bind_decimal(index, lower, upper, width, decimal.scale)
     end
 

data/lib/duckdb/result.rb

@@ -81,11 +81,48 @@ module DuckDB
     #   result = con.query('SELECT * FROM enums')
     #   result.enum_dictionary_values(1) # => ['sad', 'ok', 'happy', '𝘾𝝾օɭ 😎']
     def enum_dictionary_values(col_index)
+      column = columns[col_index]
+
+      raise ArgumentError, "Invalid index: #{col_index}" if column.nil? || col_index.negative?
+
+      lt = column.logical_type
+
+      raise DuckDB::Error, "Column[#{col_index}] type is not enum" if lt.type != :enum
+
       values = []
-      _enum_dictionary_size(col_index).times do |i|
-        values << _enum_dictionary_value(col_index, i)
+      lt.dictionary_size.times do |i|
+        values << lt.dictionary_value_at(i)
       end
       values
     end
+
+    private
+
+    def _enum_dictionary_size(idx)
+      warn(":_enum_dictionary_size is deprecated. use columns[#{idx}].logical_type.dictionary_size instead.")
+
+      raise ArgumentError, "Invalid index: #{idx}" if idx.negative?
+
+      columns[idx]&.logical_type&.dictionary_size
+    end
+
+    def _enum_dictionary_value(col_index, idx)
+      warn(":_enum_dictionary_value is deprecated.\
+           use columns[#{col_index}].logical_type.dictionary_value_at(#{idx}) instead.")
+
+      raise ArgumentError, "Invalid index: #{col_index}" if col_index.negative?
+
+      lt = columns[col_index]&.logical_type
+
+      raise DuckDB::Error, "Column[#{col_index}] type is not enum" if lt&.type != :enum
+
+      lt.dictionary_value_at(idx)
+    end
+
+    def _column_type(idx)
+      warn(":_column_type is deprecated. use columns[#{idx}].send(:_type) instead.")
+
+      columns[idx].send(:_type)
+    end
   end
 end

data/lib/duckdb/scalar_function.rb

@@ -7,8 +7,7 @@ module DuckDB
   class ScalarFunction
     # Create and configure a scalar function in one call
     #
-    # @param name [String, Symbol, nil] the function name; use +nil+ when creating overloads
-    #   intended for use in a +DuckDB::ScalarFunctionSet+ (the set provides the name)
+    # @param name [String, Symbol] the function name (required)
     # @param return_type [DuckDB::LogicalType|:logical_type_symbol] the return type
     # @param parameter_type [DuckDB::LogicalType|:logical_type_symbol, nil] single fixed parameter type
     # @param parameter_types [Array<DuckDB::LogicalType|:logical_type_symbol>, nil] multiple fixed parameter types
@@ -64,7 +63,7 @@ module DuckDB
     #     null_handling: true
     #   ) { |v| v.nil? ? 0 : v }
     def self.create( # rubocop:disable Metrics/MethodLength,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity,Metrics/ParameterLists
-      return_type:, name: nil, parameter_type: nil, parameter_types: nil, varargs_type: nil, null_handling: false, &
+      name:, return_type:, parameter_type: nil, parameter_types: nil, varargs_type: nil, null_handling: false, &
     )
       raise ArgumentError, 'Block required' unless block_given?
       raise ArgumentError, 'Cannot specify both parameter_type and parameter_types' if parameter_type && parameter_types
@@ -78,7 +77,7 @@ module DuckDB
                end
 
       sf = new
-      sf.name = name.to_s if name
+      sf.name = name
       sf.return_type = return_type
       params.each { |type| sf.add_parameter(type) }
       sf.varargs_type = varargs_type if varargs_type
@@ -87,6 +86,12 @@ module DuckDB
       sf
     end
 
+    def name=(value)
+      set_name(value.to_s)
+    end
+
+    private :set_name
+
     include FunctionTypeValidation
 
     # Adds a parameter to the scalar function.

data/lib/duckdb/scalar_function_set.rb

@@ -24,7 +24,6 @@ module DuckDB
         raise TypeError, "#{scalar_function.class} is not a DuckDB::ScalarFunction"
       end
 
-      scalar_function.name = @name
       _add(scalar_function)
     end
   end

data/lib/duckdb/table_description.rb

@@ -21,11 +21,17 @@ module DuckDB
     #   # id: integer, default=false
     #   # name: varchar, default=true
     class TableDescription
+      include DuckDB::TableNameParser
+
       # Creates a new TableDescription for the given table.
       #
       # +con+ must be a DuckDB::Connection. +table+ is the table name (String).
       # Optionally pass +schema:+ and/or +catalog:+ to qualify the table.
       #
+      # The +table+ argument supports dot-notation and quoting:
+      # - <tt>'schema.table'</tt> — interpreted as schema-qualified (deprecated; use +schema:+ instead)
+      # - <tt>'"a.b"'</tt> or <tt>"'a.b'"</tt> — treated as a literal table name containing a dot
+      #
       # Raises DuckDB::Error if the connection is invalid, the table name is nil,
       # or the table (or schema/catalog) does not exist.
       #
@@ -40,6 +46,7 @@ module DuckDB
         raise DuckDB::Error, '1st argument must be DuckDB::Connection object.' unless con.is_a?(DuckDB::Connection)
         raise DuckDB::Error, '2nd argument must be table name.' if table.nil?
 
+        table, schema, catalog = parse_table_name(table, schema, catalog)
         raise DuckDB::Error, error_message unless _initialize(con, catalog, schema, table)
       end
 

data/lib/duckdb/table_function.rb

@@ -163,7 +163,6 @@ module DuckDB
       #
       #   # Register and use:
       #   DuckDB::TableFunction.add_table_adapter(CSV, CSVTableAdapter.new)
-      #   con.execute('SET threads=1')
       #   con.expose_as_table(csv, 'csv_table')
       #   con.query('SELECT * FROM csv_table()').to_a
       #

data/lib/duckdb/table_name_parser.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module DuckDB
+  # DuckDB::TableNameParser provides shared table name parsing for classes that
+  # accept a table name argument, such as DuckDB::Appender and DuckDB::TableDescription.
+  #
+  # It handles:
+  # - Dot-notation: <tt>'schema.table'</tt> is split into schema and table (deprecated).
+  # - Quoting: <tt>'"a.b"'</tt> or <tt>"'a.b'"</tt> strips the quotes and treats the name literally.
+  module TableNameParser
+    private
+
+    # Parses +table+, +schema+, and +catalog+, handling quoting and dot-notation.
+    # Returns <tt>[table, schema, catalog]</tt>.
+    def parse_table_name(table, schema, catalog)
+      if quoted_table_name?(table)
+        [unquote_table_name(table), schema, catalog]
+      elsif table.include?('.')
+        warn_dot_notation_deprecated(table)
+        dot_notation_split(table, schema, catalog)
+      else
+        [table, schema, catalog]
+      end
+    end
+
+    def quoted_table_name?(name) # :nodoc:
+      name.match?(/\A(["']).*\1\z/)
+    end
+
+    def unquote_table_name(name) # :nodoc:
+      name[1..-2]
+    end
+
+    # Splits a dot-notation string into [table, schema, catalog].
+    # Explicit keyword args take precedence over dot-notation parts.
+    def dot_notation_split(table, schema, catalog) # :nodoc:
+      parts = table.split('.')
+      raise ArgumentError, "Too many dot-separated segments in '#{table}'" if parts.length > 3
+
+      case parts.length
+      when 2 then [parts[1], schema || parts[0], catalog]
+      when 3 then [parts[2], schema || parts[1], catalog || parts[0]]
+      else raise ArgumentError, "Unexpected segment count in '#{table}'"
+      end
+    end
+
+    def warn_dot_notation_deprecated(table) # :nodoc:
+      class_name = self.class.name
+      warn(
+        "Passing dot-notation '#{table}' to #{class_name}.new is deprecated. " \
+        "If '#{table}' is a schema-qualified table, use #{class_name}.new(con, table, schema: schema) instead. " \
+        "If '#{table}' is a literal table name containing a dot, " \
+        "use #{class_name}.new(con, '\"#{table}\"') instead.",
+        category: :deprecated
+      )
+    end
+  end
+end

data/lib/duckdb/value.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'bigdecimal'
+
 module DuckDB
   class Value
     class << self
@@ -219,6 +221,23 @@ module DuckDB
         _create_uhugeint(lower, upper)
       end
 
+      # Creates a DuckDB::Value of DECIMAL type.
+      #
+      #   value = DuckDB::Value.create_decimal(BigDecimal('12345.678'))
+      #
+      # @param value [BigDecimal] the decimal value.
+      # @return [DuckDB::Value] the created Value object.
+      # @raise [ArgumentError] if +value+ is not a BigDecimal or its width is out of range (1..38).
+      def create_decimal(value)
+        check_type!(value, BigDecimal)
+
+        width = _decimal_width(value)
+        check_range!(width, RANGE_DECIMAL_WIDTH, 'DECIMAL width')
+
+        lower, upper = decimal_to_hugeint(value)
+        _create_decimal(lower, upper, width, value.scale)
+      end
+
       private
 
       def check_range!(value, range, type_name)

data/lib/duckdb/version.rb

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

data/lib/duckdb.rb

@@ -4,6 +4,7 @@ require 'duckdb/duckdb_native'
 require 'duckdb/library_version'
 require 'duckdb/version'
 require 'duckdb/converter'
+require 'duckdb/table_name_parser'
 require 'duckdb/database'
 require 'duckdb/connection'
 require 'duckdb/extracted_statements'
@@ -18,6 +19,7 @@ require 'duckdb/function_type_validation'
 require 'duckdb/scalar_function'
 require 'duckdb/scalar_function_set'
 require 'duckdb/aggregate_function'
+require 'duckdb/aggregate_function_set'
 require 'duckdb/expression'
 require 'duckdb/client_context'
 require 'duckdb/scalar_function/bind_info'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: duckdb
 version: !ruby/object:Gem::Version
-  version: 1.5.2.0
+  version: 1.5.3.0
 platform: ruby
 authors:
 - Masaki Suketa
@@ -40,8 +40,11 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- duckdb.gemspec
 - ext/duckdb/aggregate_function.c
 - ext/duckdb/aggregate_function.h
+- ext/duckdb/aggregate_function_set.c
+- ext/duckdb/aggregate_function_set.h
 - ext/duckdb/appender.c
 - ext/duckdb/appender.h
 - ext/duckdb/blob.c
@@ -109,6 +112,7 @@ files:
 - ext/duckdb/vector.h
 - lib/duckdb.rb
 - lib/duckdb/aggregate_function.rb
+- lib/duckdb/aggregate_function_set.rb
 - lib/duckdb/appender.rb
 - lib/duckdb/casting.rb
 - lib/duckdb/client_context.rb
@@ -120,7 +124,6 @@ files:
 - lib/duckdb/converter/int_to_sym.rb
 - lib/duckdb/data_chunk.rb
 - lib/duckdb/database.rb
-- lib/duckdb/duckdb_native.so
 - lib/duckdb/expression.rb
 - lib/duckdb/extracted_statements.rb
 - lib/duckdb/function_type_validation.rb
@@ -140,6 +143,7 @@ files:
 - lib/duckdb/table_function/bind_info.rb
 - lib/duckdb/table_function/function_info.rb
 - lib/duckdb/table_function/init_info.rb
+- lib/duckdb/table_name_parser.rb
 - lib/duckdb/value.rb
 - lib/duckdb/vector.rb
 - lib/duckdb/version.rb
@@ -165,7 +169,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Ruby bindings for the DuckDB database engine.
 test_files: []