Retries in Swift with sensible defaults and powerful flexibility.
try await retry {
try await doSomething()
}See the documentation for examples of more advanced use cases.
The retry function is an async function that runs the given async closure repeatedly until it succeeds or until the failure is no longer retryable. The function sleeps in between attempts while respecting task cancellation.
The library uses similar defaults as Amazon Web Services and Google Cloud.
An important but often overlooked default is the choice of backoff algorithm, which determines how long to sleep in between attempts. This library chooses an exponential backoff algorithm by default, which is suitable for most use cases. Most retry use cases involve a resource, such as a server, with potentially many clients where an exponential backoff algorithm would be ideal to avoid DDoSing the resource.
The API provides several customization points to accommodate any use case:
- Retries can be selectively enabled or disabled for specific error cases by providing a custom
recoverFromFailureclosure. Retries can also be selectively enabled or disabled for specific code paths by wrapping thrown errors withRetryableorNotRetryable. - The
RetryConfigurationtype encapsulates the retry behavior so that it can be reused across multiple call sites without duplicating code. - The
Backofftype represents the choice of algorithm that will be used to determine how long to sleep in between attempts. It has built-in support for common algorithms but can be initialized with a customBackoffAlgorithmimplementation if needed. - The clock that is used to sleep in between attempts can be replaced. For example, one might use a fake
Clockimplementation in automated tests to ensure the tests are deterministic and efficient.
The module exposes a RetryableRequest protocol to add safe retry methods to a conforming request type. The retry methods in the protocol are similar to the top-level retry functions, but safer. The retry methods in the protocol enforce that the request is idempotent since it is unsafe to retry a non-idempotent request.
To retry HTTP requests, consider using the swift-http-error-handling package, which adds RetryableRequest conformance to the standard HTTPRequest type.