uberloader 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8492bc8a8089cb6ece086e3b2b0f0827e8c52f59d7d26d6813153c0ea7d08193
-  data.tar.gz: a9586e3880975bcbba4975bb969c3b0be354c6d8b51059cae77aae5d84ad86b9
+  metadata.gz: cf39d2fc30a38dc13e238ddfc6d8d2e4bb47c6d2a3e94da375dcf328055f4ba4
+  data.tar.gz: c761f0bb0e277ae12781066a3ad16c9e06a049ca303966b3c0d97040d7144eb5
 SHA512:
-  metadata.gz: d0a7b5dc7990d96df8c9075eff13283543f6e8dfc17eca55095a7a5ab7e629fdd1a0d4f31ecd68b5cc75c143bba73291e6638e410a446bd16f77e6c89aeffd92
-  data.tar.gz: 5c595cbf5702da0a6f9fdd558ab6193efc33509de2c96ac61f95da1158e8a4d811ee11dd8ab59f4c81a15868ca2d10ede18d8d62f7869a23ca66a0bc25bec3f5
+  metadata.gz: 646a47d968675f8f6e156e56865187dfecc52c64cda7c86244737b515c5f2e2a15992a2678cc11d8e0cfec7fbf49dc508c2739d428238a642d90bc396a27a11f
+  data.tar.gz: fb8417d185f513eb3a31253a52301767cd3e08f73e9eb6faee7c8566f26f395e21e8b94c54a8b96432bd4a359a0dee9d8247ff1439456e3a6566683ba8f6f1d6

data/README.md

@@ -1,35 +1,48 @@
 # Uberloader
 
-Uberloader is a new way of preloading associations in ActiveRecord. It works like `preload`, but with the following changes:
+Uberloader is a new way of preloading associations in ActiveRecord. It behaves like `preload`, but with a lot more power.
 
-* Custom scopes may be given.
-* Nested preloads use blocks.
+#### Install with Bundler
+
+```bash
+bundle add uberloader
+```
+
+#### Nested preloads use blocks
 
 ```ruby
 widgets = Widget
   .where(category_id: category_ids)
-  # Preload category
   .uberload(:category)
-  # Preload parts, ordered by name
-  .uberload(:parts, scope: Part.order(:name)) do |u|
-    # Preload the parts' manufacturer
+  .uberload(:parts) { |u|
     u.uberload(:manufacturer)
-    # and their subparts, using a custom scope
-    u.uberload(:subparts) do
-      u.scope my_subparts_scope_helper
-      u.scope Subpart.where(kind: params[:sub_kinds]) if params[:sub_kinds]&.any?
-
-      u.uberload(:foo) do
+    u.uberload(:subparts) {
+      u.uberload(:foo) {
         u.uberload(:bar)
-      end
-    end
-  end
+      }
+    }
+  }
 ```
 
-Install with Bundler:
+#### Why? So you can customize preload scopes
 
-```bash
-bundle add uberloader
+```ruby
+widgets = Widget
+  .where(category_id: category_ids)
+  .uberload(:category)
+  # specify scope using an argument
+  .uberload(:parts, scope: Part.order(:name)) { |u|
+    u.uberload(:manufacturer)
+    u.uberload(:subparts) {
+      # or using the #scope method
+      u.scope my_subparts_scope_helper
+      u.scope Subpart.where(kind: params[:sub_kinds]) if params[:sub_kinds]&.any?
+
+      u.uberload(:foo) {
+        u.uberload(:bar)
+      }
+    }
+  }
 ```
 
 ## Interaction with preload and includes
@@ -48,7 +61,7 @@ Regretably, none of this is possible without monkeypatching `ActiveRecord::Relat
 
 To assess its stability over time, I ran Uberloader's unit tests against the full matrix of (supported) ActiveRecord and Uberloader versions. They passed consistently, but with predictable clusters of failures around pre-release and X.0.0 versions.
 
-I will keep these tests running daily, and against this project's `main` branch as well. [You can find the link to the results here](https://github.com/jhollinger/uberloader/blob/docs/VERSION_COMPATIBILITY.md). If something breaks, I'll try to fix it. If we're lucky, maybe this behavior could get _into_ Rails itself someday...
+I will keep these tests running regularly. [You can find the link to the results here](https://github.com/jhollinger/uberloader/blob/docs/VERSION_COMPATIBILITY.md). If something breaks, I'll try to fix it. If we're lucky, maybe this behavior could get _into_ Rails itself someday...
 
 ## Testing
 
@@ -88,5 +101,4 @@ bin/generate-version-test-table
 # Run tests for specific versions
 #                      Appraisal  ActiveRecord  Uberloader
 bin/test-compatibility 7.1        7.1.3.2       0.1.0
-bin/test-compatibility 7.1        7.1.3.2       HEAD
 ```

data/lib/uberloader/preloader/v8.rb

@@ -0,0 +1,9 @@
+module Uberloader
+  module Preloader
+    def self.call(records, association, scope = nil)
+      ::ActiveRecord::Associations::Preloader
+        .new(records: records, associations: association, scope: scope)
+        .call
+    end
+  end
+end

data/lib/uberloader/version.rb

@@ -1,3 +1,3 @@
 module Uberloader
-  VERSION = "0.2.0".freeze
+  VERSION = "0.4.0".freeze
 end

data/lib/uberloader.rb

@@ -9,6 +9,7 @@ module Uberloader
 
   autoload :Preloader,
     case ActiveRecord::VERSION::MAJOR
+    when 8 then 'uberloader/preloader/v8'
     when 7 then 'uberloader/preloader/v7'
     when 6 then 'uberloader/preloader/v6'
     else raise "Unsupported ActiveRecord version"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: uberloader
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jordan Hollinger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-31 00:00:00.000000000 Z
+date: 2025-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -19,7 +19,7 @@ dependencies:
         version: '6.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.3'
+        version: '9.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '6.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.3'
+        version: '9.0'
 description: Customizable SQL when preloading in ActiveRecord
 email: jordan.hollinger@gmail.com
 executables: []
@@ -42,6 +42,7 @@ files:
 - lib/uberloader/context.rb
 - lib/uberloader/preloader/v6.rb
 - lib/uberloader/preloader/v7.rb
+- lib/uberloader/preloader/v8.rb
 - lib/uberloader/query_methods.rb
 - lib/uberloader/uberload.rb
 - lib/uberloader/version.rb
@@ -64,7 +65,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Advanced preloading for ActiveRecord