stepper_motor 0.1.7 → 0.1.9

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: stepper_motor
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.9
 platform: ruby
 authors:
 - Julik Tarkhanov
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-19 00:00:00.000000000 Z
+date: 2025-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -53,13 +52,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: globalid
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -67,49 +66,49 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: rspec-rails
+  name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -123,21 +122,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: standard
+  name: magic_frozen_string_literal
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.28.5
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.28.5
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: magic_frozen_string_literal
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -151,7 +150,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -165,7 +164,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: redcarpet
+  name: sord
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -185,23 +184,27 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rspec"
-- ".ruby-version"
-- ".standard.yml"
-- ".yardopts"
+- ".github/dependabot.yml"
+- ".github/workflows/ci.yml"
 - CHANGELOG.md
+- Gemfile
 - LICENSE.md
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
+- bin/test
 - lib/generators/install_generator.rb
 - lib/generators/stepper_motor_migration_001.rb.erb
 - lib/generators/stepper_motor_migration_002.rb.erb
+- lib/generators/stepper_motor_migration_003.rb.erb
+- lib/generators/stepper_motor_migration_004.rb.erb
 - lib/stepper_motor.rb
 - lib/stepper_motor/cyclic_scheduler.rb
 - lib/stepper_motor/forward_scheduler.rb
 - lib/stepper_motor/journey.rb
+- lib/stepper_motor/journey/flow_control.rb
+- lib/stepper_motor/journey/recovery.rb
 - lib/stepper_motor/perform_step_job.rb
 - lib/stepper_motor/perform_step_job_v2.rb
 - lib/stepper_motor/railtie.rb
@@ -209,17 +212,70 @@ files:
 - lib/stepper_motor/step.rb
 - lib/stepper_motor/test_helper.rb
 - lib/stepper_motor/version.rb
+- lib/tasks/stepper_motor_tasks.rake
+- manual/MANUAL.md
+- rbi/stepper_motor.rbi
 - sig/stepper_motor.rbs
-- spec/helpers/side_effects.rb
-- spec/spec_helper.rb
-- spec/stepper_motor/cyclic_scheduler_spec.rb
-- spec/stepper_motor/forward_scheduler_spec.rb
-- spec/stepper_motor/generator_spec.rb
-- spec/stepper_motor/journey_spec.rb
-- spec/stepper_motor/recover_stuck_journeys_job_spec.rb
-- spec/stepper_motor/recovery_spec.rb
-- spec/stepper_motor/test_helper_spec.rb
-- spec/stepper_motor_spec.rb
+- stepper_motor.gemspec
+- test/dummy/Rakefile
+- test/dummy/app/assets/stylesheets/application.css
+- test/dummy/app/controllers/application_controller.rb
+- test/dummy/app/helpers/application_helper.rb
+- test/dummy/app/jobs/application_job.rb
+- test/dummy/app/mailers/application_mailer.rb
+- test/dummy/app/models/application_record.rb
+- test/dummy/app/views/layouts/application.html.erb
+- test/dummy/app/views/layouts/mailer.html.erb
+- test/dummy/app/views/layouts/mailer.text.erb
+- test/dummy/app/views/pwa/manifest.json.erb
+- test/dummy/app/views/pwa/service-worker.js
+- test/dummy/bin/dev
+- test/dummy/bin/rails
+- test/dummy/bin/rake
+- test/dummy/bin/setup
+- test/dummy/config.ru
+- test/dummy/config/application.rb
+- test/dummy/config/boot.rb
+- test/dummy/config/cable.yml
+- test/dummy/config/database.yml
+- test/dummy/config/environment.rb
+- test/dummy/config/environments/development.rb
+- test/dummy/config/environments/production.rb
+- test/dummy/config/environments/test.rb
+- test/dummy/config/initializers/content_security_policy.rb
+- test/dummy/config/initializers/filter_parameter_logging.rb
+- test/dummy/config/initializers/inflections.rb
+- test/dummy/config/initializers/stepper_motor.rb
+- test/dummy/config/locales/en.yml
+- test/dummy/config/puma.rb
+- test/dummy/config/routes.rb
+- test/dummy/config/storage.yml
+- test/dummy/db/migrate/20250525132523_stepper_motor_migration_001.rb
+- test/dummy/db/migrate/20250525132524_stepper_motor_migration_002.rb
+- test/dummy/db/migrate/20250525132525_stepper_motor_migration_003.rb
+- test/dummy/db/migrate/20250525132526_stepper_motor_migration_004.rb
+- test/dummy/db/schema.rb
+- test/dummy/public/400.html
+- test/dummy/public/404.html
+- test/dummy/public/406-unsupported-browser.html
+- test/dummy/public/422.html
+- test/dummy/public/500.html
+- test/dummy/public/icon.png
+- test/dummy/public/icon.svg
+- test/side_effects_helper.rb
+- test/stepper_motor/cyclic_scheduler_test.rb
+- test/stepper_motor/forward_scheduler_test.rb
+- test/stepper_motor/journey/exception_handling_test.rb
+- test/stepper_motor/journey/flow_control_test.rb
+- test/stepper_motor/journey/idempotency_test.rb
+- test/stepper_motor/journey/step_definition_test.rb
+- test/stepper_motor/journey/uniqueness_test.rb
+- test/stepper_motor/journey_test.rb
+- test/stepper_motor/recover_stuck_journeys_job_test.rb
+- test/stepper_motor/recovery_test.rb
+- test/stepper_motor/test_helper_test.rb
+- test/stepper_motor_test.rb
+- test/test_helper.rb
 homepage: https://steppermotor.dev
 licenses:
 - LGPL
@@ -228,7 +284,6 @@ metadata:
   homepage_uri: https://steppermotor.dev
   source_code_uri: https://github.com/stepper-motor/stepper_motor
   changelog_uri: https://github.com/stepper-motor/stepper_motor/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -243,8 +298,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Effortless step workflows that embed nicely inside Rails
 test_files: []

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/.ruby-version

@@ -1 +0,0 @@
-3.1.1

data/.standard.yml

@@ -1,4 +0,0 @@
-ruby_version: 3.1
-ignore:
-  - 'spec/app/db/**/*':
-    - Layout/TrailingWhitespace # Templated migrations have whitespace

data/.yardopts

@@ -1 +0,0 @@
---markup markdown - docs/MANUAL.md

data/spec/helpers/side_effects.rb

@@ -1,85 +0,0 @@
-# frozen_string_literal: true
-
-module SideEffects
-  module SpecHelper
-    def self.included(into)
-      into.before(:each) { SideEffects.clear! }
-      into.after(:each) { SideEffects.clear! }
-      super
-    end
-  end
-
-  def self.produced?(name)
-    Thread.current[:side_effects].to_h.key?(name.to_s)
-  end
-
-  def self.none?
-    Thread.current[:side_effects].to_h.empty?
-  end
-
-  def self.names
-    Thread.current[:side_effects].to_h.keys.map(&:to_s)
-  end
-
-  def self.clear!
-    Thread.current[:side_effects] = {}
-  end
-
-  def self.touch!(name)
-    if Thread.current[:side_effects].nil?
-      raise <<~ERROR
-        The current thread locals do not contain :side_effects, which means that your job
-        is running on a different thread than the specs. This is probably due to bad configuration
-        of the ActiveJob test adapter.
-      ERROR
-    end
-    Thread.current[:side_effects][name.to_s] = true
-  end
-
-  RSpec::Matchers.define :have_produced_side_effects_named do |*side_effect_names|
-    match(notify_expectation_failures: true) do |actual|
-      SideEffects.clear!
-      actual.call
-      side_effect_names.each do |side_effect_name|
-        expect(SideEffects).to be_produced(side_effect_name), "The side effect named #{side_effect_name.inspect} should have been produced, but wasn't"
-      end
-      true
-    end
-
-    def supports_block_expectations?
-      true
-    end
-  end
-
-  RSpec::Matchers.define :not_have_produced_side_effects_named do |*side_effect_names|
-    match(notify_expectation_failures: true) do |actual|
-      expect(side_effect_names).not_to be_empty
-
-      SideEffects.clear!
-      actual.call
-
-      side_effect_names.each do |side_effect_name|
-        expect(SideEffects).not_to be_produced(side_effect_name), "The side effect named #{side_effect_name.inspect} should not have been produced, but was"
-      end
-
-      true
-    end
-
-    def supports_block_expectations?
-      true
-    end
-  end
-
-  RSpec::Matchers.define :not_have_produced_any_side_effects do
-    match(notify_expectation_failures: true) do |actual|
-      SideEffects.clear!
-      actual.call
-      expect(SideEffects).to be_none
-      true
-    end
-
-    def supports_block_expectations?
-      true
-    end
-  end
-end

data/spec/spec_helper.rb

@@ -1,90 +0,0 @@
-# frozen_string_literal: true
-
-require "stepper_motor"
-require "active_support/testing/time_helpers"
-require "active_job"
-require "active_record"
-require "globalid"
-require_relative "helpers/side_effects"
-require "fileutils"
-
-module StepperMotorRailtieTestHelpers
-  def establish_test_connection
-    ActiveRecord::Base.establish_connection(adapter: "sqlite3", database: fake_app_root + "/db.sqlite3")
-    StepperMotor::InstallGenerator.source_root(File.dirname(__FILE__) + "/../../lib")
-  end
-
-  def fake_app_root
-    File.dirname(__FILE__) + "/app"
-  end
-
-  def run_generator
-    generator = StepperMotor::InstallGenerator.new
-    generator.destination_root = fake_app_root
-    generator.create_migration_file
-  end
-
-  def run_migrations
-    # Before running the migrations we need to require the migration files, since there is no
-    # "full" Rails environment available
-    Dir.glob(fake_app_root + "/db/migrate/*.rb").sort.each do |migration_file_path|
-      require migration_file_path
-    end
-
-    ActiveRecord::Migrator.migrations_paths = [File.join(fake_app_root + "/db/migrate")]
-    ActiveRecord::Tasks::DatabaseTasks.root = fake_app_root
-    ActiveRecord::Tasks::DatabaseTasks.migrate
-  end
-  extend self
-end
-
-module ActiveSupportTestCaseMethodsStub
-  def self.included(into)
-    into.before(:each) { before_setup }
-    into.after(:each) { after_teardown }
-  end
-
-  def before_setup
-    # Blank implementation as TestCase modules super() into it
-  end
-
-  def after_teardown
-    # Blank implementation as TestCase modules super() into it
-  end
-end
-
-module JourneyDefinitionHelper
-  def create_journey_subclass(&blk)
-    # https://stackoverflow.com/questions/4113479/dynamic-class-definition-with-a-class-name
-    random_component = Random.hex(2)
-    random_name = "JourneySubclass#{random_component}"
-    klass = Class.new(StepperMotor::Journey, &blk)
-    Object.const_set(random_name, klass)
-    klass
-  end
-end
-
-RSpec.configure do |config|
-  # Enable flags like --only-failures and --next-failure
-  config.example_status_persistence_file_path = ".rspec_status"
-
-  # Disable RSpec exposing methods globally on `Module` and `main`
-  config.disable_monkey_patching!
-
-  config.expect_with :rspec do |c|
-    c.syntax = :expect
-  end
-
-  config.include ActiveSupport::Testing::TimeHelpers
-  config.include StepperMotorRailtieTestHelpers
-  config.include SideEffects::SpecHelper
-  config.include ActiveSupportTestCaseMethodsStub
-  config.include JourneyDefinitionHelper
-
-  config.before :suite do
-    StepperMotorRailtieTestHelpers.establish_test_connection
-    StepperMotorRailtieTestHelpers.run_generator
-    StepperMotorRailtieTestHelpers.run_migrations
-    ActiveJob::Base.logger.level = Logger::FATAL
-  end
-end

data/spec/stepper_motor/cyclic_scheduler_spec.rb

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../spec_helper"
-
-RSpec.describe "StepperMotor::CyclicScheduler" do
-  include ActiveJob::TestHelper
-
-  before do
-    @previous_scheduler = StepperMotor.scheduler
-    StepperMotor::Journey.delete_all
-  end
-
-  after do
-    StepperMotor.scheduler = @previous_scheduler
-  end
-
-  def far_future_journey_class
-    @klass ||= create_journey_subclass do
-      step :do_thing, wait: 40.minutes do
-        raise "We do not test this so it should never run"
-      end
-    end
-  end
-
-  it "does not schedule a journey which is too far in the future" do
-    scheduler = StepperMotor::CyclicScheduler.new(cycle_duration: 30.seconds)
-    StepperMotor.scheduler = scheduler
-
-    expect(scheduler).to receive(:schedule).with(instance_of(far_future_journey_class)).once.and_call_original
-    _journey = far_future_journey_class.create!
-
-    expect(scheduler).not_to receive(:schedule)
-    scheduler.run_scheduling_cycle
-  end
-
-  it "only schedules journeys which are within its execution window" do
-    scheduler = StepperMotor::CyclicScheduler.new(cycle_duration: 40.minutes)
-    StepperMotor.scheduler = scheduler
-
-    expect(scheduler).to receive(:schedule).with(instance_of(far_future_journey_class)).once.and_call_original
-    journey = far_future_journey_class.create!
-
-    expect(scheduler).to receive(:schedule).with(journey).and_call_original
-    scheduler.run_scheduling_cycle
-  end
-
-  it "also schedules journeys which had to run in the past" do
-    scheduler = StepperMotor::CyclicScheduler.new(cycle_duration: 10.seconds)
-    StepperMotor.scheduler = scheduler
-
-    expect(scheduler).to receive(:schedule).with(instance_of(far_future_journey_class)).once.and_call_original
-    journey = far_future_journey_class.create!
-    journey.update!(next_step_to_be_performed_at: 10.minutes.ago)
-
-    expect(scheduler).to receive(:schedule).with(journey).and_call_original
-    scheduler.run_scheduling_cycle
-  end
-
-  it "performs the scheduling job" do
-    scheduler = StepperMotor::CyclicScheduler.new(cycle_duration: 10.seconds)
-    StepperMotor.scheduler = scheduler
-    job_class = StepperMotor::CyclicScheduler::RunSchedulingCycleJob
-    expect(scheduler).to receive(:run_scheduling_cycle).and_call_original
-    job_class.perform_now
-  end
-
-  it "does not perform the job if the configured scheduler is not the CyclicScheduler"
-end

data/spec/stepper_motor/generator_spec.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../spec_helper"
-
-RSpec.describe "StepperMotor::InstallGenerator" do
-  it "is able to set up a test database" do
-    expect {
-      establish_test_connection
-      run_generator
-      run_migrations
-    }.not_to raise_error
-    expect(ActiveRecord::Base.connection.tables).to include("stepper_motor_journeys")
-  ensure
-    FileUtils.rm_rf(fake_app_root)
-  end
-end