Swift package · 0.1.0 · Apache-2.0
Stoic is a Swift library for async code that has to keep working when the network, the disk, or another service does not.
swift package add-dependency https://github.com/Vaccone-Software/stoic --from 0.1.0Each part is a small set of plain Swift functions and types, with a written contract for what happens when things fail. Use one, or all of them.
Bound how long any async work may take. Work past its deadline is cancelled with a reason, and calls that ignore cancellation are abandoned and counted.
try await withTimeout(.seconds(2)) { … }Pl. II · Time among the statues
Exponential backoff with jitter and a shared budget. Errors declare whether a retry can help, and retrying stops when it cannot.
try await retry(.exponential(base: .milliseconds(200)).attempts(4)) { … }Pl. III · Sisyphus and the stone
Long-running work restarts with backoff when it fails or stops sending heartbeats, and escalates when restarting stops helping.
try await Supervisor(label: "app") { Child("sync") { … } }.run()Pl. IV · The Hydra of Lerna
Run a test across hundreds of seeded interleavings with virtual time. A failure reports the seed that reproduces it exactly.
try await simulate(seeds: 0..<500) { … }Pl. V · The sleep of reason, after Goya