duckdb 1.1.3.1 → 1.2.1.0

data/lib/duckdb/interval.rb

@@ -24,11 +24,11 @@ module DuckDB
   #   con.query('CREATE TABLE intervals (interval_value INTERVAL)')
   #   appender = con.appender('intervals')
   #   appender
-  #     .begin_row
   #     .append_interval(interval)
   #     .end_row
   #     .flush
   class Interval
+    # :stopdoc:
     ISO8601_REGEXP = Regexp.compile(
       '(?<negativ>-{0,1})P
       (?<year>-{0,1}\d+Y){0,1}
@@ -40,6 +40,8 @@ module DuckDB
       ((?<sec>-{0,1}\d+)\.{0,1}(?<usec>\d*)S){0,1}',
       Regexp::EXTENDED
     )
+    private_constant :ISO8601_REGEXP
+    # :startdoc:
 
     class << self
       # parses the ISO8601 format string and return the Interval object.
@@ -93,7 +95,7 @@ module DuckDB
 
       private
 
-      def matched_to_i(matched)
+      def matched_to_i(matched) # :nodoc:
         sign = to_sign(matched)
         sec = to_sec(matched)
         usec = to_usec(matched)
@@ -104,35 +106,35 @@ module DuckDB
         sign.positive? ? value : value.map { |v| v * sign }
       end
 
-      def to_sign(matched)
+      def to_sign(matched) # :nodoc:
         matched[:negativ] == '-' ? -1 : 1
       end
 
-      def to_year(matched)
+      def to_year(matched) # :nodoc:
         matched[:year].to_i
       end
 
-      def to_month(matched)
+      def to_month(matched) # :nodoc:
         matched[:month].to_i
       end
 
-      def to_day(matched)
+      def to_day(matched) # :nodoc:
         matched[:day].to_i
       end
 
-      def to_hour(matched)
+      def to_hour(matched) # :nodoc:
         matched[:hour].to_i
       end
 
-      def to_min(matched)
+      def to_min(matched) # :nodoc:
         matched[:min].to_i
       end
 
-      def to_sec(matched)
+      def to_sec(matched) # :nodoc:
         matched[:sec].to_i
       end
 
-      def to_usec(matched)
+      def to_usec(matched) # :nodoc:
         matched[:usec].to_s.ljust(6, '0')[0, 6].to_i
       end
     end

data/lib/duckdb/logical_type.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module DuckDB
+  class LogicalType
+    # returns logical type's type symbol
+    # `:unknown` means that the logical type's type is unknown/unsupported by ruby-duckdb.
+    # `:invalid` means that the logical type's type is invalid in duckdb.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open
+    #   con = db.connect
+    #   con.query('CREATE TABLE climates (id INTEGER, temperature DECIMAIL)')
+    #
+    #   users = con.query('SELECT * FROM climates')
+    #   columns = users.columns
+    #   columns.second.logical_type.type #=> :decimal
+    def type
+      type_id = _type
+      DuckDB::Converter::IntToSym.type_to_sym(type_id)
+    end
+
+    # Iterates over each union member name.
+    #
+    # When a block is provided, this method yields each union member name in
+    # order. It also returns the total number of members yielded.
+    #
+    #   union_logical_type.each_member_name do |name|
+    #     puts "Union member: #{name}"
+    #   end
+    #
+    # If no block is given, an Enumerator is returned, which can be used to
+    # retrieve all member names.
+    #
+    #   names = union_logical_type.each_member_name.to_a
+    #   # => ["member1", "member2"]
+    def each_member_name
+      return to_enum(__method__) {member_count} unless block_given?
+
+      member_count.times do |i|
+        yield member_name_at(i)
+      end
+    end
+
+    # Iterates over each union member type.
+    #
+    # When a block is provided, this method yields each union member logical
+    # type in order. It also returns the total number of members yielded.
+    #
+    #   union_logical_type.each_member_type do |logical_type|
+    #     puts "Union member: #{logical_type.type}"
+    #   end
+    #
+    # If no block is given, an Enumerator is returned, which can be used to
+    # retrieve all member logical types.
+    #
+    #   names = union_logical_type.each_member_type.map(&:type)
+    #   # => [:varchar, :integer]
+    def each_member_type
+      return to_enum(__method__) {member_count} unless block_given?
+
+      member_count.times do |i|
+        yield member_type_at(i)
+      end
+    end
+
+    # Iterates over each struct child name.
+    #
+    # When a block is provided, this method yields each struct child name in
+    # order. It also returns the total number of children yielded.
+    #
+    #   struct_logical_type.each_child_name do |name|
+    #     puts "Struct child: #{name}"
+    #   end
+    #
+    # If no block is given, an Enumerator is returned, which can be used to
+    # retrieve all child names.
+    #
+    #   names = struct_logical_type.each_child_name.to_a
+    #   # => ["child1", "child2"]
+    def each_child_name
+      return to_enum(__method__) {child_count} unless block_given?
+
+      child_count.times do |i|
+        yield child_name_at(i)
+      end
+    end
+
+    # Iterates over each struct child type.
+    #
+    # When a block is provided, this method yields each struct child type in
+    # order. It also returns the total number of children yielded.
+    #
+    #   struct_logical_type.each_child_type do |logical_type|
+    #     puts "Struct child type: #{logical_type.type}"
+    #   end
+    #
+    # If no block is given, an Enumerator is returned, which can be used to
+    # retrieve all child logical types.
+    #
+    #   types = struct_logical_type.each_child_type.map(&:type)
+    #   # => [:integer, :varchar]
+    def each_child_type
+      return to_enum(__method__) {child_count} unless block_given?
+
+      child_count.times do |i|
+        yield child_type_at(i)
+      end
+    end
+  end
+end

data/lib/duckdb/pending_result.rb

@@ -19,7 +19,7 @@ module DuckDB
   #   end
   #   result = pending_result.execute_pending
   class PendingResult
-    STATES = %i[ready not_ready error no_tasks].freeze
+    STATES = %i[ready not_ready error no_tasks].freeze # :nodoc:
 
     # returns the state of the pending result.
     # the result can be :ready, :not_ready, :error, :no_tasks.

data/lib/duckdb/prepared_statement.rb

@@ -135,7 +135,7 @@ module DuckDB
     #   require 'duckdb'
     #   db = DuckDB::Database.open('duckdb_database')
     #   con = db.connect
-    #   sql ='SELECT name FROM users WHERE bigint_col = ?'
+    #   sql ='SELECT name FROM users WHERE hugeint_col = ?'
     #   stmt = PreparedStatement.new(con, sql)
     #   stmt.bind_hugeint_internal(1, 1_234_567_890_123_456_789_012_345)
     def bind_hugeint_internal(index, value)
@@ -143,6 +143,23 @@ module DuckDB
       _bind_hugeint(index, lower, upper)
     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 must be Integer value.
+    # This method uses duckdb_bind_uhugeint internally.
+    #
+    #   require 'duckdb'
+    #   db = DuckDB::Database.open('duckdb_database')
+    #   con = db.connect
+    #   sql ='SELECT name FROM users WHERE uhugeint_col = ?'
+    #   stmt = PreparedStatement.new(con, sql)
+    #   stmt.bind_uhugeint(1, (2**128) - 1)
+    def bind_uhugeint(index, value)
+      lower, upper = integer_to_hugeint(value)
+      _bind_uhugeint(index, lower, upper)
+    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.

data/lib/duckdb/result.rb

@@ -27,39 +27,39 @@ module DuckDB
     RETURN_TYPES = %i[invalid changed_rows nothing query_result].freeze
 
     alias column_size column_count
-    alias row_size row_count
+
+    @use_chunk_each = false
 
     class << self
       def new
         raise DuckDB::Error, 'DuckDB::Result cannot be instantiated directly.'
       end
 
-      def use_chunk_each=(value) # :nodoc:
-        raise('`changing DuckDB::Result.use_chunk_each to false` was deprecated.') unless value
-
-        warn('`DuckDB::Result.use_chunk_each=` will be deprecated.')
-
-        true
-      end
+      attr_writer :use_chunk_each
 
-      def use_chunk_each? # :nodoc:
-        warn('`DuckDB::Result.use_chunk_each?` will be deprecated.')
-        true
+      def use_chunk_each?
+        @use_chunk_each
       end
     end
 
     def each(&)
-      if streaming?
-        return _chunk_stream unless block_given?
-
-        _chunk_stream(&)
-      else
+      if self.class.use_chunk_each?
         return chunk_each unless block_given?
 
         chunk_each(&)
+      else
+        return _chunk_stream unless block_given?
+
+        _chunk_stream(&)
       end
     end
 
+    # :nodoc:
+    def chunk_each(&)
+      warn 'DuckDB::Result#chunk_each will be deprecated.'
+      _chunk_each(&)
+    end
+
     # returns return type. The return value is one of the following symbols:
     #  :invalid, :changed_rows, :nothing, :query_result
     #

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.1.3.1'
+  VERSION = '1.2.1.0'
 end

data/lib/duckdb.rb

@@ -13,6 +13,7 @@ require 'duckdb/pending_result'
 require 'duckdb/appender'
 require 'duckdb/config'
 require 'duckdb/column'
+require 'duckdb/logical_type'
 require 'duckdb/infinity'
 
 # DuckDB provides Ruby interface of DuckDB.

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: duckdb
 version: !ruby/object:Gem::Version
-  version: 1.1.3.1
+  version: 1.2.1.0
 platform: ruby
 authors:
 - Masaki Suketa
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-11-27 00:00:00.000000000 Z
+date: 2025-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -91,10 +90,12 @@ extra_rdoc_files: []
 files:
 - ".gitattributes"
 - ".github/FUNDING.yml"
+- ".github/workflows/make_documents.yml"
 - ".github/workflows/test_on_macos.yml"
 - ".github/workflows/test_on_ubuntu.yml"
 - ".github/workflows/test_on_windows.yml"
 - ".gitignore"
+- ".rdoc_options"
 - CHANGELOG.md
 - CONTRIBUTION.md
 - Dockerfile
@@ -131,6 +132,8 @@ files:
 - ext/duckdb/extconf.rb
 - ext/duckdb/extracted_statements.c
 - ext/duckdb/extracted_statements.h
+- ext/duckdb/logical_type.c
+- ext/duckdb/logical_type.h
 - ext/duckdb/pending_result.c
 - ext/duckdb/pending_result.h
 - ext/duckdb/prepared_statement.c
@@ -153,6 +156,7 @@ files:
 - lib/duckdb/infinity.rb
 - lib/duckdb/interval.rb
 - lib/duckdb/library_version.rb
+- lib/duckdb/logical_type.rb
 - lib/duckdb/pending_result.rb
 - lib/duckdb/prepared_statement.rb
 - lib/duckdb/result.rb
@@ -163,10 +167,10 @@ homepage: https://github.com/suketa/ruby-duckdb
 licenses:
 - MIT
 metadata:
+  rubygems_mfa_required: 'true'
   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: 
 rdoc_options: []
 require_paths:
 - lib
@@ -181,8 +185,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: This module is Ruby binding for DuckDB database engine.
 test_files: []