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

errors

package

Go to main page

Versions in this module

v1

v1.1.0

Sep 14, 2025

v1.0.0

Sep 6, 2025

v0

v0.9.0

Sep 6, 2025

Changes in this version

+ func RetryOperation(ctx context.Context, operation func() error, maxRetries int, ...) error

+ func RetryWithExponentialBackoff(ctx context.Context, operation func() error, config BackoffConfig) error

+ type BackoffConfig struct

+ BaseDelay time.Duration

+ MaxDelay time.Duration

+ MaxRetries int

+ func DefaultBackoffConfig() BackoffConfig

+ type DriftError struct

+ Code string

+ Details map[string]interface{}

+ Message string

+ Operation string

+ Provider string

+ Recovery RecoveryStrategy

+ Resource string

+ RetryAfter time.Duration

+ Retryable bool

+ Severity ErrorSeverity

+ StackTrace string

+ Timestamp time.Time

+ TraceID string

+ Type ErrorType

+ UserHelp string

+ Wrapped error

+ func NewNotFoundError(resource string) *DriftError

+ func NewTimeoutError(operation string, duration time.Duration) *DriftError

+ func NewTransientError(message string, retryAfter time.Duration) *DriftError

+ func NewValidationError(resource string, message string) *DriftError

+ func (e *DriftError) Error() string

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

+ func (e *DriftError) ToJSON() string

+ func (e *DriftError) Unwrap() error

+ func (e *DriftError) WithDetails(key string, value interface{}) *DriftError

+ func (e *DriftError) WithRecovery(strategy RecoveryStrategy) *DriftError

+ func (e *DriftError) WithUserHelp(help string) *DriftError

+ type ErrorBuilder struct

+ func NewError(errType ErrorType, message string) *ErrorBuilder

+ func (b *ErrorBuilder) Build() *DriftError

+ func (b *ErrorBuilder) Error() error

+ func (b *ErrorBuilder) WithCode(code string) *ErrorBuilder

+ func (b *ErrorBuilder) WithContext(ctx context.Context) *ErrorBuilder

+ func (b *ErrorBuilder) WithDetails(key string, value interface{}) *ErrorBuilder

+ func (b *ErrorBuilder) WithOperation(operation string) *ErrorBuilder

+ func (b *ErrorBuilder) WithProvider(provider string) *ErrorBuilder

+ func (b *ErrorBuilder) WithRecovery(strategy RecoveryStrategy) *ErrorBuilder

+ func (b *ErrorBuilder) WithResource(resource string) *ErrorBuilder

+ func (b *ErrorBuilder) WithRetry(retryable bool, retryAfter time.Duration) *ErrorBuilder

+ func (b *ErrorBuilder) WithSeverity(severity ErrorSeverity) *ErrorBuilder

+ func (b *ErrorBuilder) WithUserHelp(help string) *ErrorBuilder

+ func (b *ErrorBuilder) WithWrapped(err error) *ErrorBuilder

+ type ErrorContext struct

+ func WithErrorContext(ctx context.Context) *ErrorContext

+ func (ec *ErrorContext) AddError(err error)

+ func (ec *ErrorContext) GetErrors() []error

+ func (ec *ErrorContext) GetFirstError() error

+ func (ec *ErrorContext) HasErrors() bool

+ type ErrorHandler struct

+ func NewErrorHandler() *ErrorHandler

+ func (h *ErrorHandler) Handle(err error) error

+ func (h *ErrorHandler) RegisterHandler(errType ErrorType, handler func(*DriftError) error)

+ func (h *ErrorHandler) SetFallback(handler func(*DriftError) error)

+ type ErrorSeverity string

+ const SeverityCritical

+ const SeverityHigh

+ const SeverityLow

+ const SeverityMedium

+ type ErrorType string

+ const ErrorTypeConflict

+ const ErrorTypeNotFound

+ const ErrorTypePermanent

+ const ErrorTypeSystem

+ const ErrorTypeTimeout

+ const ErrorTypeTransient

+ const ErrorTypeUser

+ const ErrorTypeValidation

+ type RecoveryExecutor struct

+ func NewRecoveryExecutor() *RecoveryExecutor

+ func (r *RecoveryExecutor) Execute(ctx context.Context, err *DriftError) error

+ func (r *RecoveryExecutor) RegisterStrategy(name string, fn RecoveryFunc)

+ type RecoveryFunc func(ctx context.Context, err *DriftError) error

+ type RecoveryMetrics struct

+ Attempts int64

+ Failures int64

+ LastAttempt time.Time

+ Successes int64

+ type RecoveryStrategy struct

+ Description string

+ Params map[string]interface{}

+ Steps []string

+ Strategy string