standard_procedure_operations 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5804e91c48ca11b9306c1d8d2c3006df7916dcd3e768629cf492b1daa409725
-  data.tar.gz: 2c0f4a513bb1bd685f44daf46f28e7ecb2ac0909a703ae79240ff0587fc74d1c
+  metadata.gz: 4d3727c9772fdc1cd01eb3438c01f0fdea6ea03b02e9ab631363bc20fac73ffc
+  data.tar.gz: 8d75786ef589b7029d49d743a25c7e38723124d9cf095e59cae072969a61ad0e
 SHA512:
-  metadata.gz: 1f8335c58e7df31046d08ab67cf99d7bf1cd0a1a52aa24433b79932f418c9d0de945d702d7039eabb6e66ed4a94484a2aa3d9bdb415d60859b9007feff9c64e2
-  data.tar.gz: 8cb8aa2940d5b4658582c14aef3db7d715c3c6af2f66b1bd838514ad11e67a6edbc8a9b95eb9cd8e57fc8293156365acaf95e017d8d13572fe5d1259c2b27269
+  metadata.gz: 58662325c764ab6fcbca8f047d4077a773e980bfcfda739d0a1076e8b9f5b579744de1938d2119897b33091a5de579e5d6747bd090f80a4f27a2237b287f4253
+  data.tar.gz: 1aff44b8fd34fe03bc92e1da8ab56db4f80b29cc5fc3a1e659022c2be61b8caf9ed92e23ce2572be58421f1a6ad03e96360a2f504424b1b00860a9ddd67b5d51

data/README.md

@@ -280,7 +280,30 @@ However, it also means that your database table could fill up with junk that you
 
 ## Testing
 
-TBD
+Because the flow for a task may be complex, it's best to test each state in isolation.  To help with this, there is a `test` method on the `Operations::Task` class, which creates a task, in your desired state, then runs the appropriate handler.  Then you can check that it has done what you expect.  
+
+```ruby 
+class WeekendChecker < Operations::Task
+  has_attribute :day_of_week, :string, default: "Monday"
+  validates :day_of_week, presence: true
+  starts_with :is_it_the_weekend?
+
+  decision :is_it_the_weekend? do
+    condition { %w[Saturday Sunday].include? day_of_week }
+    if_true :weekend
+    if_false :weekday
+  end
+
+  result :weekend
+  result :weekday
+end
+
+task = WeekendChecker.verify :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"
+expect(task).to be_in :weekday
+```
 
 ## Installation
 Step 1: Add the gem to your Rails application's Gemfile:

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

@@ -0,0 +1,11 @@
+module Operations::Task::Testing
+  extend ActiveSupport::Concern
+
+  class_methods do
+    def test state, **attributes
+      create!(current_state: state, **attributes).tap do |task|
+        task.call_handler
+      end
+    end
+  end
+end

data/app/models/operations/task.rb

@@ -3,6 +3,8 @@ module Operations
     include HasAttributes
     include Plan
     include Index
+    include Testing
+
     scope :ready_to_wake, -> { ready_to_wake_at(Time.current) }
     scope :ready_to_wake_at, ->(time) { where(wakes_at: ..time) }
     scope :expired, -> { expires_at(Time.current) }
@@ -26,7 +28,7 @@ module Operations
     def call(immediate: false)
       while active?
         Rails.logger.debug { "--- #{self}: #{current_state}" }
-        (handler_for(current_state).immediate? || immediate) ? handler_for(current_state).call(self) : go_to_sleep!
+        (handler_for(current_state).immediate? || immediate) ? call_handler : go_to_sleep!
       end
     rescue => ex
       record_error! ex
@@ -41,6 +43,8 @@ module Operations
 
     def record_error!(exception) = update!(task_status: "failed", exception_class: exception.class.to_s, exception_message: exception.message.to_s, exception_backtrace: exception.backtrace)
 
+    def call_handler = handler_for(current_state).call(self)
+
     private def go_to_sleep! = update!(default_times.merge(task_status: "waiting"))
 
     private def activate_and_call

data/lib/operations/version.rb

@@ -1,3 +1,3 @@
 module Operations
-  VERSION = "0.7.0"
+  VERSION = "0.7.1"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: standard_procedure_operations
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Rahoul Baruah
 bindir: bin
 cert_chain: []
-date: 2025-07-02 00:00:00.000000000 Z
+date: 2025-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -60,6 +60,7 @@ files:
 - app/models/operations/task/plan/result_handler.rb
 - app/models/operations/task/plan/wait_handler.rb
 - app/models/operations/task/runner.rb
+- app/models/operations/task/testing.rb
 - app/models/operations/task_participant.rb
 - config/routes.rb
 - db/migrate/20250701190516_rename_existing_operations_tables.rb