Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

retrier

package module

Go to main page

Versions in this module

v1

v1.0.3

Mar 4, 2026

Changes in this version

+ type DelaySuggestioner interface

+ SuggestedDelay func() time.Duration

type RetryOption

+ func WithLogAttrs(attrs ...any) RetryOption

v1.0.2

Mar 2, 2026

v1.0.1

Feb 27, 2026

Changes in this version

type Result

+ func (r Result[T]) Decompose() (T, int, error)

+ func (r Result[T]) Unwrap() T

+ func (r Result[T]) UnwrapOr(defaultValue T) T

type RetryErrorCause

+ const ErrContextCancelled

+ type RetryOption func(*retryConfig)

+ func WithInitialDuration(d time.Duration) RetryOption

+ func WithJitter(d time.Duration) RetryOption

+ func WithMaxAttempts(n int) RetryOption

+ func WithMaxDuration(d time.Duration) RetryOption

+ func WithMultiplier(m float64) RetryOption

+ func WithRetryPolicy(p RetryPolicy) RetryOption

v1.0.0

Feb 27, 2026

retracted

Changes in this version

+ type BackoffParam struct

+ func NewBackoffParam(initialDuration time.Duration, multiplier float64, maxDuration time.Duration) BackoffParam

+ func (b *BackoffParam) InitialDuration() time.Duration

+ func (b *BackoffParam) MaxDuration() time.Duration

+ func (b *BackoffParam) Multiplier() float64

+ type DebugLogger interface

+ Enabled func() bool

+ LogRetry func(ctx context.Context, attempt int, maxAttempts int, backoff time.Duration, ...)

+ type NoOpLogger struct

+ func NewNoOpLogger() *NoOpLogger

+ func (n *NoOpLogger) Enabled() bool

+ func (n *NoOpLogger) LogRetry(_ context.Context, _ int, _ int, _ time.Duration, _ error)

+ type Result struct

+ func NewFailureResult[T any](err RetryableError, attempts int) Result[T]

+ func NewSuccessResult[T any](value T, attempts int) Result[T]

+ func Retry[T any](retryParam RetryParam, logger DebugLogger, fn func() (T, RetryableError)) Result[T]

+ func (r Result[T]) Attempts() int

+ func (r Result[T]) Err() RetryableError

+ func (r Result[T]) IsFailure() bool

+ func (r Result[T]) IsSuccess() bool

+ func (r Result[T]) Value() T

+ type RetryError struct

+ Cause RetryErrorCause

+ Message string

+ func NewRetryError(cause RetryErrorCause, message string, policy RetryPolicy, wrapped error) *RetryError

+ func (e *RetryError) Error() string

+ func (e *RetryError) Is(target error) bool

+ func (e *RetryError) RetryPolicy() RetryPolicy

+ func (e *RetryError) Unwrap() error

+ type RetryErrorCause string

+ const ErrExhaustedAttempts

+ const ErrZeroAttempt

+ type RetryParam struct

+ BackoffParam BackoffParam

+ BaseDelay time.Duration

+ Jitter time.Duration

+ MaxAttempts int

+ RandomSeed int64

+ func NewRetryParam(baseDelay time.Duration, jitter time.Duration, randomSeed int64, ...) RetryParam

+ type RetryPolicy int

+ const RetryPolicyAuto

+ const RetryPolicyManual

+ const RetryPolicyNever

+ type RetryableError interface

+ RetryPolicy func() RetryPolicy