pico-resilience
Spring-style resilience annotations for the Pico ecosystem, built on pico-ioc method interception and auto-discovered by pico-boot. Zero-config.
| Decorator | Policy |
|---|---|
@retryable(max_attempts, backoff_seconds, retry_on) |
Exponential-backoff retry (sync + async) |
@circuit_breaker(failure_threshold, reset_timeout_seconds) |
Per-method circuit: closed → open → half-open |
@timeout(seconds) |
Async time budget via asyncio.timeout |
Install
pip install pico-resilience
Use
from pico_ioc import component
from pico_resilience import retryable, circuit_breaker, timeout
@component
class PaymentGateway:
@retryable(max_attempts=3, backoff_seconds=0.2, retry_on=(ConnectionError,))
@circuit_breaker(failure_threshold=5, reset_timeout_seconds=30)
def charge(self, order): ...
@timeout(2.0)
async def query_partner(self, q): ...
Failures raise RetryExhaustedError / CircuitOpenError / TimeoutError with the method name. resilience.enabled: false in application.yaml bypasses every policy (handy in tests).
Chain rule: put @retryable at the top when combining decorators (it runs innermost); @circuit_breaker/@cacheable below it then wrap the whole retry loop — the circuit counts exhausted retries and the cache stores the final result. @timeout rejects sync methods at import time: a thread cannot be cancelled, and a timeout that lies is worse than none.
Documentation
Full docs at dperezcabrera.github.io/pico-resilience.
AI Coding Skills
Install Claude Code or OpenAI Codex skills for AI-assisted development with pico-resilience:
curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash
The pico-conventions skill teaches the assistant this module's API surface and invariants; /add-component and /add-tests scaffold components and tests that use it.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pico_resilience-0.2.1.tar.gz.
File metadata
- Download URL: pico_resilience-0.2.1.tar.gz
- Upload date:
- Size: 27.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
16f5cd6a31fb757f43e0337c79b71f3cc56767d3189a5ffed277c89d9e8e27dd
|
|
| MD5 |
b057967ce39bcfd86ce33d103d26931f
|
|
| BLAKE2b-256 |
d2a4eb18b99b532e33287cbad8d7ef6de7bafb5f29b7298a4fd8375b49c24d0b
|
Provenance
The following attestation bundles were made for pico_resilience-0.2.1.tar.gz:
Publisher:
publish-to-pypi.yml on dperezcabrera/pico-resilience
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pico_resilience-0.2.1.tar.gz -
Subject digest:
16f5cd6a31fb757f43e0337c79b71f3cc56767d3189a5ffed277c89d9e8e27dd - Sigstore transparency entry: 2138357268
- Sigstore integration time:
-
Permalink:
dperezcabrera/pico-resilience@e0c9112fb08fd6cca6c8b54f03b64fb5e7a2e44b -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/dperezcabrera
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@e0c9112fb08fd6cca6c8b54f03b64fb5e7a2e44b -
Trigger Event:
release
-
Statement type:
File details
Details for the file pico_resilience-0.2.1-py3-none-any.whl.
File metadata
- Download URL: pico_resilience-0.2.1-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
530b147fce64b97721c2cc4071526fa53fc452ed80c7d15ea6ae864838568ec0
|
|
| MD5 |
93d7905aab7db34813bae352120ea314
|
|
| BLAKE2b-256 |
0ec3a64bfeba390702b520baf5ffc5cb385dad7255bd2c399b39bba8d6e28e20
|
Provenance
The following attestation bundles were made for pico_resilience-0.2.1-py3-none-any.whl:
Publisher:
publish-to-pypi.yml on dperezcabrera/pico-resilience
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pico_resilience-0.2.1-py3-none-any.whl -
Subject digest:
530b147fce64b97721c2cc4071526fa53fc452ed80c7d15ea6ae864838568ec0 - Sigstore transparency entry: 2138357297
- Sigstore integration time:
-
Permalink:
dperezcabrera/pico-resilience@e0c9112fb08fd6cca6c8b54f03b64fb5e7a2e44b -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/dperezcabrera
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@e0c9112fb08fd6cca6c8b54f03b64fb5e7a2e44b -
Trigger Event:
release
-
Statement type:
