Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/icanzilb/Retry
Haven't you wished for `try` to sometimes try a little harder? Meet `retry`
https://github.com/icanzilb/Retry
Last synced: 3 months ago
JSON representation
Haven't you wished for `try` to sometimes try a little harder? Meet `retry`
- Host: GitHub
- URL: https://github.com/icanzilb/Retry
- Owner: icanzilb
- License: mit
- Created: 2016-08-25T08:54:21.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2021-10-21T16:06:25.000Z (about 3 years ago)
- Last Synced: 2024-08-05T10:29:11.177Z (3 months ago)
- Language: Swift
- Size: 53.7 KB
- Stars: 498
- Watchers: 11
- Forks: 16
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - Retry - Haven't you wished for `try` to sometimes try a little harder? Meet `retry` . (Utility / Web View)
- awesome-ios-star - Retry - Haven't you wished for `try` to sometimes try a little harder? Meet `retry` . (Utility / Web View)
README
# Retry
[](http://cocoapods.org/pods/Retry)
[](http://cocoapods.org/pods/Retry)
[](http://cocoapods.org/pods/Retry)
## Example
Haven't you wished for `try` to sometimes try a little harder? Meet `retry`
To run the example project, clone the repo, and run `pod install` from the Example directory first.
The full test suite shows a variety of use cases.
### Synchronous retry
NB: The sync `retry` is not good for use on the main thread (because it will block it if you're having delays, etc). For the main thread it's better considering `retryAsync` (more info below).
Default parameters - retry three times without any delay:
```swift
retry {
... do some throwing work ...
}
```
Catching the last error, and adding a defer block after all tries have finished - will keep trying maximum `10` times. You can use either of the final blocks or both:
```swift
retry (max: 10) {
... do some throwing work ...
}
.finalCatch {lastError in
print("This simply won't happen. Failed with: \(lastError)")
}
.finalDefer {
print("Finished trying")
}
```
Add `2` second delay between the retries:
```swift
retry (max: 5, retryStrategy: .delay(seconds: 2.0)) {
... do some throwing work ...
}
```
Implement any custom delay logic (below is multiplying the waiting time after each try):
```swift
retry (max: 5, retryStrategy: .custom {count, lastDelay in return (lastDelay ?? 1.0) * 2.0} ) {
... do some throwing work ...
}
```
Limit the number of retries based on any custom logic - if you return `nil` from your custom strategy, `retry` will stop trying:
```swift
retry (max: 5, retryStrategy: .custom {count,_ in return count > 3 ? nil : 0} ) {
... do some throwing work ...
}
```
### Asynchronous retry
The syntax for `retryAsync` is exactly the same as for `retry`. The difference in behavior is if the first try fails `retryAsync` keeps trying asynchronously instead of blocking the current thread.
## Installation
Retry is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "Retry"
```
Retry is also available through Swift Package Manager. To install, add `https://github.com/icanzilb/Retry.git` to your package manifest.
Since Retry is a swift3 library, you got to add this piece of code to your project's Podfile, to update your targets' swift language version:
```
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['SWIFT_VERSION'] = '3.0'
config.build_settings['MACOSX_DEPLOYMENT_TARGET'] = '10.10'
end
end
end
```
## Author
Marin Todorov, 2016-present
Inspired by the retry operator in https://github.com/RxSwiftCommunity/RxSwiftExt
## License
Retry is available under the MIT license. See the LICENSE file for more info.