Typhoon

1.1.1

Typhoon is a service for retry policies
space-code/typhoon

What's New

1.1.1

2024-05-11T16:03:57Z

Released on 2024-05-11

Added

  • Add the upload_test_coverage_report action
    • Added in Pull Request #11
  • Add files to comply with community standards
    • Added in Pull Request #9.

Updated

  • Update GitHub Actions
    • Updated in Pull Request #10

Typhoon: a service for retry policies

typhoon

License Swift Compatibility Platform Compatibility CI

Description

Typhoon is a service for retry policies.

Usage

Typhoon provides three retry policy strategies:

/// A retry strategy with a constant number of attempts and fixed duration between retries.
case constant(retry: Int, duration: DispatchTimeInterval)

/// A retry strategy with an exponential increase in duration between retries.
case exponential(retry: Int, multiplier: Double = 2.0, duration: DispatchTimeInterval)

/// A retry strategy with exponential increase in duration between retries and added jitter.
case exponentialWithJitter(retry: Int, jitterFactor: Double = 0.1, maxInterval: UInt64? = 60, multiplier: Double = 2.0, duration: DispatchTimeInterval)

Create a RetryPolicyService instance and pass a desired strategy like this:

import Typhoon

let retryPolicyService = RetryPolicyService(strategy: .constant(retry: 10, duration: .seconds(1)))

do {
    _ = try await retryPolicyService.retry { 
        // Some logic here ...
     }
} catch {
    // Catch an error here ...
}

Requirements

  • iOS 13.0+ / macOS 10.15+ / tvOS 13.0+ / watchOS 6.0+ / visionOS 1.0+
  • Xcode 14.0
  • Swift 5.7

Installation

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler. It is in early development, but typhoon does support its use on supported platforms.

Once you have your Swift package set up, adding typhoon as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/space-code/typhoon.git", .upToNextMajor(from: "1.0.0"))
]

Communication

  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.

Contributing

Bootstrapping development environment

make bootstrap

Please feel free to help out with this project! If you see something that could be made better or want a new feature, open up an issue or send a Pull Request!

Author

Nikita Vasilev, nv3212@gmail.com

License

typhoon is available under the MIT license. See the LICENSE file for more info.

Description

  • Swift Tools 5.9.0
View More Packages from this Author

Dependencies

  • None
Last updated: Sun May 19 2024 00:46:37 GMT-0900 (Hawaii-Aleutian Daylight Time)