errors

May 29, 2025

Changes in this version

type SeverityLevel

+ const Unknown

May 19, 2025

Changes in this version

+ const ClientDebugOutputFormat

+ const ClientOutputFormat

+ const ServerDebugOutputFormat

+ const ServerOutputFormat

+ var ErrMarshalError = Template("error marshaling failed").Severity(Critical).StatusCode(500)

+ func SetAlarmer(a Alarmer)

+ type Error struct

+ func (e *Error) Alarm()

+ func (e *Error) Code(code string) *Error

+ func (e *Error) Error() string

+ func (e *Error) Msg(s string) *Error

+ func (e *Error) Protected(protected bool) *Error

+ func (e *Error) Set(key string, value any) *Error

+ func (e *Error) Severity(severity SeverityLevel) *Error

+ func (e *Error) StatusCode(statusCode int) *Error

+ func (e *Error) Wrap(err error) *Error

+ func (err *Error) WrappedErrors() []Error

+ type ErrorFormattingOptions struct

+ type ErrorSerializationRule uint8

+ const IndentJSON

+ type ErrorTemplate struct

+ func Template(msg string) *ErrorTemplate

+ func (et *ErrorTemplate) Code(code string) *ErrorTemplate

+ func (et *ErrorTemplate) Error() string

+ func (et *ErrorTemplate) New() *Error

+ func (et *ErrorTemplate) Protected(protected bool) *ErrorTemplate

+ func (et *ErrorTemplate) Set(key string, value any) *ErrorTemplate

+ func (et *ErrorTemplate) Severity(severity SeverityLevel) *ErrorTemplate

+ func (et *ErrorTemplate) StatusCode(statusCode int) *ErrorTemplate

+ func (et *ErrorTemplate) Wrap(err error) *Error

+ type Option func(*ErrorFormattingOptions)

+ func WithAttributes(rule ErrorSerializationRule) Option

+ func WithRootLevelFields(fields []string) Option

+ func WithStopStackOn(stopOnFuncContains string) Option

+ type SerializedError struct

+ Code string

+ Fields map[string]any

+ Message string

+ Severity string

+ Stack []StackFrame

+ StatusCode int

+ Wrapped []Error

+ func Serialize(err error, opts ...Option) *SerializedError

type SeverityLevel

+ func (sl *SeverityLevel) UnmarshalJSON(data []byte) error

+ type StackFrame struct

+ File string

+ Function string

+ Line int

+ func (s StackFrame) String() string

Jan 19, 2022

Changes in this version

type CatchedError

+ func (ce *CatchedError) Raise() *CatchedError

Nov 20, 2021

Changes in this version

+ var RootLevelFields = []string

Oct 31, 2021

Changes in this version

type FormattingFlag

+ const AddWrappedErrors

Oct 19, 2021

Changes in this version

type CatchedError

+ func Wrap(err error, ce *CatchedError) *CatchedError

Jun 8, 2021

Changes in this version

+ var CallerFramesFunc func(offset int) []Frame = DefaultCallerFrames

+ func As(err error, target interface{}) bool

+ func Is(err, target error) bool

+ func IsNotFound(err error) bool

+ func ToClientJSON(err error) []byte

+ func ToJSON(err error, flags FormattingFlag) []byte

+ func ToServerJSON(err error) []byte

+ func Unwrap(err error) error

+ type Alarmer interface

+ Alarm func(*CatchedError)

type CatchedError

+ func NewTiny(msg string) *CatchedError

+ func Raise(ce *CatchedError) *CatchedError

+ func (ce *CatchedError) Alarm(a Alarmer)

+ func (ce *CatchedError) AllMessages(exceptProtected bool) []string

+ func (ce *CatchedError) Capture() *CatchedError

+ func (ce *CatchedError) GetCode() string

+ func (ce *CatchedError) GetSeverity() SeverityLevel

+ func (ce *CatchedError) WrappedErrors() []WrappedError

+ func (ce *CatchedError) WrappedMessages(exceptProtected bool) []string

+ type FormattingFlag uint8

+ const AddFields

+ const AddProtected

+ const AddStack

type Frame

+ func DefaultCallerFrames(offset int) []Frame

Mar 10, 2021

Changes in this version

+ var CallingStackMaxLen int = 15

+ var CaptureStackStopWord string

+ var ConsistencyFailed = func() *CatchedError

+ var DefaultCallerFramesFunc func(offset int) []Frame = CallerFrames

+ var ErrorMethodMode = Single

+ var Forbidden = func() *CatchedError

+ var InternalError = func() *CatchedError

+ var InvalidRequestBody = func(s string) *CatchedError

+ var LastNonPairedValue interface{} = "missed value"

+ var NotFound = func(msg string) *CatchedError

+ var Unauthorized = func() *CatchedError

+ var UnprocessableEntity = func(s string) *CatchedError

+ var ValidationFailed = func(msg string) *CatchedError

+ func JSON(err error) []byte

+ type CatchedError struct

+ Fields map[string]interface{}

+ Frames []Frame

+ func Catch(err error) *CatchedError

+ func CatchCustom(err error, stackcapture func() []Frame) *CatchedError

+ func New(msg string) *CatchedError

+ func NewCritical(msg string) *CatchedError

+ func NewMedium(msg string) *CatchedError

+ func (ce *CatchedError) Code(code string) *CatchedError

+ func (ce *CatchedError) Critical() *CatchedError

+ func (ce *CatchedError) Get(key string) (interface{}, bool)

+ func (ce *CatchedError) GetDefault(key string, def interface{}) interface{}

+ func (ce *CatchedError) IsNotFound() bool

+ func (ce *CatchedError) Last() *WrappedError

+ func (ce *CatchedError) Len() int

+ func (ce *CatchedError) Medium() *CatchedError

+ func (ce *CatchedError) Msg(s string) *CatchedError

+ func (ce *CatchedError) Protect() *CatchedError

+ func (ce *CatchedError) Set(key string, val interface{}) *CatchedError

+ func (ce *CatchedError) SetPairs(kvpairs ...interface{}) *CatchedError

+ func (ce *CatchedError) SetStrs(key string, strs ...string) *CatchedError

+ func (ce *CatchedError) SetVals(key string, vals ...interface{}) *CatchedError

+ func (ce *CatchedError) Severity(level SeverityLevel) *CatchedError

+ func (ce *CatchedError) StatusCode(code int) *CatchedError

+ func (ce *CatchedError) Strs(exceptProtected bool) []string

+ func (ce CatchedError) Error() string

+ type Eventer interface

+ Fields func(map[string]interface{}) Eventer

+ Int func(string, int) Eventer

+ Str func(key, val string) Eventer

+ Strs func(key string, vals []string) Eventer

+ type Frame struct

+ File string

+ Function string

+ Line int

+ func CallerFrames(offset int) []Frame

+ type Mode int

+ const Multi

+ const Single

+ type SeverityLevel int

+ const Critical

+ const Medium

+ const Tiny

+ func (sl SeverityLevel) MarshalJSON() ([]byte, error)

+ func (sl SeverityLevel) String() string

+ type WrappedError struct

+ Code string

+ Message string

+ Protected bool

+ Severity SeverityLevel

+ StatusCode int

+ func (we WrappedError) Err() error

+ func (we WrappedError) Error() string