errors

Documentation

Index

• Variables
• func As(err error, target any) bool
• func Is(err, target error) bool
• type Error
  • func AsLakeErrorType(err error) Error
  • func Convert(err error) Error
  • func Convert00001[T1 any, T2 any, T3 any, T4 any](t1 T1, t2 T2, t3 T3, t4 T4, err error) (T1, T2, T3, T4, Error)
  • func Convert0001[T1 any, T2 any, T3 any](t1 T1, t2 T2, t3 T3, err error) (T1, T2, T3, Error)
  • func Convert001[T1 any, T2 any](t1 T1, t2 T2, err error) (T1, T2, Error)
  • func Convert01[T1 any](t1 T1, err error) (T1, Error)
• type MessageType
• type Messages
  • func (m Messages) Causes() []string
  • func (m Messages) Format() string
  • func (m Messages) Get() string
• type Option
  • func WithData(data interface{}) Option
• type Type
  • func HttpStatus(code int) *Type
  • func (t *Type) Combine(errs []error) Error
  • func (t *Type) GetHttpCode() int
  • func (t *Type) New(message string, opts ...Option) Error
  • func (t *Type) Wrap(err error, message string, opts ...Option) Error
  • func (t *Type) WrapRaw(err error) Error

Variables

var (
	// Default special error type. If it's wrapping another error, then it will take the type of that error if it's an Error. Otherwise, it equates to Internal.
	Default = register(nil)

	SubtaskErr   = register(&Type{meta: "subtask"})
	NotFound     = register(&Type{httpCode: http.StatusNotFound, meta: "not-found"})
	BadInput     = register(&Type{httpCode: http.StatusBadRequest, meta: "bad-input"})
	Unauthorized = register(&Type{httpCode: http.StatusUnauthorized, meta: "unauthorized"})
	Forbidden    = register(&Type{httpCode: http.StatusForbidden, meta: "forbidden"})
	Internal     = register(&Type{httpCode: http.StatusInternalServerError, meta: "internal"})
	Timeout      = register(&Type{httpCode: http.StatusGatewayTimeout, meta: "timeout"})
)

Supported error types

Functions

func As

func As(err error, target any) bool

As convenience passthrough for the native errors.As method

func Is

func Is(err, target error) bool

Is convenience passthrough for the native errors.Is method

Types

type Error

type Error interface {

	// Messages the message associated with this Error.
	Messages() Messages
	// GetType gets the Type of this error
	GetType() *Type
	// As Attempts to cast this Error to the requested Type, and returns nil if it can't.
	As(*Type) Error
	// GetData returns the data associated with this Error (may be nil)
	GetData() interface{}
	// contains filtered or unexported methods
}

Error The interface that all internally managed errors should adhere to.

func AsLakeErrorType

func AsLakeErrorType(err error) Error

AsLakeErrorType attempts to cast err to Error, otherwise returns nil

func Convert

func Convert(err error) Error

Convert converts a raw error to an Error. Similar to Type.WrapRaw with a type of Default, but will not wrap the error if it's already of type Error. Passing in nil will return nil.

func Convert00001

func Convert00001[T1 any, T2 any, T3 any, T4 any](t1 T1, t2 T2, t3 T3, t4 T4, err error) (T1, T2, T3, T4, Error)

Convert00001 like Convert01, but with four extra args

func Convert0001

func Convert0001[T1 any, T2 any, T3 any](t1 T1, t2 T2, t3 T3, err error) (T1, T2, T3, Error)

Convert0001 like Convert01, but with three extra args

func Convert001

func Convert001[T1 any, T2 any](t1 T1, t2 T2, err error) (T1, T2, Error)

Convert001 like Convert01, but with two extra args

func Convert01

func Convert01[T1 any](t1 T1, err error) (T1, Error)

Convert01 an extension of Convert that allows passing in one extra arg. Useful for inlining the conversion of multivalued returns.

type MessageType

type MessageType int

MessageType the type of message for an Error

type Messages

type Messages []*errMessage

Messages alias for messages of an Error

func (Messages) Causes

func (m Messages) Causes() []string

Causes gets the non-main messages of the Messages in causal sequence

func (Messages) Format

func (m Messages) Format() string

Format formats the messages into a single string

func (Messages) Get

func (m Messages) Get() string

Get gets the main (top-level) (or first non-empty message if exists) message of the Messages

type Option

type Option func(*options)

Option add customized properties to the Error

func WithData

func WithData(data interface{}) Option

WithData associate data with this Error

type Type

type Type struct {
	// contains filtered or unexported fields
}

Type error are constructed from these, and they contain metadata about them.

func HttpStatus

func HttpStatus(code int) *Type

func (*Type) Combine

func (t *Type) Combine(errs []error) Error

Combine constructs a new Error from combining multiple errors. Stacktrace info for each of the errors will not be present in the result, so it's best to log the errors before combining them.

func (*Type) GetHttpCode

func (t *Type) GetHttpCode() int

GetHttpCode gets the associated Http code with this Type, if explicitly set, otherwise http.StatusInternalServerError

func (*Type) New

func (t *Type) New(message string, opts ...Option) Error

New constructs a new Error instance with this message

func (*Type) Wrap

func (t *Type) Wrap(err error, message string, opts ...Option) Error

Wrap constructs a new Error instance with this message and wraps the passed in error. A nil 'err' will return a nil Error.

func (*Type) WrapRaw

func (t *Type) WrapRaw(err error) Error

WrapRaw constructs a new Error instance that directly wraps this error with no additional context. A nil 'err' will return a nil Error. This additional wrapping will create an additional nested stacktrace on this line if the setting is enabled.