mrerr

Documentation

Index

• Constants
• func SetCallerOptions(opts ...CallerOption)
• type AppError
  • func New(id, message string, args ...any) *AppError
  • func (e *AppError) Error() string
  • func (e *AppError) ID() string
  • func (e *AppError) Is(err error) bool
  • func (e *AppError) Kind() ErrorKind
  • func (e *AppError) TraceID() string
  • func (e *AppError) Translate(locale *mrlang.Locale) mrlang.ErrorMessage
  • func (e *AppError) Unwrap() error
• type AppErrorFactory
  • func NewFactory(id string, kind ErrorKind, message string) *AppErrorFactory
  • func (e *AppErrorFactory) Caller(skip int) *AppErrorFactory
  • func (e *AppErrorFactory) ErrorID() string
  • func (e *AppErrorFactory) Is(err error) bool
  • func (e *AppErrorFactory) New(args ...any) *AppError
  • func (e *AppErrorFactory) Wrap(err error, args ...any) *AppError
• type CallStackRow
• type Caller
  • func NewCaller(opts ...CallerOption) *Caller
  • func (c *Caller) CallStack(skip int) []CallStackRow
• type CallerOption
  • func CallerDeep(value int) CallerOption
  • func CallerRootPath(value string) CallerOption
  • func CallerUseShortPath(value bool) CallerOption
• type ErrorKind
  • func (k ErrorKind) String() string
• type FieldError
  • func NewFieldError(id string, err error) *FieldError
  • func NewFieldErrorAppError(id string, err *AppError) *FieldError
  • func NewFieldErrorMessage(id string, message string) *FieldError
  • func (e *FieldError) AppError() *AppError
  • func (e *FieldError) Error() string
  • func (e *FieldError) ID() string
• type FieldErrorList
  • func (l FieldErrorList) Error() string

Constants

const (
	ErrorInternalID = "errInternal"
	ErrorSystemID   = "errSystem"
)

Functions

func SetCallerOptions

func SetCallerOptions(opts ...CallerOption)

SetCallerOptions - WARNING: use only when starting the main process

Types

type AppError

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

func New

func New(id, message string, args ...any) *AppError

func (*AppError) Error

func (e *AppError) Error() string

func (*AppError) ID

func (e *AppError) ID() string

func (*AppError) Is

func (e *AppError) Is(err error) bool

func (*AppError) Kind

func (e *AppError) Kind() ErrorKind

func (*AppError) TraceID

func (e *AppError) TraceID() string

func (*AppError) Translate

func (e *AppError) Translate(locale *mrlang.Locale) mrlang.ErrorMessage

Translate - translate error message for user

func (*AppError) Unwrap

func (e *AppError) Unwrap() error

type AppErrorFactory

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

func NewFactory

func NewFactory(id string, kind ErrorKind, message string) *AppErrorFactory

func (*AppErrorFactory) Caller

func (e *AppErrorFactory) Caller(skip int) *AppErrorFactory

func (*AppErrorFactory) ErrorID

func (e *AppErrorFactory) ErrorID() string

func (*AppErrorFactory) Is

func (e *AppErrorFactory) Is(err error) bool

Is - see: AppError::Is

func (*AppErrorFactory) New

func (e *AppErrorFactory) New(args ...any) *AppError

func (*AppErrorFactory) Wrap

func (e *AppErrorFactory) Wrap(err error, args ...any) *AppError

type CallStackRow

type CallStackRow struct {
	File string
	Line int
}

type Caller

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

func NewCaller

func NewCaller(opts ...CallerOption) *Caller

func (*Caller) CallStack

func (c *Caller) CallStack(skip int) []CallStackRow

type CallerOption

type CallerOption func(c *Caller)

func CallerDeep

func CallerDeep(value int) CallerOption

func CallerRootPath

func CallerRootPath(value string) CallerOption

func CallerUseShortPath

func CallerUseShortPath(value bool) CallerOption

type ErrorKind

type ErrorKind int8

const (
	ErrorKindInternal       ErrorKind = iota // внутренняя ошибка + traceID + call stack
	ErrorKindInternalNotice                  // внутреннее предупреждение, которое, в некоторых случаях, может стать поводом для реальной ошибки
	ErrorKindSystem                          // системная ошибка + traceID + call stack
	ErrorKindUser                            // пользовательская ошибка
)

func (ErrorKind) String

func (k ErrorKind) String() string

type FieldError

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

func NewFieldError

func NewFieldError(id string, err error) *FieldError

func NewFieldErrorAppError

func NewFieldErrorAppError(id string, err *AppError) *FieldError

func NewFieldErrorMessage

func NewFieldErrorMessage(id string, message string) *FieldError

func (*FieldError) AppError

func (e *FieldError) AppError() *AppError

func (*FieldError) Error

func (e *FieldError) Error() string

func (*FieldError) ID

func (e *FieldError) ID() string

type FieldErrorList

type FieldErrorList []*FieldError

func (FieldErrorList) Error

func (l FieldErrorList) Error() string