package errs

import "github.com/zeebo/errs"

Package errs provides a simple error package with stack traces.

Index ¶

• func New(format string, args ...interface{}) error
• func Unwrap(err error) error
• func Wrap(err error) error
• type Causer
• type Class
• func Classes(err error) []*Class
• func (c *Class) Has(err error) bool
• func (c *Class) New(format string, args ...interface{}) error
• func (c *Class) Wrap(err error) error
• type Namer

Functions ¶

func New ¶

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

New returns an error not contained in any class. This is the same as calling fmt.Errorf(...) except it captures a stack trace on creation.

func Unwrap ¶

func Unwrap(err error) error

Unwrap returns the underlying error, if any, or just the error.

func Wrap ¶

func Wrap(err error) error

Wrap returns an error not contained in any class. It just associates a stack trace with the error.

Types ¶

type Causer ¶

type Causer interface{ Cause() error }

Causer is implemented by all errors returned in this package. It returns the underlying cause of the error, or nil if there is no underlying cause.

type Class ¶

type Class string

Class represents a class of errors. You can construct errors, and check if errors are part of the class.

func Classes ¶

func Classes(err error) []*Class

Classes returns all the classes that have wrapped the error.

func (*Class) Has ¶

func (c *Class) Has(err error) bool

Has returns true if the passed in error was wrapped by this class.

func (*Class) New ¶

func (c *Class) New(format string, args ...interface{}) error

New constructs an error with the format string that will be contained by this class. This is the same as calling Wrap(fmt.Errorf(...)).

func (*Class) Wrap ¶

func (c *Class) Wrap(err error) error

Wrap returns a new error based on the passed in error that is contained in this class.

type Namer ¶

type Namer interface{ Name() (string, bool) }

Namer is implemented by all errors returned in this package. It returns a name for the class of error it is, and a boolean indicating if the name is valid.

Source Files ¶

errs.go

Directories ¶