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
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

resile

package module

Go to main page

Versions in this module

v1

v1.0.2

Mar 16, 2026

Changes in this version

+ type StateMachine struct

+ func NewStateMachine[S any, D any, E any](initialState S, initialData D, transition TransitionFunc[S, D, E], ...) *StateMachine[S, D, E]

+ func (sm *StateMachine[S, D, E]) GetData() D

+ func (sm *StateMachine[S, D, E]) GetState() S

+ func (sm *StateMachine[S, D, E]) Handle(ctx context.Context, event E) error

+ type TransitionFunc func(ctx context.Context, state S, data D, event E, rs RetryState) (S, D, error)

v1.0.1

Mar 15, 2026

Changes in this version

type Config

+ RecoverPanics bool

type Option

+ func WithPanicRecovery() Option

+ type PanicError struct

+ StackTrace string

+ Value any

+ func (p *PanicError) Error() string

v1.0.0

Mar 6, 2026

Changes in this version

+ func DoErr(ctx context.Context, action func(context.Context) error, opts ...Option) error

+ func DoErrHedged(ctx context.Context, action func(context.Context) error, opts ...Option) error

+ func DoErrState(ctx context.Context, action func(context.Context, RetryState) error, ...) error

+ func DoErrStateHedged(ctx context.Context, action func(context.Context, RetryState) error, ...) error

+ func DoHedged[T any](ctx context.Context, action func(context.Context) (T, error), opts ...Option) (T, error)

+ func DoStateHedged[T any](ctx context.Context, action func(context.Context, RetryState) (T, error), ...) (T, error)

+ func DoState[T any](ctx context.Context, action func(context.Context, RetryState) (T, error), ...) (T, error)

+ func Do[T any](ctx context.Context, action func(context.Context) (T, error), opts ...Option) (T, error)

+ func FatalError(err error) error

+ func WithTestingBypass(ctx context.Context) context.Context

+ type AdaptiveBucket struct

+ func DefaultAdaptiveBucket() *AdaptiveBucket

+ func NewAdaptiveBucket(maxCapacity, retryCost, successRefill float64) *AdaptiveBucket

+ func (b *AdaptiveBucket) AcquireRetryToken() bool

+ func (b *AdaptiveBucket) AddSuccessToken()

+ type Backoff interface

+ Next func(attempt uint) time.Duration

+ func NewFullJitter(base, cap time.Duration) Backoff

+ type Config struct

+ AdaptiveBucket *AdaptiveBucket

+ Backoff Backoff

+ BaseDelay time.Duration

+ CircuitBreaker *circuit.Breaker

+ Fallback any

+ HedgingDelay time.Duration

+ Instrumenter Instrumenter

+ MaxAttempts uint

+ MaxDelay time.Duration

+ Name string

+ Policy *retryPolicy

+ func DefaultConfig() *Config

+ func (c *Config) Do(ctx context.Context, action func(context.Context) (any, error)) (any, error)

+ func (c *Config) DoErr(ctx context.Context, action func(context.Context) error) error

+ func (c *Config) DoErrHedged(ctx context.Context, action func(context.Context) error) error

+ func (c *Config) DoHedged(ctx context.Context, action func(context.Context) (any, error)) (any, error)

+ type Instrumenter interface

+ AfterAttempt func(ctx context.Context, state RetryState)

+ BeforeAttempt func(ctx context.Context, state RetryState) context.Context

+ type Option func(*Config)

+ func WithAdaptiveBucket(bucket *AdaptiveBucket) Option

+ func WithBackoff(backoff Backoff) Option

+ func WithBaseDelay(delay time.Duration) Option

+ func WithCircuitBreaker(cb *circuit.Breaker) Option

+ func WithFallbackErr(f func(context.Context, error) error) Option

+ func WithFallback[T any](f func(context.Context, error) (T, error)) Option

+ func WithHedgingDelay(delay time.Duration) Option

+ func WithInstrumenter(instr Instrumenter) Option

+ func WithMaxAttempts(attempts uint) Option

+ func WithMaxDelay(delay time.Duration) Option

+ func WithName(name string) Option

+ func WithRetryIf(target error) Option

+ func WithRetryIfFunc(f func(error) bool) Option

+ type RetryAfterError interface

+ CancelAllRetries func() bool

+ RetryAfter func() time.Duration

+ type RetryState struct

+ Attempt uint

+ LastError error

+ MaxAttempts uint

+ Name string

+ NextDelay time.Duration

+ TotalDuration time.Duration

+ type Retryer interface

+ Do func(ctx context.Context, action func(context.Context) (any, error)) (any, error)

+ DoErr func(ctx context.Context, action func(context.Context) error) error

+ DoErrHedged func(ctx context.Context, action func(context.Context) error) error

+ DoHedged func(ctx context.Context, action func(context.Context) (any, error)) (any, error)

+ func New(opts ...Option) Retryer