sequel 5.105.0 → 5.106.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa9e8681d693c24d9f5dc7f6369be50dfcbf73c648402ec486e9ba69d5792f76
-  data.tar.gz: 7de020c93e5388ea9d58bd6e4d601bd06b240684e4c9001985549fd3b1c2d665
+  metadata.gz: 93dd74cb4407d389f289342898c26327d91db1ddd733478461bd8620a3a1771b
+  data.tar.gz: b00796ca61d19f2d9aeaaa764565893e73f5dd4c0752e11bd38635fdb94b1cea
 SHA512:
-  metadata.gz: 34030c2c1a045fa5fc36a6a36e1414960315469d415be97c3734fea182e63224c86c0882fa1958d5549f77c420879f6402af61a1756a4b7575a315ceb9c67f11
-  data.tar.gz: ea08def92c00668ca1898eac5a3dd37b50aeb1f81379e7c3ab19544e01cc5ef0c0c54786fc2a76f885e14b71534a3895451f33891cb374b3a3f10c08b0244d8a
+  metadata.gz: 2502a507d57a7f64dae3ddc9e736254461a3a05f15f95a4835e2ddd83cb3cf3a9f6719f97e6b05239508d4e8445cff8b502198d40eea9f2c0af9d7ea385f829f
+  data.tar.gz: 8f3e230dc402a4e9d4b2c1d60fb5bdcac580f8368a2ad79a132a29348df8bce6b78f983658c6cf1e406b53164f79f1103cdbfb8ccfd29d0ec90db48a57f348a2

data/lib/sequel/adapters/shared/postgres.rb

@@ -2133,6 +2133,26 @@ module Sequel
         cached_lock_style_dataset(:_for_key_share_ds, :key_share)
       end
 
+      # Set FOR PORTION OF clause for UPDATE and DELETE statements.
+      # The first argument is the range or multirange column. If two arguments
+      # are provided, the second argument is an expression with the same
+      # database type as the first argument. If three arguments are provided,
+      # the second specifies the inclusive start of the portion to update and the third
+      # specifies the exclusive end of portion to update. When using the three argument
+      # form, nil can be provided as the second or third argument to have the start or
+      # end of the portion be unbounded.  Supported on PostgreSQL 19+.
+      # Example:
+      #
+      #   DB[:t].for_portion_of(:rc, Sequel.function(:int4range, 1, 2)).update(c: 3)
+      #   # UPDATE t FOR PORTION OF rc (int4range(1, 2)) SET c = 3
+      #   
+      #   DB[:t].for_portion_of(:rc, 1, 2).update(c: 3)
+      #   # UPDATE t FOR PORTION OF rc FROM 1 TO 2 SET c = 3
+      def for_portion_of(column, range, to=(arg_not_given=true))
+        range = [range, to].freeze unless arg_not_given
+        clone(:for_portion_of => [column, range].freeze)
+      end
+
       # Return a cloned dataset which will use FOR NO KEY UPDATE to lock returned rows.
       # This is generally a better choice than using for_update on PostgreSQL, unless
       # you will be deleting the row or modifying a key column. Supported on PostgreSQL 9.3+.
@@ -2635,10 +2655,11 @@ module Sequel
         "'%Y-%m-%d %H:%M:%S.%6N%z'"
       end
 
-      # Only include the primary table in the main delete clause
+      # Only include the primary table in the main delete clause.
+      # Support FOR PORTION OF.
       def delete_from_sql(sql)
         sql << ' FROM '
-        source_list_append(sql, @opts[:from][0..0])
+        table_for_portion_of_sql_append(sql)
       end
 
       # Use USING to specify additional tables in a delete query
@@ -2723,6 +2744,32 @@ module Sequel
         origin
       end
 
+      # Add FOR PORTION OF SQL if the dataset uses it.
+      def table_for_portion_of_sql_append(sql)
+        fpo_column, fpo_range = @opts[:for_portion_of]
+        if fpo_column
+          table, aliaz = split_alias(@opts[:from].first)
+          source_list_append(sql, [table])
+          sql << ' FOR PORTION OF '
+          literal_append(sql, fpo_column)
+
+          if fpo_range.is_a?(Array)
+            fpo_start, fpo_end = fpo_range
+            sql << ' FROM '
+            literal_append(sql, fpo_start)
+            sql << ' TO '
+            literal_append(sql, fpo_end)
+          else
+            sql << ' ('
+            literal_append(sql, fpo_range)
+            sql << ')'
+          end
+          as_sql_append(sql, aliaz) if aliaz
+        else
+          source_list_append(sql, @opts[:from][0..0])
+        end
+      end
+
       # Add ON CONFLICT clause if it should be used
       def insert_conflict_sql(sql)
         if opts = @opts[:insert_conflict]
@@ -3012,10 +3059,10 @@ module Sequel
         join_from_sql(:FROM, sql)
       end
 
-      # Only include the primary table in the main update clause
+      # Support FOR PORTION OF.
       def update_table_sql(sql)
         sql << ' '
-        source_list_append(sql, @opts[:from][0..0])
+        table_for_portion_of_sql_append(sql)
       end
     end
   end

data/lib/sequel/dataset/sql.rb

@@ -562,6 +562,7 @@ module Sequel
       end
 
       if window = opts[:over]
+        sql << ' IGNORE NULLS' if window.opts[:ignore_nulls]
         sql << ' OVER '
         window_sql_append(sql, window.opts)
       end

data/lib/sequel/sql.rb

@@ -1323,6 +1323,7 @@ module Sequel
     # in this module which can be required at the top level to get
     # direct access to the constants.
     module Constants
+      ALL = Constant.new(:ALL)
       CURRENT_DATE = Constant.new(:CURRENT_DATE)
       CURRENT_TIME = Constant.new(:CURRENT_TIME)
       CURRENT_TIMESTAMP = Constant.new(:CURRENT_TIMESTAMP)
@@ -1992,6 +1993,8 @@ module Sequel
       #                           for rows following
       #                   :exclude :: Which rows to exclude.  Possible values are :current, :ties, :group
       #                               :no_others.
+      # :ignore_nulls :: Can be set to :ignore for IGNORE NULLS (supported on PostgreSQL 19+ for
+      #                  a subset of default window functions)
       # :order :: order on the column(s) given
       # :partition :: partition/group on the column(s) given
       # :window :: base results on a previously specified named window

data/lib/sequel/version.rb

@@ -6,7 +6,7 @@ module Sequel
 
   # The minor version of Sequel.  Bumped for every non-patch level
   # release, generally around once a month.
-  MINOR = 105
+  MINOR = 106
 
   # The tiny version of Sequel.  Usually 0, only bumped for bugfix
   # releases that fix regressions from previous versions.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sequel
 version: !ruby/object:Gem::Version
-  version: 5.105.0
+  version: 5.106.0
 platform: ruby
 authors:
 - Jeremy Evans