activerecord-refined 0.9.0 → 0.10.1

data/examples/expressions.rb

@@ -16,6 +16,7 @@ class Setup < ActiveRecord::Migration[8.1]
       t.integer :price
       t.integer :quantity
       t.integer :flags
+      t.date :ordered_on
     end
   end
 end
@@ -24,10 +25,16 @@ Setup.new.up
 class LineItem < ActiveRecord::Base
 end
 
-LineItem.create!(sku: "A-1", category: "tools",  price: 1200, quantity: 2,  flags: 12)
-LineItem.create!(sku: "A-2", category: "tools",  price: 300,  quantity: 5,  flags: 10)
-LineItem.create!(sku: "B-1", category: "paper",  price: 80,   quantity: 10, flags: 3)
-LineItem.create!(sku: "C-1", category: nil,      price: 50,   quantity: 1,  flags: 4)
+LineItem.create!(sku: "A-1", category: "tools",  price: 1200, quantity: 2,  flags: 12,
+                 ordered_on: Date.new(2026, 1, 5))
+LineItem.create!(sku: "A-2", category: "tools",  price: 300,  quantity: 5,  flags: 10,
+                 ordered_on: Date.new(2026, 1, 20))
+LineItem.create!(sku: "B-1", category: "paper",  price: 80,   quantity: 10, flags: 3,
+                 ordered_on: Date.new(2026, 2, 3))
+LineItem.create!(sku: "B-2", category: "paper",  price: 80,   quantity: 10, flags: 3,
+                 ordered_on: Date.new(2026, 2, 3))
+LineItem.create!(sku: "C-1", category: nil,      price: 50,   quantity: 1,  flags: 4,
+                 ordered_on: Date.new(2026, 2, 14))
 
 def show(title, relation, rows = nil)
   puts "--- #{title} ---"
@@ -64,6 +71,17 @@ show("a tax through BigDecimal, exact on the wire",
   LineItem.select { [:sku, (BigDecimal("1.1") * :price).as(:taxed)] }.
     map { |i| [i.sku, i.taxed] })
 
+# A duration moves a date.  Each adapter spells the move its own way; SQLite
+# has date() and datetime(), and a date column keeps being a date.
+show("a date moved by a duration",
+  LineItem.where { :ordered_on + 30.days < Date.new(2026, 2, 10) },
+  LineItem.where { :ordered_on + 30.days < Date.new(2026, 2, 10) }.pluck(:sku))
+
+show("a due date a month on",
+  LineItem.select { [:sku, (:ordered_on + 1.month).as(:due_on)] },
+  LineItem.select { [:sku, (:ordered_on + 1.month).as(:due_on)] }.
+    map { |i| [i.sku, i.due_on] })
+
 # The bitwise operators.  & and | are AND and OR between conditions, which is
 # what leaves them free here.  Each expression parenthesises itself, so the
 # grouping is Ruby's rather than the adapter's.
@@ -89,12 +107,17 @@ rescue ArgumentError => e
 end
 
 # 2. Aggregates.  count takes :* for COUNT(*) and distinct: true for
-#    COUNT(DISTINCT ...); the rest are sum, avg, min and max.
+#    COUNT(DISTINCT ...), which sum and avg take too; the rest are min and max.
 show("COUNT(*) and COUNT(DISTINCT ...)",
   LineItem.select { [count(:*).as(:rows), count(:category, distinct: true).as(:categories)] },
   LineItem.select { [count(:*).as(:rows), count(:category, distinct: true).as(:categories)] }.
     map { |i| [i.rows, i.categories] })
 
+show("SUM(DISTINCT ...), each quantity counted once",
+  LineItem.select { [sum(:quantity).as(:all), sum(:quantity, distinct: true).as(:once)] },
+  LineItem.select { [sum(:quantity).as(:all), sum(:quantity, distinct: true).as(:once)] }.
+    map { |i| [i.all, i.once] })
+
 # filter takes the aggregate over the rows a condition holds for.  SQLite and
 # PostgreSQL have the FILTER clause; MySQL gets the CASE that means the same,
 # since an aggregate passes over the NULL a missed row leaves.
@@ -173,6 +196,13 @@ show("NULLS LAST",
   LineItem.order { [:category.asc.nulls_last, :sku.asc] },
   LineItem.order { [:category.asc.nulls_last, :sku.asc] }.pluck(:category, :sku))
 
+# collate names a collation -- how the database compares and orders strings --
+# and gives back an expression, so it carries into a comparison or an order.
+# The names are the database's own; nocase is SQLite's case-insensitive one.
+show("a case-insensitive comparison under a collation",
+  LineItem.where { :category.collate(:nocase) == "TOOLS" },
+  LineItem.where { :category.collate(:nocase) == "TOOLS" }.pluck(:sku))
+
 # Aggregates and expressions can be ordered by, too.
 show("grouped, aggregated and ordered by the aggregate",
   LineItem.