standard_procedure_operations 0.7.2 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 462512e945573c5809f480e318e03c17a15604e8f8362934d2c730f2827f54a5
-  data.tar.gz: 3446e47c75e17db5384b8ba8a86a5740fbd095ea6a3f57ae6eb9d05dbac50e1c
+  metadata.gz: 24336966a7874886f00207073fbe8f5f3f53d55bb7594c8c36d085f4c74dd369
+  data.tar.gz: 3bdf232858859b1003c7b90c911932aa5e4e7c321a0fefbcbcfc62c49801cda2
 SHA512:
-  metadata.gz: 442ba282285358dc7baa1bbd9f00a4fa2aaa76ee4009a0638073f95e6e099c993d7eb0b9381884b781432874bd542a2a8fde4a6c150bd7c3fdf5028f94ac6951
-  data.tar.gz: 6458262e8f3efd03256c1a4e6efe7be32d925ce88852afc93869d28b6ed7e77e6fb0108020ea1c39ab15ca79feaaa5eb2d45e129ce0829064c1b779d727e39eb
+  metadata.gz: 1398774410e430157a8cd45e874ca1cd631ccc3159d554d32b573d4e6f261504727b31aceaf05340c4a75f60d87309977485f163bcf79b1dc15fb7fa0a1d20d2
+  data.tar.gz: 7ee18d5f9889f902f74bc5277f71e72d1d029676bb39fe2dae7d3185accded3d3573f2b784233b21c4830b6422771ea9d47e3281975230c97eddd931c61623d2

data/README.md

@@ -217,6 +217,18 @@ If you want the task to be run completely in the background (so it sleeps immedi
 
 [Example wait and interaction handlers](spec/examples/waiting_and_interactions_spec.rb)
 
+Because background tasks are woken using ActiveJob, you may wish to control exactly how these jobs are handled.  
+
+You can specify which ActiveJob queue they are placed on (with the default value being `:default`) - this is the equivalent of setting `queue_as :my_queue` in ActiveJob.  And you can even specify which queue adapter they use (if, for example, you want to use SolidQueue for most of your background jobs, but Sidekiq for a certain subset of tasks). 
+
+```ruby
+class MyBackgroundOperation < Operations::Task 
+  queue :low_priority
+  runs_on :sidekiq
+  # ...
+end
+```
+
 ### Sub tasks
 
 If your task needs to start sub-tasks, it can use the `start` method, passing the sub-task class and arguments.  
@@ -298,10 +310,10 @@ class WeekendChecker < Operations::Task
   result :weekday
 end
 
-task = WeekendChecker.verify :is_it_the_weekend?, day_of_week: "Saturday"
+task = WeekendChecker.test :is_it_the_weekend?, day_of_week: "Saturday"
 expect(task).to be_in :weekend
 
-task = WeekendChecker.verify :is_it_the_weekend?, day_of_week: "Wednesday"
+task = WeekendChecker.test :is_it_the_weekend?, day_of_week: "Wednesday"
 expect(task).to be_in :weekday
 ```
 

data/app/jobs/operations/wake_task_job.rb

@@ -1,5 +1,5 @@
 class Operations::WakeTaskJob < ApplicationJob
-  queue_as :default
+  queue_as { arguments.first.class.queue_as }
 
   def perform(task) = task.wake_up!
 end

data/app/models/operations/task/plan.rb

@@ -32,6 +32,12 @@ module Operations::Task::Plan
 
     def timeout(value) = @execution_timeout = value
 
+    def queue(value) = @queue_as = value
+
+    def runs_on(value) = @queue_adapter ||= value
+    alias_method :runs, :runs_on
+    alias_method :runs_using, :runs_on
+
     def delete_after(value) = @deletion_time = value
 
     def on_timeout(&handler) = @on_timeout = handler
@@ -40,6 +46,10 @@ module Operations::Task::Plan
 
     def execution_timeout = @execution_timeout ||= 24.hours
 
+    def queue_as = @queue_as ||= :default
+
+    def queue_adapter = @queue_adapter ||= Operations::WakeTaskJob.queue_adapter
+
     def timeout_handler = @on_timeout
 
     def deletion_time = @deletion_time ||= 90.days

data/app/models/operations/task.rb

@@ -5,17 +5,18 @@ module Operations
     include Index
     include Testing
 
+    scope :active, -> { where(status: %w[active waiting]) }
     scope :ready_to_wake, -> { ready_to_wake_at(Time.current) }
-    scope :ready_to_wake_at, ->(time) { where(wakes_at: ..time) }
+    scope :ready_to_wake_at, ->(time) { waiting.where(wakes_at: ..time) }
     scope :expired, -> { expires_at(Time.current) }
-    scope :expired_at, ->(time) { where(expires_at: ..time) }
+    scope :expired_at, ->(time) { waiting.where(expires_at: ..time) }
     scope :ready_to_delete, -> { ready_to_delete_at(Time.current) }
     scope :ready_to_delete_at, ->(time) { where(delete_at: ..time) }
 
     # Task hierarchy relationships
     belongs_to :parent, class_name: "Operations::Task", optional: true
     has_many :sub_tasks, class_name: "Operations::Task", foreign_key: "parent_id", dependent: :nullify
-    has_many :active_sub_tasks, -> { where(status: ["active", "waiting"]) }, class_name: "Operations::Task", foreign_key: "parent_id"
+    has_many :active_sub_tasks, -> { active }, class_name: "Operations::Task", foreign_key: "parent_id"
     has_many :failed_sub_tasks, -> { failed }, class_name: "Operations::Task", foreign_key: "parent_id"
     has_many :completed_sub_tasks, -> { completed }, class_name: "Operations::Task", foreign_key: "parent_id"
 
@@ -30,14 +31,14 @@ module Operations
       while active? && (state != current_state)
         state = current_state
         Rails.logger.debug { "--- #{self}: #{current_state}" }
-        (handler_for(current_state).immediate? || immediate) ? call_handler : go_to_sleep!
+        (immediate || state_is_immediate?(current_state)) ? call_handler : go_to_sleep!
       end
     rescue => ex
       record_error! ex
       raise ex
     end
 
-    def go_to(next_state) = update! current_state: next_state
+    def go_to(next_state) = update! current_state: next_state, task_status: (state_is_immediate?(next_state) ? "active" : "waiting")
 
     def wake_up! = timeout_expired? ? call_timeout_handler : activate_and_call
 
@@ -47,6 +48,8 @@ module Operations
 
     def call_handler = handler_for(current_state).call(self)
 
+    private def state_is_immediate?(state) = handler_for(state).immediate?
+
     private def go_to_sleep! = update!(default_times.merge(task_status: "waiting"))
 
     private def activate_and_call
@@ -61,16 +64,34 @@ module Operations
       raise ex
     end
 
-    def self.call(task_status: "active", **attributes) = create!(attributes.merge(task_status: task_status, current_state: initial_state).merge(default_times)).tap { |t| t.call }
-
-    def self.later(**attributes) = call(task_status: "waiting", **attributes)
-
-    def self.perform_now(...) = call(...)
-
-    def self.perform_later(...) = later(...)
-
-    def self.wake_sleeping = Task.ready_to_wake.find_each { |t| Operations::WakeTaskJob.perform_later(t) }
+    class << self
+      def call(task_status: "active", **attributes)
+        create!(attributes.merge(task_status: task_status, current_state: initial_state).merge(default_times)).tap do |t|
+          t.call
+        end
+      end
+      alias_method :perform_now, :call
+
+      def later(**attributes) = call(task_status: "waiting", **attributes)
+      alias_method :perform_later, :later
+
+      def wake_sleeping
+        adapter = Operations::WakeTaskJob.queue_adapter
+        begin
+          Task.ready_to_wake.find_each do |task|
+            Operations::WakeTaskJob.queue_adapter = task.class.queue_adapter
+            Operations::WakeTaskJob.perform_later task
+          end
+        ensure
+          Operatives::WakeTaskJob.queue_adapter = adapter
+        end
+      end
 
-    def self.delete_old = Task.ready_to_delete.find_each { |t| Operations::DeleteOldTaskJob.perform_later(t) }
+      def delete_old
+        Task.ready_to_delete.find_each do |t|
+          Operations::DeleteOldTaskJob.perform_later(t)
+        end
+      end
+    end
   end
 end

data/lib/operations/version.rb

@@ -1,3 +1,3 @@
 module Operations
-  VERSION = "0.7.2"
+  VERSION = "0.7.3"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: standard_procedure_operations
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 0.7.3
 platform: ruby
 authors:
 - Rahoul Baruah
 bindir: bin
 cert_chain: []
-date: 2025-07-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -98,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Operations
 test_files: []