resilient-result 0.3.0

Resilient decorators that return Result types instead of throwing exceptions

resilient-result

Policy-based resilience with beautiful Result types.

from resilient_result import resilient, Retry, Backoff

@resilient(retry=Retry.api(), backoff=Backoff.exp())
async def call_api(url: str) -> str:
    return await http.get(url)

result = await call_api("https://api.example.com")
if result.success:
    print(result.data)  # Clean success
else:
    print(f"Failed: {result.error}")  # No exceptions thrown

Why resilient-result? Policy objects over primitives, Result types over exceptions, zero ceremony.

📖 Full API Reference

Installation

pip install resilient-result

Core Features

Policy-Based Configuration

from resilient_result import resilient, Retry, Circuit, Backoff

# Beautiful presets
@resilient(retry=Retry.api())                    # API defaults  
@resilient(retry=Retry.db(), backoff=Backoff.linear())  # Database operations

# Custom configuration
@resilient(retry=Retry(attempts=5, timeout=10), circuit=Circuit.fast())
async def critical_operation():
    return await external_service()

Result Types Over Exceptions

from resilient_result import Result, Ok, Err

# Clean error handling - no try/catch needed
result = await call_api("https://api.example.com")
if result.success:
    process(result.data)
else:
    log_error(result.error)

Built-in Patterns

@resilient.network()         # Smart retry for network errors
@resilient.parsing()         # JSON parsing with recovery  
@resilient.circuit()         # Circuit breaker protection
@resilient.rate_limit()      # Token bucket rate limiting

License

MIT - Build amazing resilient systems! 🚀