Skip to content

Commit b4833b5

Browse files
lesnik512claude
andcommitted
docs(resilience): post-0.8.0 sweep — intro counts five primitives, not three
Closes audit Low finding (docs/resilience.md:3 "three resilience primitives" stale post-0.8.0) from planning/audit/2026-06-07-deep-audit.md. Pairs the bullets sync/async to match the layout the rest of the file already uses. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 1bc9cfa commit b4833b5

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

‎docs/resilience.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Resilience reference
22

3-
`httpware` ships three resilience primitives under `httpware.middleware.resilience`, all composable through the standard [AsyncMiddleware](middleware.md) chain:
3+
`httpware` ships these resilience primitives under `httpware.middleware.resilience`, all composable through the standard [Middleware](middleware.md) / [AsyncMiddleware](middleware.md) chain:
44

5-
- **`AsyncRetry`** — automatic retry of transient failures with full-jitter exponential backoff
6-
- **`RetryBudget`** — Finagle-style token bucket that bounds the global retry rate to prevent retry storms when downstreams degrade
7-
- **`AsyncBulkhead`** — concurrency limiter via `asyncio.Semaphore` with bounded acquire-wait
5+
- **`Retry` / `AsyncRetry`** — automatic retry of transient failures with full-jitter exponential backoff
6+
- **`RetryBudget`** — Finagle-style token bucket; safe to share across sync `Client` and `AsyncClient` in the same process. (Finagle-style bounds the global retry rate to prevent retry storms when downstreams degrade.)
7+
- **`Bulkhead` / `AsyncBulkhead`** — concurrency limiter with bounded acquire-wait (`threading.Semaphore` and `asyncio.Semaphore` respectively)
88

99
The canonical composition is `middleware=[AsyncBulkhead(...), AsyncRetry()]` — `AsyncBulkhead` outside `AsyncRetry` so one slot covers all retry attempts of a single call. Reach for the [Middleware guide](middleware.md) when you want to write your own resilience policy.
1010

0 commit comments

Comments
 (0)