errors

Documentation

Index

• func Internal(err error) error
• func Invalid(name string, value interface{}) error
• func NewError(typ ErrorType, detail string) error
• func Noninteractive(op string) error
• func NotImplemented() error
• func Range(name string, value interface{}) error
• func Required(name string) error
• type Error
  • func (e *Error) Error() string
• type ErrorGroup
  • func NewErrorGroup() *ErrorGroup
  • func (e *ErrorGroup) Add(err error)
  • func (e *ErrorGroup) Error() string
  • func (e *ErrorGroup) Errors() []error
  • func (e *ErrorGroup) Len() int
  • func (e *ErrorGroup) Less(i, j int) bool
  • func (e *ErrorGroup) Swap(i, j int)
• type ErrorType

Functions

func Internal

func Internal(err error) error

Internal generates an instance representing an error that occurs when an internal error is thrown during the command execution.

func Invalid

func Invalid(name string, value interface{}) error

Invalid generates an instance representing an error that occurs when a string parameter is set a malformed value (e.g. failed regex match, too long).

func NewError

func NewError(typ ErrorType, detail string) error

NewError generates a custom error.

func Noninteractive

func Noninteractive(op string) error

Noninteractive generates an instance representing an error that occurs when a command cannot run in non-interactive mode.

func NotImplemented

func NotImplemented() error

NotImplemented generates an instance representing an error that occurs when an unimplemented method is called.

func Range

func Range(name string, value interface{}) error

Range generates an instance representing an error that occurs when a numeric parameter is outside of its valid range.

func Required

func Required(name string) error

Required generates an instance representing an error that occurs when a required parameter is missing.

Types

type Error

type Error struct {
	// Type defines an error type, expressed as a string value.
	Type ErrorType `json:"type"`

	// Detail defines a human-readable explanation specific to the error.
	Detail string `json:"detail"`
}

Error provides a way to return detailed information for an error.

func (*Error) Error

func (e *Error) Error() string

Error implements the `error` interface.

type ErrorGroup

type ErrorGroup struct {
	// contains filtered or unexported fields
}

ErrorGroup is an error type to track multiple errors. This is used to accumulate errors in cases and return them as a single error.

func NewErrorGroup

func NewErrorGroup() *ErrorGroup

NewErrorGroup returns a new error group.

func (*ErrorGroup) Add

func (e *ErrorGroup) Add(err error)

Add adds a new error to the group.

func (*ErrorGroup) Error

func (e *ErrorGroup) Error() string

Error implements the internal error interface.

func (*ErrorGroup) Errors

func (e *ErrorGroup) Errors() []error

Errors returns the list of errors that this group is wrapping.

func (*ErrorGroup) Len

func (e *ErrorGroup) Len() int

Len implements sort.Interface function for length.

func (*ErrorGroup) Less

func (e *ErrorGroup) Less(i, j int) bool

Less implements sort.Interface function for determining order.

func (*ErrorGroup) Swap

func (e *ErrorGroup) Swap(i, j int)

Swap implements sort.Interface function for swapping elements.

type ErrorType

type ErrorType string

ErrorType represents the type of an error.

const (
	// ErrorTypeInternal is used to represent an error that occurs when an internal
	// error is thrown during the command execution.
	ErrorTypeInternal ErrorType = "InternalError"

	// ErrorTypeRequired is used to represent an error that occurs when a required
	// parameter is missing.
	ErrorTypeRequired ErrorType = "RequiredError"

	// ErrorTypeInvalid is used to represent an error that occurs when a string
	// parameter is set a malformed value (e.g. failed regex match, too long).
	ErrorTypeInvalid ErrorType = "InvalidError"

	// ErrorTypeRange is used to represent an error that occurs when a numeric
	// parameter is outside of its valid range.
	ErrorTypeRange ErrorType = "RangeError"

	// ErrorTypeNotImplemented is used to represent an error that occurs when
	// an unimplemented method is called.
	ErrorTypeNotImplemented ErrorType = "NotImplementedError"
)