active_job-performs 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 360213ab324cae80fefcf276ecb9803ed8e4ec62166dc9eded626b67f8329b97
-  data.tar.gz: 92fa0c284711569f812da53e7acca9cbe15cea03aec0ccb9c2512465a7b93f39
+  metadata.gz: 673105da38e705ba9aa778566a9d711a631aea27467a354a4fc4413e16b31ac3
+  data.tar.gz: 632442f9d0c25be20d47ecc4038b8d36e20d2b4797b5a1b622d3b5dead074cc4
 SHA512:
-  metadata.gz: 16fd7671e6eaeba29bac333597170661ca5333c3e14e3142ba910579316641dc2e2ba31f3fdd49508e5e0263a3fc67b34032e4ef61bb1b1a8dc3679a6a9ec26b
-  data.tar.gz: 353e3cf1bc646e32883352a2f4ebb80121987e415872ce9d0e32256fcbed7f559e66576a1ee15b71e2fec3930d54f362a5b8905cd502cac7daf4df7b618191e3
+  metadata.gz: 7f1569149e481246401f737e48a032d6d579bdfcf39751daafc5b4991eecd7017a3e646ed573101d8c65ae6acf36b371c75bf2ed793fa22fef77fd5ca93fa25d
+  data.tar.gz: f1df1f52d96bc4fff67af97b1f675669da1eec01423b48ecc36451e2c290111d205ef839da6abe36929ba3edf685998a473f73ee55f3b01286a2df083ebfa988

data/Gemfile

@@ -16,4 +16,4 @@ gem "debug"
 gem "activejob",    ">= 7.1"
 gem "activerecord", ">= 7.1"
 
-gem "sqlite3", "~> 1.4"
+gem "sqlite3"

data/Gemfile.lock

@@ -7,59 +7,77 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activejob (7.1.3.4)
-      activesupport (= 7.1.3.4)
+    activejob (8.1.1)
+      activesupport (= 8.1.1)
       globalid (>= 0.3.6)
-    activemodel (7.1.3.4)
-      activesupport (= 7.1.3.4)
-    activerecord (7.1.3.4)
-      activemodel (= 7.1.3.4)
-      activesupport (= 7.1.3.4)
+    activemodel (8.1.1)
+      activesupport (= 8.1.1)
+    activerecord (8.1.1)
+      activemodel (= 8.1.1)
+      activesupport (= 8.1.1)
       timeout (>= 0.4.0)
-    activesupport (7.1.3.4)
+    activesupport (8.1.1)
       base64
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    base64 (0.2.0)
-    bigdecimal (3.1.8)
-    concurrent-ruby (1.3.3)
-    connection_pool (2.4.1)
-    debug (1.9.2)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    base64 (0.3.0)
+    bigdecimal (3.3.1)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.5)
+    date (3.5.0)
+    debug (1.11.0)
       irb (~> 1.10)
       reline (>= 0.3.8)
-    drb (2.2.1)
-    globalid (1.2.1)
+    drb (2.2.3)
+    erb (6.0.0)
+    globalid (1.3.0)
       activesupport (>= 6.1)
-    i18n (1.14.5)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    io-console (0.7.2)
-    irb (1.13.2)
+    io-console (0.8.1)
+    irb (1.15.3)
+      pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    minitest (5.24.0)
-    minitest-sprint (1.2.2)
+    json (2.16.0)
+    logger (1.7.0)
+    minitest (5.26.2)
+    minitest-sprint (1.4.1)
       path_expander (~> 1.1)
-    mutex_m (0.2.0)
-    path_expander (1.1.1)
-    psych (5.1.2)
+      prism (~> 1.5)
+    path_expander (1.1.3)
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.6.0)
+    psych (5.2.6)
+      date
       stringio
-    rake (13.2.1)
-    rdoc (6.7.0)
+    rake (13.3.1)
+    rdoc (6.16.1)
+      erb
       psych (>= 4.0.0)
-    reline (0.5.9)
+      tsort
+    reline (0.6.3)
       io-console (~> 0.5)
-    sqlite3 (1.7.3-arm64-darwin)
-    sqlite3 (1.7.3-x86_64-linux)
-    stringio (3.1.1)
-    timeout (0.4.1)
+    securerandom (0.4.1)
+    sqlite3 (2.8.0-arm64-darwin)
+    sqlite3 (2.8.0-x86_64-linux-gnu)
+    stringio (3.1.8)
+    timeout (0.4.4)
+    tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
+    uri (1.1.1)
 
 PLATFORMS
   arm64-darwin
@@ -73,7 +91,7 @@ DEPENDENCIES
   minitest (~> 5.0)
   minitest-sprint
   rake (~> 13.0)
-  sqlite3 (~> 1.4)
+  sqlite3
 
 BUNDLED WITH
    2.5.14

data/README.md

@@ -192,8 +192,7 @@ If there's an Active Record method that you'd like any model to be able to run f
 class ApplicationRecord < ActiveRecord::Base
   self.abstract_class = true
 
-  # We're passing specific queues for monitoring, but you may not need or want them.
-  performs :touch,   queue_as: "active_record.touch"
+  # We're passing specific queues for monitoring, but they're optional.
   performs :update,  queue_as: "active_record.update"
   performs :destroy, queue_as: "active_record.destroy"
 end
@@ -202,19 +201,21 @@ end
 Then a model could now run things like:
 
 ```ruby
-record.touch_later
-record.touch_later :reminded_at, time: 5.minutes.from_now # Pass supported arguments to `touch`
-
-record.update_later reminded_at: 1.year.ago
-
-# Particularly handy to use on a record with many `dependent: :destroy` associations.
-# Plus if anything fails, the transaction will rollback and the job fails, so you can retry it later!
+record.update_later reminded_at: 1.year.ago # Forward along arguments to the eventual `update` call.
 record.destroy_later
 ```
 
-You may not want this for `touch` and `update`, and maybe you'd rather architect your system in such a way that they don't have so many side-effects, but having the option can be handy!
+> [!TIP]
+> `destroy_later` could be particularly useful on a record with many `dependent: :destroy` associations.
+> If anything fails, the transaction will rollback and the job fails, so you can retry it later!
+
+> [!NOTE]
+> Maybe you'd rather architect your system such that these methods don't have so many side-effects, but having the option can be handy.
+
+> [!WARNING]
+> Don't use this pattern with `touch` because Rails has an internal [touch_later](https://github.com/rails/rails/blob/690ec8898318b8f50714e86676353ebe1551261e/activerecord/lib/active_record/touch_later.rb#L11) private API method used in `belongs_to <some_association>, touch: true` assocations. If your model is one day used in such an assocation and you were using this pattern your app would break.
 
-Also, I haven't tested all the Active Record methods, so please file an issue if you encounter any.
+I haven't tested all the Active Record methods, so please file an issue if you encounter any.
 
 #### Method suffixes
 

data/lib/active_job/performs/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveJob
   module Performs
-    VERSION = "0.3.3"
+    VERSION = "0.4.0"
   end
 end

data/lib/active_job/performs.rb

@@ -55,8 +55,6 @@ module ActiveJob::Performs
           #{job}.scoped_by_wait(self).perform_later(self, *arguments, **options)
         end
       RUBY
-
-      [method, :"#{method}_later#{suffix}"] # Ensure `private performs :some_method` privates both names.
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_job-performs
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.0
 platform: ruby
 authors:
 - Kasper Timm Hansen
@@ -59,7 +59,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.2
 specification_version: 4
 summary: ActiveJob::Performs adds the `performs` macro to set up jobs by convention.
 test_files: []