eerror

Documentation

Overview

Package eerror stands for Encore Error and is used to provide a little more information about the underlying error's metadata.

It also provides helper methods for working with zerolog's context

Index

• func LogWithMeta(evt *zerolog.Event, err error) *zerolog.Event
• func MetaFrom(err error) map[string]any
• func New(module string, msg string, meta map[string]any) error
• func WithMeta(err error, meta map[string]any) error
• func Wrap(cause error, module string, msg string, meta map[string]any) error
• type Error
  • func (e *Error) Cause() error
  • func (e *Error) Error() string
  • func (e *Error) StackTrace() errors.StackTrace
  • func (e *Error) Unwrap() error
• type StackFrame

Functions

func LogWithMeta

func LogWithMeta(evt *zerolog.Event, err error) *zerolog.Event

LogWithMeta merges in the metadata from the errors into the log context

func MetaFrom

func MetaFrom(err error) map[string]any

MetaFrom will return the merged metadata from any eerror.Error objects in the errors given. It will unwrap errors as it descends

func New

func New(module string, msg string, meta map[string]any) error

New creates a new error with the given error

func WithMeta

func WithMeta(err error, meta map[string]any) error

func Wrap

func Wrap(cause error, module string, msg string, meta map[string]any) error

Wrap wraps the cause error with the given message and meta. If cause is nil, wrap returns nil

Types

type Error

type Error struct {
	Module  string         `json:"module"`  // The module the error was raised in (normally the package name, but could be a larger "module" name)
	Message string         `json:"message"` // The message of the error, it should be human-readable and should be low entropy (i.e. so multiple errors of the same can be grouped)
	Meta    map[string]any `json:"meta"`    // Metadata about the error, this can be high entropy as it isn't used to group errors
	Stack   []*StackFrame  `json:"stack"`   // The stack trace of the error
	// contains filtered or unexported fields
}

func (*Error) Cause

func (e *Error) Cause() error

Cause implements Causer for some libraries and returns the underlying cause

func (*Error) Error

func (e *Error) Error() string

Error returns a simple string of the error

func (*Error) StackTrace

func (e *Error) StackTrace() errors.StackTrace

StackTrace implements the StackTraceProvider interface for some libraries including ZeroLog, xerrors and Sentry

func (*Error) Unwrap

func (e *Error) Unwrap() error

Unwrap implements the Go 2 unwrap interface used by xerrors and errors

type StackFrame

type StackFrame struct {
	// PC is the program counter for the frame (needed for things like sentry reporting)
	PC uintptr `json:"pc"`

	// Human-readable fields
	Function string `json:"function"`
	File     string `json:"file"`
	Line     int    `json:"line"`
}