activerecord-filter 8.1.0 → 9.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cee15d7015346ac808e7892435628ff50b19aa86ff9a1ce671a1125d21e1ba4
-  data.tar.gz: a27330b0c68a8913f5aee1c95cacad8d9475492c5fd889ebff3b78ddb7b0a6c4
+  metadata.gz: a42ca6ff3bdbd4318c13518684d31f6bdf3b7a98aa02e877e2d8147c83d2efef
+  data.tar.gz: 5b595328b4129bced6fa43a87c6f93398d6cb35942bb0aa693874b49a062de91
 SHA512:
-  metadata.gz: 5fcc52cd1ef6c55ec62ee8c2472a4cf8d39abf0e974b468020cbfacd07dc0b4af1b132da7a83994b6d014ff751eaf12b16725f790e3072df384d8f2fd4a3d898
-  data.tar.gz: 304f6d204c1d2c9359066d94e2dff95af5350fde8d1598cd61e64c8c9019dc39ac4a502d7483dff23c1cb0a35e1803597f9543434910f925310a6e9f7647eda5
+  metadata.gz: 3e1500189bf99dae963016fff43cb78cda9aa42fe771907fd7842562d67ea704b4609822e85a3f559f96776c3f084a54e790cfdd4bc1026731da44989b7a5109
+  data.tar.gz: 6f9aeae084bf0b7efde2b69dc20a1ac15b8312bbedd800820f5b84fa7e733147357a09fdcf8272e2c1a263077f2fff93a40c5aebd60b9ef3ce2adbd90537385a

data/README.md

@@ -1,9 +1,13 @@
 # ActiveRecord::Filter
 
-`ActiveRecord::Filter` provides and easy way to accept user input and filter a query by the input.
+`ActiveRecord::Filter` provides an easy way to accept user input and filter a query by that input.
 
-Installtion
------------
+## Requirements
+
+- Ruby >= 3.3
+- ActiveRecord >= 8.0
+
+## Installation
 
 - Add `gem 'activerecord-filter', require: 'active_record/filter'`
 - Run `bundle install`
@@ -124,10 +128,39 @@ Property.filter("metadata.key": { eq: 'value' }).to_sql
 # => "...WHERE "properties"."metadata" #> '{key}' = 'value'..."
 ```
 
-It can also sort on relations:
+It can also filter across associations. Any association (`belongs_to`,
+`has_many`, `has_one`, `has_and_belongs_to_many`, `has_many :through`) can be
+nested, and the join is added for you:
 
 ```ruby
 Photo.filter(property: {name: 'Empire State'}).to_sql
 # => "... LEFT OUTER JOIN properties ON properties.id = photos.property_id ...
 # => "... WHERE properties.name = 'Empire State'"
 ```
+
+Pass `true`/`false` against an association to filter on its presence:
+
+```ruby
+Account.filter(photos: true).to_sql   # accounts that have photos
+Account.filter(photos: false).to_sql  # accounts with no photos
+```
+
+For a polymorphic association, scope it to a type with `as:`:
+
+```ruby
+View.filter(subject: {as: 'Property', name: 'Name'}).to_sql
+```
+
+Combining conditions with AND / OR
+----------------------------------
+
+Pass an array to group conditions. Use the strings `'AND'` / `'OR'` as
+separators, and nest arrays for precedence:
+
+```ruby
+Property.filter([{id: 10}, 'OR', {name: 'name'}]).to_sql
+# => "... WHERE ((properties.id = 10) OR (properties.name = 'name'))"
+
+Property.filter([{id: 10}, 'AND', [{id: 10}, 'OR', {name: 'name'}]]).to_sql
+# => "... WHERE properties.id = 10 AND ((properties.id = 10) OR (properties.name = 'name'))"
+```

data/lib/active_record/filter/predicate_builder_extension.rb

@@ -28,6 +28,15 @@ module ActiveRecord::Filter::PredicateBuilderExtension
                   relations << j
                 end
               end
+            elsif js.is_a?(Proc)
+              resolved = js.call(value)
+              Array(resolved).compact.each do |j|
+                if j.is_a?(String)
+                  custom << j
+                else
+                  relations << j
+                end
+              end
             elsif js
               if js.is_a?(String)
                 custom << js
@@ -55,17 +64,17 @@ module ActiveRecord::Filter::PredicateBuilderExtension
                 ]
               else
                 {
-                  key => build_filter_joins(reflection.klass, value, [], custom)
+                  reflection.name => build_filter_joins(reflection.klass, value, [], custom)
                 }
               end
             elsif value.is_a?(Array)
               value.each do |v|
                 relations << {
-                  key => build_filter_joins(reflection.klass, v, [], custom)
+                  reflection.name => build_filter_joins(reflection.klass, v, [], custom)
                 }
               end
             elsif value != true && value != false && value != 'true' && value != 'false' && !value.nil?
-              relations << key
+              relations << reflection.name
             end
           elsif !klass.columns_hash.has_key?(key.to_s) && key.to_s.end_with?('_ids') && reflection = klass._reflections[key.to_s.gsub(/_ids$/, 's').to_sym]
             relations << reflection.name

data/lib/active_record/filter/query_methods_extension.rb

@@ -10,11 +10,7 @@ private
       left_joins = select_named_joins(left_outer_joins_values, stashed_left_joins) do |left_join|
         if left_join.is_a?(ActiveRecord::QueryMethods::CTEJoin)
           buckets[:join_node] << build_with_join_node(left_join.name, Arel::Nodes::OuterJoin)
-# Add this elsif becasuse PR https://github.com/rails/rails/pull/46843
-# Changed a line https://github.com/rails/rails/blob/ae2983a75ca658d84afa414dea8eaf1cca87aa23/activerecord/lib/active_record/relation/query_methods.rb#L1769
-# that was probably a bug beforehand but allowed nodes to be joined
-# which I think was and still is supported?
-        elsif left_join.is_a?(Arel::Nodes::OuterJoin)
+        elsif left_join.is_a?(Arel::Nodes::Join)
           buckets[:join_node] << left_join
         else
           raise ArgumentError, "only Hash, Symbol and Array are allowed"

data/lib/active_record/filter/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveRecord
   module Filter
-    VERSION = '8.1.0'
+    VERSION = '9.0.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activerecord-filter
 version: !ruby/object:Gem::Version
-  version: 8.1.0
+  version: 9.0.0
 platform: ruby
 authors:
 - Jon Bracy
@@ -15,28 +15,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
 - !ruby/object:Gem::Dependency
   name: arel-extensions
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -57,14 +57,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -155,14 +155,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.2.0
+        version: 8.0.0
 - !ruby/object:Gem::Dependency
   name: faker
   requirement: !ruby/object:Gem::Requirement
@@ -227,7 +227,11 @@ files:
 homepage: https://github.com/malomalo/activerecord-filter
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/malomalo/activerecord-filter
+  source_code_uri: https://github.com/malomalo/activerecord-filter
+  changelog_uri: https://github.com/malomalo/activerecord-filter/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 rdoc_options:
 - "--main"
 - README.md
@@ -237,14 +241,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.2
+rubygems_version: 4.0.11
 specification_version: 4
 summary: A safe way to accept user parameters and query against your ActiveRecord
   Models