light-service 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4063f9a4d12da971cb46bea573e9961eb88cbdfd10e4e5fd9723a0d865556228
-  data.tar.gz: a0cfdeea54d3410fe65766fc2565f99beecdce130ed57cde52783481c5db5bb7
+  metadata.gz: 8aa95d9b98d8f7f1337072fa420f5a964cd497831e9ab40518719cc02ff86cdb
+  data.tar.gz: 804c6c26860cb0f9f6c31eede5894d492023753dc61950cde52db9049e6002f6
 SHA512:
-  metadata.gz: 16838fb136fad01357dd866f5cfff56070e7141a6a1bb034a72f86a808f1b58baa39f1c565f9c8b32abea7b398381630bc2b63baebcb537718e645aec3ba04b3
-  data.tar.gz: d86bc97f33127bc07cdee6962edb9e8fd1ad363e01fe0feff3c719ce49c681c6ead6384274960bb56617ffbd1dfaefc20002ad8dc8482051d97b77eb0fcfcb09
+  metadata.gz: d0e4928cde90d7ceaea837220c8cc1c1aa943f5264999e5585a250dbcac13f69bbc432b988ba88ed00eb9829957f3b794ae8656347b1e344b6830a151438a544
+  data.tar.gz: ab9aa8e27f06fd90cae15e3ec11e6fbe156a9cef17754a20425dbfedf258070095ed51a398940043e912a959121370749243e178fad518ef743fff45fcb426ae

data/.github/workflows/project-build.yml

@@ -12,7 +12,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest]
-        ruby: ['3.1', '3.2', '3.3']
+        ruby: ['3.2', '3.3', '3.4', '4.0']
     runs-on: ${{ matrix.os }}
     continue-on-error: ${{ endsWith(matrix.ruby, 'head') || matrix.ruby == 'debug' }}
     env:

data/.rubocop.yml

@@ -62,7 +62,7 @@ Lint/EmptyClass:
     - 'spec/**/*.rb'
 
 # Defaults after the Rubocop upgrade
-Gemspec/DateAssignment: # new in 1.10
+Gemspec/DeprecatedAttributeAssignment: # new in 1.10
   Enabled: true
 Layout/LineEndStringConcatenationIndentation: # new in 1.18
   Enabled: true

data/README.md

@@ -5,7 +5,6 @@
 [![Codecov](https://codecov.io/gh/adomokos/light-service/branch/main/graph/badge.svg)](https://codecov.io/gh/adomokos/light-service)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](http://opensource.org/licenses/MIT)
 [![Download Count](https://img.shields.io/badge/download%3A-~5%20million-blue)](https://rubygems.org/gems/light-service)
-[![Code Climate](https://codeclimate.com/github/adomokos/light-service.svg)](https://codeclimate.com/github/adomokos/light-service)
 
 LightService is a powerful and flexible service skeleton framework with an emphasis on simplicity
 
@@ -20,6 +19,7 @@ LightService is a powerful and flexible service skeleton framework with an empha
 - [Stopping the Series of Actions](#stopping-the-series-of-actions)
   - [Failing the Context](#failing-the-context)
   - [Skipping the rest of the actions](#skipping-the-rest-of-the-actions)
+  - [Skipping ALL the rest of the actions](#skipping-all-the-rest-of-the-actions)
 - [Benchmarking Actions with Around Advice](#benchmarking-actions-with-around-advice)
 - [Before and After Action Hooks](#before-and-after-action-hooks)
 - [Expects and Promises](#expects-and-promises)
@@ -397,6 +397,24 @@ end
 
 In the example above the organizer called 4 actions. The first 2 actions got executed successfully. The 3rd decided to skip the rest, the 4th action was not invoked. The context was successful.
 
+### Skipping ALL the rest of the actions
+While `context.skip_remaining!` skips actions in the current scope (e.g. inside a `reduce_if` or `iterate` block), sometimes you want to halt the entire execution of the organizer and any parent organizers. You can do this by calling `context.skip_all_remaining!`.
+
+Consider this example:
+
+```ruby
+def self.actions
+  [
+    reduce_if(->(ctx) { ctx.should_execute_conditional_actions }, [
+      ConditionallyRunAction1, # calls ctx.skip_all_remaining!
+      ConditionallyRunAction2, # skipped
+    ]),
+    AlwaysRunAction, # also skipped with skip_all_remaining!
+  ]
+end
+```
+
+In this case, `AlwaysRunAction` will be skipped if `skip_all_remaining!` was called inside the `reduce_if` block. If `skip_remaining!` had been used instead, `AlwaysRunAction` would still execute because the "skip" state is normally reset when exiting a scoped block.
 
 ## Benchmarking Actions with Around Advice
 Benchmarking your action is needed when you profile the series of actions. You could add benchmarking logic to each and every action, however, that would blur the business logic you have in your actions.
@@ -438,6 +456,7 @@ Any object passed into `around_each` must respond to #call with two arguments: t
 ## Before and After Action Hooks
 
 In case you need to inject code right before and after the actions are executed, you can use the `before_actions` and `after_actions` hooks. It accepts one or multiple lambdas that the Action implementation will invoke. This addition to LightService is a great way to decouple instrumentation from business logic.
+One important note: these actions only run on the first call to the organizer. Subsequent calls will skip both the before and after actions.
 
 Consider this code:
 
@@ -1026,20 +1045,23 @@ end
 
 This code is much easier to reason about, it's less noisy and it captures the goal of LightService well: simple, declarative code that's easy to understand.
 
-The 9 different orchestrator constructs an organizer can have:
+The 10 different orchestrator constructs an organizer can have:
 
 1. `reduce_until`
-2. `reduce_if`
-3. `reduce_if_else`
-4. `reduce_case`
-5. `iterate`
-6. `execute`
-7. `with_callback`
-8. `add_to_context`
-9. `add_aliases`
+2. `reduce_while`
+3. `reduce_if`
+4. `reduce_if_else`
+5. `reduce_case`
+6. `iterate`
+7. `execute`
+8. `with_callback`
+9. `add_to_context`
+10. `add_aliases`
 
 `reduce_until` behaves like a while loop in imperative languages, it iterates until the provided predicate in the lambda evaluates to true. Take a look at [this acceptance test](spec/acceptance/organizer/reduce_until_spec.rb) to see how it's used.
 
+`reduce_while` checks the provided predicate before each individual action in its step list. If the predicate evaluates to false, the remaining actions in the block are skipped. Unlike `reduce_until`, it is not a loop — it makes a single pass through the steps with a per-action condition gate. [This acceptance test](spec/acceptance/organizer/reduce_while_spec.rb) describes this functionality.
+
 `reduce_if` will reduce the included organizers and/or actions if the predicate in the lambda evaluates to true. [This acceptance test](spec/acceptance/organizer/reduce_if_spec.rb) describes this functionality.
 
 `reduce_if_else` takes three arguments, a condition lambda, a first set of "if true" steps, and a second set of "if false" steps. If the lambda evaluates to true, the "if true" steps are executed, otherwise the "else steps" are executed. [This acceptance test](spec/acceptance/organizer/reduce_if_else_spec.rb) describes this functionality.

data/RELEASES.md

@@ -1,5 +1,11 @@
 A brief list of new features and changes introduced with the specified version.
 
+### 0.21.0
+* [Add skip_all_remaining!](https://github.com/adomokos/light-service/pull/279)
+* [Fix skip_all_remaining! message preservation](https://github.com/adomokos/light-service/pull/280)
+* [Fix infinite recursion in LightService::Deprecation.warn](https://github.com/adomokos/light-service/pull/283)
+* [Add reduce_while orchestrator construct](https://github.com/adomokos/light-service/pull/284)
+
 ### 0.20.0
 * [Add back ActiveSupport](https://github.com/adomokos/light-service/pull/259)
 * [Fix argument errors of LightService::LocalizationAdapter](https://github.com/adomokos/light-service/pull/263)

data/lib/light-service/context.rb

@@ -18,6 +18,7 @@ module LightService
       @message = message
       @error_code = error_code
       @skip_remaining = false
+      @skip_all_remaining = false
 
       context.to_hash.each { |k, v| self[k] = v }
     end
@@ -51,6 +52,10 @@ module LightService
       @skip_remaining
     end
 
+    def skip_all_remaining?
+      @skip_all_remaining
+    end
+
     def reset_skip_remaining!
       @message = nil
       @skip_remaining = false
@@ -111,8 +116,13 @@ module LightService
       @skip_remaining = true
     end
 
+    def skip_all_remaining!(message = nil)
+      @message = message
+      @skip_all_remaining = true
+    end
+
     def stop_processing?
-      failure? || skip_remaining?
+      failure? || skip_remaining? || skip_all_remaining?
     end
 
     def define_accessor_methods_for_keys(keys)
@@ -153,7 +163,8 @@ module LightService
 
     def inspect
       "#{self.class}(#{self}, success: #{success?}, message: #{check_nil(message)}, error_code: " \
-        "#{check_nil(error_code)}, skip_remaining: #{@skip_remaining}, aliases: #{@aliases})"
+        "#{check_nil(error_code)}, skip_remaining: #{@skip_remaining}, " \
+        "skip_all_remaining: #{@skip_all_remaining}, aliases: #{@aliases})"
     end
 
     private

data/lib/light-service/deprecation_warning.rb

@@ -1,7 +1,6 @@
 module LightService
   module Deprecation
     class << self
-      # :nocov:
       # Basic implementation of a deprecation warning
       def warn(message, callstack = caller)
         # Construct the warning message
@@ -9,11 +8,10 @@ module LightService
         warning_message += "Called from: #{callstack.first}\n" unless callstack.empty?
 
         # Output the warning message to stderr or a log file
-        warn warning_message
+        Kernel.warn warning_message
 
         # Additional logging or actions can be added here
       end
-      # :nocov:
     end
   end
 end

data/lib/light-service/organizer/iterate.rb

@@ -10,6 +10,8 @@ module LightService
           collection = ctx[collection_key]
           item_key = collection_key.to_s.singularize.to_sym
           collection.each do |item|
+            break if ctx.stop_processing?
+
             ctx[item_key] = item
             ctx = scoped_reduce(organizer, ctx, steps)
           end

data/lib/light-service/organizer/reduce_until.rb

@@ -9,7 +9,7 @@ module LightService
 
           loop do
             ctx = scoped_reduce(organizer, ctx, steps)
-            break if condition_block.call(ctx) || ctx.failure?
+            break if condition_block.call(ctx) || ctx.stop_processing?
           end
 
           ctx

data/lib/light-service/organizer/reduce_while.rb

@@ -0,0 +1,29 @@
+module LightService
+  module Organizer
+    class ReduceWhile
+      def self.run(organizer, condition_block, steps)
+        lambda do |ctx|
+          return ctx if ctx.stop_processing?
+
+          reset_skip(ctx)
+
+          Array(steps).each do |step|
+            break unless condition_block.call(ctx)
+
+            ctx = organizer.with(ctx).reduce([step])
+            break if ctx.stop_processing?
+          end
+
+          reset_skip(ctx)
+
+          ctx
+        end
+      end
+
+      def self.reset_skip(ctx)
+        ctx.reset_skip_remaining! unless ctx.failure? || ctx.skip_all_remaining?
+      end
+      private_class_method :reset_skip
+    end
+  end
+end

data/lib/light-service/organizer/scoped_reducable.rb

@@ -2,9 +2,9 @@ module LightService
   module Organizer
     module ScopedReducable
       def scoped_reduce(organizer, ctx, steps)
-        ctx.reset_skip_remaining! unless ctx.failure?
+        ctx.reset_skip_remaining! unless ctx.failure? || ctx.skip_all_remaining?
         ctx = organizer.with(ctx).reduce([steps])
-        ctx.reset_skip_remaining! unless ctx.failure?
+        ctx.reset_skip_remaining! unless ctx.failure? || ctx.skip_all_remaining?
 
         ctx
       end

data/lib/light-service/organizer/with_reducer_log_decorator.rb

@@ -91,7 +91,8 @@ module LightService
       end
 
       def skip_remaining?(context)
-        context.respond_to?(:skip_remaining?) && context.skip_remaining?
+        (context.respond_to?(:skip_remaining?) && context.skip_remaining?) ||
+          (context.respond_to?(:skip_all_remaining?) && context.skip_all_remaining?)
       end
 
       def write_skip_remaining_log(context, action)

data/lib/light-service/organizer.rb

@@ -47,6 +47,10 @@ module LightService
         ReduceUntil.run(self, condition_block, steps)
       end
 
+      def reduce_while(condition_block, steps)
+        ReduceWhile.run(self, condition_block, steps)
+      end
+
       def reduce_case(**args)
         ReduceCase.run(self, **args)
       end
@@ -55,8 +59,8 @@ module LightService
         Iterate.run(self, collection_key, steps)
       end
 
-      def execute(code_block)
-        Execute.run(code_block)
+      def execute(code_block = nil, &block)
+        Execute.run(code_block || block)
       end
 
       def with_callback(action, steps)

data/lib/light-service/version.rb

@@ -1,3 +1,3 @@
 module LightService
-  VERSION = "0.20.0".freeze
+  VERSION = "0.21.0".freeze
 end

data/lib/light-service.rb

@@ -18,6 +18,7 @@ require 'light-service/organizer/with_reducer_factory'
 require 'light-service/organizer/reduce_if'
 require 'light-service/organizer/reduce_if_else'
 require 'light-service/organizer/reduce_until'
+require 'light-service/organizer/reduce_while'
 require 'light-service/organizer/reduce_case'
 require 'light-service/organizer/iterate'
 require 'light-service/organizer/execute'

data/light-service.gemspec

@@ -19,12 +19,14 @@ Gem::Specification.new do |gem|
 
   gem.add_dependency("activesupport", ">= 5.0", "< 9.0")
 
-  gem.add_development_dependency("generator_spec", "~> 0.9.4")
-  gem.add_development_dependency("test-unit", "~> 3.0") # Needed for generator specs.
-  gem.add_development_dependency("rspec", "~> 3.0")
-  gem.add_development_dependency("simplecov", "~> 0.17")
-  gem.add_development_dependency("simplecov-cobertura", "~> 2.1")
-  gem.add_development_dependency("rubocop", "~> 1.26.0")
-  gem.add_development_dependency("rubocop-performance", "~> 1.2.0")
-  gem.add_development_dependency("pry", "~> 0.14")
+  gem.add_development_dependency("generator_spec", "~> 0.10")
+  gem.add_development_dependency("test-unit", "~> 3.6") # Needed for generator specs.
+  gem.add_development_dependency("rspec", "~> 3.13")
+  gem.add_development_dependency("simplecov", "~> 0.22")
+  gem.add_development_dependency("simplecov-cobertura", "~> 3.1")
+  gem.add_development_dependency("rubocop", "~> 1.75")
+  gem.add_development_dependency("rubocop-performance", "~> 1.2")
+  gem.add_development_dependency("pry", "~> 0.15")
+  gem.add_development_dependency("ostruct", "~> 0.6")
+  gem.add_development_dependency("benchmark", "~> 0.3")
 end

data/spec/acceptance/organizer/reduce_if_spec.rb

@@ -63,21 +63,19 @@ RSpec.describe LightService::Organizer do
         reduce(actions)
       end
 
-      # rubocop:disable Metrics/AbcSize
       def self.actions
         [
           reduce_if(
             ->(c) { !c.nil? },
             [
               execute(->(c) { c[:first_reduce_if] = true }),
-              execute(->(c) { c.skip_remaining! }),
+              execute(&:skip_remaining!),
               execute(->(c) { c[:second_reduce_if] = true })
             ]
           ),
           execute(->(c) { c[:last_outside] = true })
         ]
       end
-      # rubocop:enable Metrics/AbcSize
     end
 
     result = org.call

data/spec/acceptance/organizer/reduce_while_spec.rb

@@ -0,0 +1,96 @@
+require 'spec_helper'
+require 'test_doubles'
+
+RSpec.describe LightService::Organizer do
+  class TestReduceWhile
+    extend LightService::Organizer
+
+    def self.call(context)
+      with(context).reduce(actions)
+    end
+
+    def self.actions
+      [
+        reduce_while(->(ctx) { ctx[:number] < 3 }, [
+                       TestDoubles::AddsOneAction,
+                       TestDoubles::AddsTwoAction
+                     ])
+      ]
+    end
+  end
+
+  let(:empty_context) { LightService::Context.make }
+
+  it 'reduces while the block evaluates to true' do
+    result = TestReduceWhile.call(:number => 0)
+
+    expect(result).to be_success
+    expect(result[:number]).to eq(3)
+  end
+
+  it 'checks the condition before each action' do
+    result = TestReduceWhile.call(:number => 2)
+
+    expect(result).to be_success
+    expect(result[:number]).to eq(3)
+  end
+
+  it 'does not execute any steps when the condition is false from the start' do
+    result = TestReduceWhile.call(:number => 5)
+
+    expect(result).to be_success
+    expect(result[:number]).to eq(5)
+  end
+
+  it 'does not execute on failed context' do
+    empty_context.fail!('Something bad happened')
+
+    result = TestReduceWhile.call(empty_context)
+    expect(result).to be_failure
+  end
+
+  it 'does not execute a skipped context' do
+    empty_context.skip_remaining!('No more needed')
+
+    result = TestReduceWhile.call(empty_context)
+    expect(result).to be_success
+  end
+
+  it "is expected to know its organizer when reducing while a condition" do
+    result = TestReduceWhile.call(:number => 0)
+
+    expect(result.organized_by).to eq TestReduceWhile
+  end
+
+  it 'skips actions within its own scope' do
+    org = Class.new do
+      extend LightService::Organizer
+
+      def self.call
+        reduce(actions)
+      end
+
+      def self.actions
+        [
+          reduce_while(
+            ->(c) { !c.nil? },
+            [
+              execute(->(c) { c[:first_reduce_while] = true }),
+              execute(&:skip_remaining!),
+              execute(->(c) { c[:second_reduce_while] = true })
+            ]
+          ),
+          execute(->(c) { c[:last_outside] = true })
+        ]
+      end
+    end
+
+    result = org.call
+
+    aggregate_failures do
+      expect(result[:first_reduce_while]).to be true
+      expect(result[:second_reduce_while]).to be_nil
+      expect(result[:last_outside]).to be true
+    end
+  end
+end

data/spec/acceptance/skip_all_remaining_spec.rb

@@ -0,0 +1,139 @@
+require 'spec_helper'
+
+RSpec.describe "skip_all_remaining!" do
+  context "with regular organizer" do
+    let(:organizer) do
+      Class.new do
+        extend LightService::Organizer
+
+        def self.call(ctx)
+          with(ctx).reduce(actions)
+        end
+
+        def self.actions
+          [
+            execute(->(c) { c[:first] = true }),
+            execute(lambda(&:skip_all_remaining!)),
+            execute(->(c) { c[:second] = true })
+          ]
+        end
+      end
+    end
+
+    it "skips all remaining actions" do
+      result = organizer.call(LightService::Context.make)
+
+      expect(result[:first]).to be true
+      expect(result[:second]).to be_nil
+    end
+  end
+
+  context "with an organizer with a reducer" do
+    let(:organizer) do
+      Class.new do
+        extend LightService::Organizer
+
+        def self.call(ctx)
+          with(ctx).reduce(actions)
+        end
+
+        def self.actions
+          [
+            reduce_if(
+              ->(_) { true },
+              [
+                execute(->(c) { c[:first_inside] = true }),
+                execute(lambda(&:skip_all_remaining!)),
+                execute(->(c) { c[:second_inside] = true })
+              ]
+            ),
+            execute(->(c) { c[:outside] = true })
+          ]
+        end
+      end
+    end
+
+    it "skips all remaining actions inside and outside the reducer" do
+      result = organizer.call(LightService::Context.make)
+
+      expect(result[:first_inside]).to be true
+      expect(result[:second_inside]).to be_nil
+      expect(result[:outside]).to be_nil
+    end
+  end
+
+  context "with a message" do
+    let(:organizer) do
+      Class.new do
+        extend LightService::Organizer
+
+        def self.call(ctx)
+          with(ctx).reduce(actions)
+        end
+
+        def self.actions
+          [
+            reduce_if(
+              ->(_) { true },
+              [
+                execute(->(c) { c.skip_all_remaining!("Skipping with message") })
+              ]
+            ),
+            execute(->(c) { c[:outside] = true })
+          ]
+        end
+      end
+    end
+
+    it "preserves the message when exiting scoped reducers" do
+      result = organizer.call(LightService::Context.make)
+
+      expect(result.message).to eq("Skipping with message")
+      expect(result[:outside]).to be_nil
+    end
+  end
+
+  context "with an organizer with nested reducers" do
+    let(:organizer) do
+      Class.new do
+        extend LightService::Organizer
+
+        def self.call(ctx)
+          with(ctx).reduce(actions)
+        end
+
+        def self.actions # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+          [
+            reduce_if(
+              ->(_) { true },
+              [
+                iterate(:items, [
+                          execute(lambda { |c|
+                            c[:executed_items] ||= []
+                            c[:executed_items] << c[:item]
+                          }),
+                          execute(->(c) { c.skip_all_remaining! if c[:item] == 2 }),
+                          execute(lambda { |c|
+                            c[:skipped_in_iterate] ||= []
+                            c[:skipped_in_iterate] << c[:item]
+                          })
+                        ]),
+                execute(->(c) { c[:after_iterate_inside_if] = true })
+              ]
+            ),
+            execute(->(c) { c[:outside] = true })
+          ]
+        end
+      end
+    end
+
+    it "skips all remaining actions across all nested scopes" do
+      result = organizer.call(LightService::Context.make(:items => [1, 2, 3]))
+
+      expect(result[:executed_items]).to eq([1, 2])
+      expect(result[:skipped_in_iterate]).to eq([1])
+      expect(result[:after_iterate_inside_if]).to be_nil
+      expect(result[:outside]).to be_nil
+    end
+  end
+end

data/spec/acceptance/skip_remaining_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+RSpec.describe "skip_remaining!" do
+  context "with regular organizer" do
+    let(:organizer) do
+      Class.new do
+        extend LightService::Organizer
+
+        def self.call(ctx)
+          with(ctx).reduce(actions)
+        end
+
+        def self.actions
+          [
+            execute(->(c) { c[:first] = true }),
+            execute(lambda(&:skip_remaining!)),
+            execute(->(c) { c[:second] = true })
+          ]
+        end
+      end
+    end
+
+    it "skips the remaining actions in the organizer" do
+      result = organizer.call(LightService::Context.make)
+
+      expect(result[:first]).to be true
+      expect(result[:second]).to be_nil
+    end
+  end
+
+  context "with an organizer with a reducer" do
+    let(:organizer) do
+      Class.new do
+        extend LightService::Organizer
+
+        def self.call(ctx)
+          with(ctx).reduce(actions)
+        end
+
+        def self.actions # rubocop:disable Metrics/AbcSize
+          [
+            iterate(:items, [
+                      execute(lambda { |c|
+                        c[:executed_items] ||= []
+                        c[:executed_items] << c[:item]
+                      }),
+                      execute(->(c) { c.skip_remaining! if c[:item] == 2 }),
+                      execute(lambda { |c|
+                        c[:skipped_actions] ||= []
+                        c[:skipped_actions] << c[:item]
+                      })
+                    ]),
+            execute(->(c) { c[:outside_iterate] = true })
+          ]
+        end
+      end
+    end
+
+    it "only skips remaining actions for the current item in the reducer" do
+      result = organizer.call(LightService::Context.make(:items => [1, 2, 3]))
+
+      expect(result[:executed_items]).to eq([1, 2, 3])
+      expect(result[:skipped_actions]).to eq([1, 3])
+      expect(result[:outside_iterate]).to be true
+    end
+  end
+end
+

data/spec/context/inspect_spec.rb

@@ -13,7 +13,8 @@ RSpec.describe LightService::Context do
   describe '#inspect' do
     it 'inspects the hash with all the fields' do
       inspected_context =
-        "LightService::Context({}, success: true, message: '', error_code: nil, skip_remaining: false, aliases: {})"
+        "LightService::Context({}, success: true, message: '', error_code: nil, skip_remaining: false, " \
+        "skip_all_remaining: false, aliases: {})"
 
       expect(context.inspect).to eq(inspected_context)
     end
@@ -23,7 +24,7 @@ RSpec.describe LightService::Context do
 
       inspected_context =
         "LightService::Context({}, success: false, message: 'There was an error', error_code: nil, " \
-        "skip_remaining: false, aliases: {})"
+        "skip_remaining: false, skip_all_remaining: false, aliases: {})"
 
       expect(context.inspect).to eq(inspected_context)
     end
@@ -33,7 +34,7 @@ RSpec.describe LightService::Context do
 
       inspected_context =
         "LightService::Context({}, success: true, message: 'No need to process', error_code: nil, " \
-        "skip_remaining: true, aliases: {})"
+        "skip_remaining: true, skip_all_remaining: false, aliases: {})"
 
       expect(context.inspect).to eq(inspected_context)
     end

data/spec/lib/deprecation_warning_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+RSpec.describe LightService::Deprecation do
+  describe '.warn' do
+    it 'outputs a deprecation warning to stderr' do
+      expect { described_class.warn('foo is deprecated') }
+        .to output(/DEPRECATION WARNING: foo is deprecated/).to_stderr
+    end
+
+    it 'includes the caller location' do
+      expect { described_class.warn('bar is deprecated') }
+        .to output(/Called from:/).to_stderr
+    end
+
+    it 'calls Kernel.warn instead of recursing into itself' do
+      expect(Kernel).to receive(:warn).with(/DEPRECATION WARNING: test message/)
+      described_class.warn('test message')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -3,17 +3,15 @@ $LOAD_PATH << File.join(File.dirname(__FILE__))
 
 if ENV['RUN_COVERAGE_REPORT']
   require 'simplecov'
+  require 'simplecov-cobertura'
 
   SimpleCov.start do
     add_filter 'vendor/'
     add_filter %r{^/spec/}
+
+    formatter SimpleCov::Formatter::CoberturaFormatter
   end
   SimpleCov.minimum_coverage_by_file 90
-
-  require 'simplecov-cobertura'
-  SimpleCov.formatter = SimpleCov::Formatter::CoberturaFormatter
-  # require 'codecov'
-  # SimpleCov.formatter = SimpleCov::Formatter::Codecov
 end
 
 require 'light-service'

data/spec/test_doubles.rb

@@ -407,6 +407,24 @@ module TestDoubles
     end
   end
 
+  class ReduceWhileOrganizer
+    extend LightService::Organizer
+
+    def self.call(ctx)
+      with(ctx).reduce(actions)
+    end
+
+    def self.actions
+      [
+        AddsOneAction,
+        reduce_while(->(ctx) { ctx.number < 7 }, [
+                       AddsTwoAction,
+                       AddsThreeAction
+                     ])
+      ]
+    end
+  end
+
   class ReduceIfOrganizer
     extend LightService::Organizer
 

data/spec/testing/context_factory/reduce_while_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+require 'test_doubles'
+
+RSpec.describe 'ContextFactory - used with ReduceWhileOrganizer' do
+  let(:organizer) { TestDoubles::ReduceWhileOrganizer }
+
+  context 'when called with truthy block' do
+    it 'creates a context up-to the action defined before the reduce_while' do
+      ctx =
+        LightService::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsTwoAction)
+        .with(:number => 1)
+
+      expect(ctx[:number]).to eq(2)
+    end
+
+    it 'creates a context up-to the second step of the reduce_while' do
+      ctx =
+        LightService::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsThreeAction)
+        .with(:number => 1)
+
+      expect(ctx.number).to eq(4)
+    end
+  end
+
+  context 'when called with falsey block' do
+    it 'creates a context without executing the reduce_while steps' do
+      ctx =
+        LightService::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsThreeAction)
+        .with(:number => 7)
+
+      expect(ctx[:number]).to eq(8)
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: light-service
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Attila Domokos
 bindir: bin
 cert_chain: []
-date: 2025-05-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -35,112 +35,140 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.4
+        version: '0.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.4
+        version: '0.10'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.6'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.13'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.22'
 - !ruby/object:Gem::Dependency
   name: simplecov-cobertura
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '3.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.0
+        version: '1.75'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.0
+        version: '1.75'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: '1.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
 description: A service skeleton with an emphasis on simplicity
 email:
 - adomokos@gmail.com
@@ -184,6 +212,7 @@ files:
 - lib/light-service/organizer/reduce_if.rb
 - lib/light-service/organizer/reduce_if_else.rb
 - lib/light-service/organizer/reduce_until.rb
+- lib/light-service/organizer/reduce_while.rb
 - lib/light-service/organizer/scoped_reducable.rb
 - lib/light-service/organizer/verify_call_method_exists.rb
 - lib/light-service/organizer/with_callback.rb
@@ -226,9 +255,12 @@ files:
 - spec/acceptance/organizer/reduce_if_else_spec.rb
 - spec/acceptance/organizer/reduce_if_spec.rb
 - spec/acceptance/organizer/reduce_until_spec.rb
+- spec/acceptance/organizer/reduce_while_spec.rb
 - spec/acceptance/organizer/with_callback_spec.rb
 - spec/acceptance/rollback_spec.rb
+- spec/acceptance/skip_all_remaining_spec.rb
 - spec/acceptance/skip_all_warning_spec.rb
+- spec/acceptance/skip_remaining_spec.rb
 - spec/acceptance/testing/context_factory_spec.rb
 - spec/action_expected_keys_spec.rb
 - spec/action_expects_and_promises_spec.rb
@@ -238,6 +270,7 @@ files:
 - spec/context/inspect_spec.rb
 - spec/context_spec.rb
 - spec/i18n_localization_adapter_spec.rb
+- spec/lib/deprecation_warning_spec.rb
 - spec/lib/generators/action_generator_advanced_spec.rb
 - spec/lib/generators/action_generator_simple_spec.rb
 - spec/lib/generators/full_generator_test_blobs.rb
@@ -261,6 +294,7 @@ files:
 - spec/testing/context_factory/iterate_spec.rb
 - spec/testing/context_factory/reduce_if_spec.rb
 - spec/testing/context_factory/reduce_until_spec.rb
+- spec/testing/context_factory/reduce_while_spec.rb
 - spec/testing/context_factory/with_callback_spec.rb
 - spec/testing/context_factory_spec.rb
 homepage: https://github.com/adomokos/light-service
@@ -281,7 +315,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.6
 specification_version: 4
 summary: A service skeleton with an emphasis on simplicity
 test_files:
@@ -313,9 +347,12 @@ test_files:
 - spec/acceptance/organizer/reduce_if_else_spec.rb
 - spec/acceptance/organizer/reduce_if_spec.rb
 - spec/acceptance/organizer/reduce_until_spec.rb
+- spec/acceptance/organizer/reduce_while_spec.rb
 - spec/acceptance/organizer/with_callback_spec.rb
 - spec/acceptance/rollback_spec.rb
+- spec/acceptance/skip_all_remaining_spec.rb
 - spec/acceptance/skip_all_warning_spec.rb
+- spec/acceptance/skip_remaining_spec.rb
 - spec/acceptance/testing/context_factory_spec.rb
 - spec/action_expected_keys_spec.rb
 - spec/action_expects_and_promises_spec.rb
@@ -325,6 +362,7 @@ test_files:
 - spec/context/inspect_spec.rb
 - spec/context_spec.rb
 - spec/i18n_localization_adapter_spec.rb
+- spec/lib/deprecation_warning_spec.rb
 - spec/lib/generators/action_generator_advanced_spec.rb
 - spec/lib/generators/action_generator_simple_spec.rb
 - spec/lib/generators/full_generator_test_blobs.rb
@@ -348,5 +386,6 @@ test_files:
 - spec/testing/context_factory/iterate_spec.rb
 - spec/testing/context_factory/reduce_if_spec.rb
 - spec/testing/context_factory/reduce_until_spec.rb
+- spec/testing/context_factory/reduce_while_spec.rb
 - spec/testing/context_factory/with_callback_spec.rb
 - spec/testing/context_factory_spec.rb