RelPrim 0.7.0

Summary

RelPrim 0.7.0 focuses on developer experience.

This release adds the high-level @resilient(...) decorator API and restructures the documentation around fast adoption while keeping the advanced builder API available for explicit composition.

Added

• resilient() decorator
• Simple retries= shortcut
• Numeric timeout= shortcut
• Single-callable fallback= shortcut
• Support for advanced retry=RetryPolicy(...)
• Support for advanced timeout=TimeoutPolicy(...)
• Support for advanced fallbacks=fallback_chain(...)
• Decorator usage example
• Getting started documentation
• Advanced usage documentation

Changed

• README now starts with the beginner-friendly decorator API
• README now separates beginner and advanced usage paths
• Examples and documentation were polished around practical external-call use cases

Notes

Decorated functions return OperationResult[T], not raw values. This keeps the business value and execution report explicit.

RelPrim 0.6.0

Summary

RelPrim 0.6.0 adds structured events.

This release introduces transport-agnostic structured events and integrates event emission with the high-level async operation API.

Added

• EventType
• StructuredEvent
• EventSink
• NoopEventSink
• InMemoryEventSink
• EventEmitter
• AsyncOperation.with_events()
• Operation lifecycle events
• Attempt lifecycle events
• Retry scheduled events
• Fallback lifecycle events
• Validation success/failure events
• Circuit breaker rejection events
• Structured events example

Changed

• README updated with structured events usage
• Python version badge changed to static Python 3.11+
• Package metadata now includes author, maintainer, keywords and project URLs

Notes

RelPrim is still in early development and APIs may change before the first stable release.

RelPrim 0.5.0

Summary

RelPrim 0.5.0 adds validation support.

This release introduces dependency-free validation primitives and integrates validation with the high-level async operation API.

Added

• ValidationResult
• Validator
• CallableValidator
• ValidationPolicy
• ValidationFailedError
• validator() factory
• validation_policy() factory
• AsyncOperation.with_validation()
• Validation metadata in execution reports
• Retry and fallback support for validation failures
• README and examples updated with validation usage

Notes

RelPrim is still in early development and APIs may change before the first stable release.

RelPrim 0.4.0

Summary

RelPrim 0.4.0 adds circuit breaker support.

This release introduces the async circuit breaker primitive and integrates circuit breaker execution with the high-level async operation API.

Added

• CircuitBreaker
• CircuitBreakerState
• CircuitBreakerSnapshot
• CircuitBreakerOpenError
• AsyncOperation.with_circuit_breaker()
• Circuit breaker metadata in execution reports
• README quickstart with circuit breaker, retry, timeout, fallback and execution reporting

Notes

RelPrim is still in early development and APIs may change before the first stable release.

RelPrim 0.3.0

Summary

RelPrim 0.3.0 adds fallback support.

This release introduces async fallback chains and integrates fallback execution with the high-level async operation API.

Added

• Async fallback chain primitive
• FallbackCandidate
• FallbackPolicy
• FallbackResult
• FallbackChain
• fallback_chain() factory
• FallbackChainError
• AsyncOperation.with_fallbacks()
• Fallback metadata in execution reports
• README quickstart with retry, timeout, fallback and execution reporting

Notes

RelPrim is still in early development and APIs may change before the first stable release.

RelPrim 0.2.0

Summary

First functional preview release of RelPrim.

This release introduces the initial reliability primitives and the first higher-level async operation API.

Added

• Retry policies
• Exponential backoff with jitter
• Async timeout policy
• Execution report model
• Operation result model
• Async resilient operation API
• Typed execution errors
• Basic README quickstart

Notes

RelPrim is still in early development and APIs may change before the first stable release.