pg_conn 0.22.0 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d8571dfbe07ffc9e846741807d87d45373553d987e353693aa4599010804b3e
-  data.tar.gz: 4d0bd8faced962ac9c0837b3a98f1a6f0ee4fbc0c1c1aa4a12c448472e10376a
+  metadata.gz: d7de75668042e3abdc5b983e0b9a3f6c909ff69aeed2f22c632d1c693f3baac0
+  data.tar.gz: 90cecbdd79e6478d7f6bd1bc3ae042917bc2683771c89de61aab6c05fa2e5279
 SHA512:
-  metadata.gz: 3b3ff2ae7e1fa63f697616e16eff4065e5118ef5fe9cb446837cc30b028df5a385b56848e23546c7718f5f704e622cd35175acbd56aacd6fd56774dec9c34627
-  data.tar.gz: 4c9428ef6abc6162c068f154575eb1d8c7b63c1aa072af4350c7bacb2c6ea63e0ffea80a470f9ca8b72c635e83ceda7345b54bc6a24d5adc450bf0863fb0df1b
+  metadata.gz: 76b775138260668bf75e5bc31e220561f665dffc901349a9ec875e7ec594dee2750e0d979bde80e9045e38e44a3894fe55c2be37faefbe7f35173812cea2a22a
+  data.tar.gz: f0e2e9169cd734814cce4e8b73f7ec017cf3fd9a2622290c4acbf06620ddb3b943957ab5dab527ee0e29a9d71ad4efb511f4f219543ca86301d9fd5c4f5838ad

data/TODO

@@ -1,5 +1,6 @@
 TODO
-  o "use 'drop ... cascade' everywhere
+  o Use :elem_type everywhere
+  o Use 'drop ... cascade' everywhere
   o db.context(schema: app_portal, transaction: true) { ... }
     db.context(set: app_portal, transaction: true) { ... }
     db.context(add: app_portal, transaction: true) { ... }

data/lib/pg_conn/version.rb

@@ -1,3 +1,3 @@
 module PgConn
-  VERSION = "0.22.0"
+  VERSION = "0.23.0"
 end

data/lib/pg_conn.rb

@@ -239,12 +239,16 @@ module PgConn
       end
     end
 
-    # Quote value as an identifier. Value should be a non-nil string or a symbol
+    # Quote argument as an identifier. The argument should be a non-nil string
+    # or a symbol
     def quote_identifier(s)
       s = s.to_s if s.is_a?(Symbol)
       @pg_connection.escape_identifier(s)
     end
 
+    # Quote identifiers and concatenate them using ',' as separator
+    def quote_identifiers(idents) = idents.map { |ident| quote_identifier(ident) }.join(", ")
+
     # Quote the value as a string. Emit 'null' if value is nil
     #
     # The value can be of any type but is converted to a string using #to_s
@@ -255,7 +259,13 @@ module PgConn
     # Note that a tuple value (an array) must be quoted using #quote_tuple
     # because #quote_value would quote the tuple as an array instead of a list
     # of values
-    def quote_value(value)
+    #
+    # The :elem_type option can be a postgres type name (String or Symbol) or
+    # an array of type names. They are used as the required explicit element
+    # type when the argument is an empty array. The element types shoud be in
+    # the same order as the array arguments. Nested arrays is not supported
+    #
+    def quote_value(value, elem_type: nil)
       case value
         when String; @pg_connection.escape_literal(value)
         when Integer, Float; value.to_s
@@ -263,23 +273,34 @@ module PgConn
         when nil; 'null'
         when Date, DateTime; "'#{value}'"
         when Time; "'#{value.strftime("%FT%T%:z")}'"
-        when Array; "array[#{value.map { |elem| quote_value(elem) }.join(', ')}]"
+        when Array
+          if value.empty?
+            elem_type or raise Error, "Empty array without elem_type"
+            "array[]::#{elem_type}[]"
+          else
+            "array[#{value.map { |elem| quote_value(elem) }.join(', ')}]"
+          end
       else
         @pg_connection.escape_literal(value.to_s)
       end
     end
 
-    # Quote an array of values as a tuple. Just an alias for #quote_values
-    def quote_tuple(tuple) = quote_values(tuple)
-
-    # Quote identifiers and concatenate them using ',' as separator
-    def quote_identifiers(idents) = idents.map { |ident| quote_identifier(ident) }.join(", ")
-
     # Quote values and concatenate them using ',' as separator
-    def quote_values(values) = values.map { |value| quote_value(value) }.join(", ")
+    def quote_values(values, elem_type: nil)
+      elem_types = Array(elem_type)
+      values.map { |value|
+        elem_type = value.is_a?(Array) ? elem_types&.shift : nil
+        quote_value(value, elem_type: elem_type)
+      }.join(", ")
+    end
+
+    # Quote an array of values as a tuple. Just an alias for #quote_values
+    def quote_tuple(tuple, elem_type: nil) = quote_values(tuple, elem_type: elem_type)
 
     # Quote an array of tuples
-    def quote_tuples(tuples) = tuples.map { |tuple| "(#{quote_values(tuple)})" }.join(", ")
+    def quote_tuples(tuples, elem_type: nil)
+      tuples.map { |tuple| "(#{quote_values(tuple, elem_type: elem_type)})" }.join(", ")
+    end
 
     # :call-seq:
     #   exist?(query)
@@ -564,10 +585,11 @@ module PgConn
     # values if the result contained only one column (like #value or #values),
     # a tuple if the record has multiple columns (like #tuple), and an array of
     # of tuples if the result contained more than one record with multiple
-    # columns (like #tuples)
+    # columns (like #tuples). If the :proc option is true the "function" is
+    # assumed to be a procedure
     #
-    def call(name, *args, proc: false) # :proc may interfere with hashes
-      args_seq = quote_values(args)
+    def call(name, *args, elem_type: nil, proc: false) # :proc may interfere with hashes
+      args_seq = quote_values(args, elem_type: elem_type)
       if proc
         pg_exec "call #{name}(#{args_seq})"
         return nil
@@ -589,7 +611,7 @@ module PgConn
       end
     end
 
-    # :call-seq*
+    # :call-seq:
     #   insert(table, record|records)
     #   insert(table, fields, record|records|tuples)
     #   insert(schema, table, record|records)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pg_conn
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.23.0
 platform: ruby
 authors:
 - Claus Rasmussen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-20 00:00:00.000000000 Z
+date: 2024-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg