You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit b4833b5
Browse filesBrowse the repository at this point in the historyBrowse files
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>
Copy file name to clipboardExpand all lines: docs/resilience.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# Resilience reference
2
2
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:
4
4
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.)
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.
0 commit comments