errdefs

package
v20.10.22+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 15, 2022 License: Apache-2.0 Imports: 3 Imported by: 4,859

Documentation

Overview

Package errdefs defines a set of error interfaces that packages should use for communicating classes of errors. Errors that cross the package boundary should implement one (and only one) of these interfaces.

Packages should not reference these interfaces directly, only implement them. To check if a particular error implements one of these interfaces, there are helper functions provided (e.g. `Is<SomeError>`) which can be used rather than asserting the interfaces directly. If you must assert on these interfaces, be sure to check the causal chain (`err.Cause()`).

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Cancelled

func Cancelled(err error) error

Cancelled is a helper to create an error of the class with the same name from any error type

func Conflict

func Conflict(err error) error

Conflict is a helper to create an error of the class with the same name from any error type

func DataLoss

func DataLoss(err error) error

DataLoss is a helper to create an error of the class with the same name from any error type

func Deadline

func Deadline(err error) error

Deadline is a helper to create an error of the class with the same name from any error type

func Forbidden

func Forbidden(err error) error

Forbidden is a helper to create an error of the class with the same name from any error type

func FromContext

func FromContext(ctx context.Context) error

FromContext returns the error class from the passed in context

func FromStatusCode

func FromStatusCode(err error, statusCode int) error

FromStatusCode creates an errdef error, based on the provided HTTP status-code

func InvalidParameter

func InvalidParameter(err error) error

InvalidParameter is a helper to create an error of the class with the same name from any error type

func IsCancelled

func IsCancelled(err error) bool

IsCancelled returns if the passed in error is an ErrCancelled

func IsConflict

func IsConflict(err error) bool

IsConflict returns if the passed in error is an ErrConflict

func IsDataLoss

func IsDataLoss(err error) bool

IsDataLoss returns if the passed in error is an ErrDataLoss

func IsDeadline

func IsDeadline(err error) bool

IsDeadline returns if the passed in error is an ErrDeadline

func IsForbidden

func IsForbidden(err error) bool

IsForbidden returns if the passed in error is an ErrForbidden

func IsInvalidParameter

func IsInvalidParameter(err error) bool

IsInvalidParameter returns if the passed in error is an ErrInvalidParameter

func IsNotFound

func IsNotFound(err error) bool

IsNotFound returns if the passed in error is an ErrNotFound

func IsNotImplemented

func IsNotImplemented(err error) bool

IsNotImplemented returns if the passed in error is an ErrNotImplemented

func IsNotModified

func IsNotModified(err error) bool

IsNotModified returns if the passed in error is a NotModified error

func IsSystem

func IsSystem(err error) bool

IsSystem returns if the passed in error is an ErrSystem

func IsUnauthorized

func IsUnauthorized(err error) bool

IsUnauthorized returns if the passed in error is an ErrUnauthorized

func IsUnavailable

func IsUnavailable(err error) bool

IsUnavailable returns if the passed in error is an ErrUnavailable

func IsUnknown

func IsUnknown(err error) bool

IsUnknown returns if the passed in error is an ErrUnknown

func NotFound

func NotFound(err error) error

NotFound is a helper to create an error of the class with the same name from any error type

func NotImplemented

func NotImplemented(err error) error

NotImplemented is a helper to create an error of the class with the same name from any error type

func NotModified

func NotModified(err error) error

NotModified is a helper to create an error of the class with the same name from any error type

func System

func System(err error) error

System is a helper to create an error of the class with the same name from any error type

func Unauthorized

func Unauthorized(err error) error

Unauthorized is a helper to create an error of the class with the same name from any error type

func Unavailable

func Unavailable(err error) error

Unavailable is a helper to create an error of the class with the same name from any error type

func Unknown

func Unknown(err error) error

Unknown is a helper to create an error of the class with the same name from any error type

Types

type ErrCancelled

type ErrCancelled interface {
	Cancelled()
}

ErrCancelled signals that the action was cancelled.

type ErrConflict

type ErrConflict interface {
	Conflict()
}

ErrConflict signals that some internal state conflicts with the requested action and can't be performed. A change in state should be able to clear this error.

type ErrDataLoss

type ErrDataLoss interface {
	DataLoss()
}

ErrDataLoss indicates that data was lost or there is data corruption.

type ErrDeadline

type ErrDeadline interface {
	DeadlineExceeded()
}

ErrDeadline signals that the deadline was reached before the action completed.

type ErrForbidden

type ErrForbidden interface {
	Forbidden()
}

ErrForbidden signals that the requested action cannot be performed under any circumstances. When a ErrForbidden is returned, the caller should never retry the action.

type ErrInvalidParameter

type ErrInvalidParameter interface {
	InvalidParameter()
}

ErrInvalidParameter signals that the user input is invalid

type ErrNotFound

type ErrNotFound interface {
	NotFound()
}

ErrNotFound signals that the requested object doesn't exist

type ErrNotImplemented

type ErrNotImplemented interface {
	NotImplemented()
}

ErrNotImplemented signals that the requested action/feature is not implemented on the system as configured.

type ErrNotModified

type ErrNotModified interface {
	NotModified()
}

ErrNotModified signals that an action can't be performed because it's already in the desired state

type ErrSystem

type ErrSystem interface {
	System()
}

ErrSystem signals that some internal error occurred. An example of this would be a failed mount request.

type ErrUnauthorized

type ErrUnauthorized interface {
	Unauthorized()
}

ErrUnauthorized is used to signify that the user is not authorized to perform a specific action

type ErrUnavailable

type ErrUnavailable interface {
	Unavailable()
}

ErrUnavailable signals that the requested action/subsystem is not available.

type ErrUnknown

type ErrUnknown interface {
	Unknown()
}

ErrUnknown signals that the kind of error that occurred is not known.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL