errors

Documentation

Index

• Variables
• func Errorf(format string, args ...interface{}) error
• func Is(err, target error) bool
• func New(msg string) error
• type Error
  • func E(err error) Error
  • func (err Error) Error() string
  • func (err Error) Is(other error) bool
  • func (err Error) WithCausef(format string, args ...interface{}) Error
  • func (err Error) WithMsgf(format string, args ...interface{}) Error

Variables

var (
	ErrInvalid     = Error{Code: "bad_request", Message: "Request is not valid"}
	ErrNotFound    = Error{Code: "not_found", Message: "Requested entity not found"}
	ErrConflict    = Error{Code: "conflict", Message: "An entity with conflicting identifier exists"}
	ErrForbidden   = Error{Code: "forbidden", Message: "You are not authorised for the requested action"}
	ErrInternal    = Error{Code: "internal_error", Message: "Some unexpected error occurred"}
	ErrUnsupported = Error{Code: "unsupported", Message: "Requested feature is not supported"}
)

Common timer domain errors. Use `ErrX.WithCausef()` to clone and add context.

Functions

func Errorf

func Errorf(format string, args ...interface{}) error

Errorf returns a formatted error similar to `fmt.Errorf` but uses the Error type defined in this package. returned value is equivalent to ErrInternal (i.e., errors.Is(retVal, ErrInternal) = true).

func Is

func Is(err, target error) bool

Is returns true if 'err' is equivalent to the 'target' error. This function is a convenience shortcut for the errors.Is().

func New

func New(msg string) error

New returns a new error equivalent to ErrInternal. This function is a convenience shortcut for the errors.New().

Types

type Error

type Error struct {
	Code    string `json:"code"`
	Cause   string `json:"cause,omitempty"`
	Message string `json:"message"`
}

Error represents any error returned by the components along with any relevant context.

func E

func E(err error) Error

E converts any given error to the Error type. Unknown are converted to ErrInternal.

func (Error) Error

func (err Error) Error() string

func (Error) Is

func (err Error) Is(other error) bool

Is checks if 'other' is of type Error and has the same code. See https://blog.golang.org/go1.13-errors.

func (Error) WithCausef

func (err Error) WithCausef(format string, args ...interface{}) Error

WithCausef returns clone of err with the cause added. Use this when you need to provide description of the underlying technical root-cause which may be written in log for debugging purposes. Cause will be shown to the user only when the Message is empty.

func (Error) WithMsgf

func (err Error) WithMsgf(format string, args ...interface{}) Error

WithMsgf returns a clone of the error with message set. Use this when you need to provide a custom message that should be shown to the user. If the message is set to empty string, cause will be displayed to the user.