A simple, production-ready retry library for Go with exponential backoff, jitter, and context support.
- Simple API for retrying operations
- Context-aware cancellation & timeout support
- Exponential backoff with jitter
- Safe, production-tested design
- No global state
- Lightweight and dependency-free
go get github.com/thedevsaddam/retry/v2err := retry.DoFunc(ctx, 3, retry.NewBackoff(100*time.Millisecond), func() error {
return doSomething()
})
if err != nil {
log.Fatal(err)
}res, err := retry.Do(ctx, 3, retry.NewBackoff(100*time.Millisecond), myFunc, arg1, arg2)
if err != nil {
log.Fatal(err)
}
fmt.Println(res)b := retry.NewBackoff(100 * time.Millisecond)
b.Max = 5 * time.Second
b.Jitter = 0.3
b.Factor = 2- Retries stop immediately on success
- Retries stop on context cancellation
- Exponential backoff increases delay per attempt
- Jitter prevents thundering herd problems
- Max backoff prevents unbounded wait time
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
err := retry.DoFunc(ctx, 5, retry.NewBackoff(200*time.Millisecond), func() error {
// API call / DB call / network request
return errors.New("temporary failure")
})- Simple API surface
- Safe for production systems
- Predictable retry behavior
- Easy to embed in microservices
MIT