discourse/docs/developer-guides/docs
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
..
01-introduction
02-development-environments DEV: Use Pitchfork instead of Unicorn in docs (#39041) 2026-04-01 18:00:42 +02:00
03-code-internals DEV: Add each step to service framework for collection iteration (#38759) 2026-04-03 09:44:03 +02:00
04-plugins DOCS: Fix outdated links in developer guides (#38808) 2026-03-24 09:12:53 +01:00
05-themes-components DOCS: Fix outdated links in developer guides (#38808) 2026-03-24 09:12:53 +01:00
06-general-guides DOCS: persona -> agent (#38617) 2026-03-16 16:38:55 +08:00
07-theme-developer-tutorial DOCS: Fix outdated links in developer guides (#38808) 2026-03-24 09:12:53 +01:00
index.md