discourse/lib/service/base
Loïc Guitaut 3ed866a6c9
DEV: Add each step to service framework for collection iteration (#38759)
Services that process collections (bulk delete, bulk create, etc.)
currently require manual iteration inside a `step`, losing the
framework's built-in error handling and inspection. This adds a
first-class `each` step that brings the full service DSL inside the
iteration loop.

```ruby
  each :users do
    policy :can_delete
    step :destroy
  end
```

Each iteration receives the singularized item name (`user:`) and
`index:` as keyword arguments. If any nested step fails, iteration stops
and the failing item/index remain in context for error reporting.
Existing matchers (`fail_a_policy`, `fail_a_step`, etc.) work inside
each blocks.

A `persist:` option allows values to accumulate across iterations and
survive the loop's variable isolation:

```ruby
  each :tag_names, persist: { results: -> { { created: [], failed: [] } } } do
    step :create_tag
  end
  # context[:results] available after the loop
```

The steps inspector displays iteration progress ((3/3) on success, (1/3)
when failing at the first item, (empty collection) with ⏭️ when
skipped).
2026-04-03 09:44:03 +02:00
..
context.rb DEV: Add each step to service framework for collection iteration (#38759) 2026-04-03 09:44:03 +02:00
contract_step.rb
each_step.rb DEV: Add each step to service framework for collection iteration (#38759) 2026-04-03 09:44:03 +02:00
lock_step.rb
model_step.rb
only_if_step.rb
options_step.rb
policy_step.rb
step.rb
steps_helpers.rb DEV: Add each step to service framework for collection iteration (#38759) 2026-04-03 09:44:03 +02:00
transaction_step.rb
try_step.rb