errors

Documentation

Overview

Package errors provides convenience functions for Kivik drivers to report meaningful errors. This package is not conisidered part of the kivik public API and is subject to change without notice.

Index

• func Cause(err error) error
• func Errorf(format string, args ...interface{}) error
• func New(msg string) error
• func Reason(err error) string
• func Status(status int, msg string) error
• func StatusCode(err error) int
• func StatusCodeOK(err error) (code int, ok bool)
• func Statusf(status int, format string, args ...interface{}) error
• func Wrap(err error, msg string) error
• func WrapStatus(status int, err error) error
• func Wrapf(err error, format string, args ...interface{}) error
• type Reasoner

Functions

func Cause

func Cause(err error) error

Cause is a wrapper around pkg/errors.Cause()

func Errorf

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

Errorf is a wrapper around pkg/errors.Errorf()

func New

func New(msg string) error

New is a wrapper around the standard errors.New, to avoid the need for multiple imports.

func Reason

func Reason(err error) string

Reason returns the error's reason if there is one.

func Status

func Status(status int, msg string) error

Status returns a new error with the designated HTTP status.

func StatusCode

func StatusCode(err error) int

StatusCode extracts an embedded HTTP status code from an error.

func StatusCodeOK

func StatusCodeOK(err error) (code int, ok bool)

StatusCodeOK extracts an embedded HTTP status code from an error and returns it. ok will be false if the error does not embed a status code.

func Statusf

func Statusf(status int, format string, args ...interface{}) error

Statusf returns a new error with the designated HTTP status.

func Wrap

func Wrap(err error, msg string) error

Wrap is a wrapper around pkg/errors.Wrap()

func WrapStatus

func WrapStatus(status int, err error) error

WrapStatus bundles an existing error with a status code.

func Wrapf

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

Wrapf is a wrapper around pkg/errors.Wrapf()

Types

type Reasoner

type Reasoner interface {
	Reason() string
}

Reasoner is an interface for an error that contains a reason.