cgerrors

package
v0.0.25 Latest Latest
Warning

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

 Go to latest Published: Sep 14, 2021 License: Apache-2.0 Imports: 8 Imported by: 13

Documentation

Overview

Package cgerrors provides a way to return detailed information for an RPC request error. The error is normally JSON encoded.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Equal 

func Equal(err1 error, err2 error) bool

Equal tries to compare errors

func Is 

func Is(err, target error) bool

Is compares the errors with their values.

func IsAlreadyExists 

func IsAlreadyExists(err error) bool

IsAlreadyExists checks if given error means that given entity already exists.

func IsDeadlineExceeded 

func IsDeadlineExceeded(err error) bool

IsDeadlineExceeded checks if given error is of type Deadline Exceeded.

func IsInternal 

func IsInternal(err error) bool

IsInternal checks if the input is an internal error.

func IsInvalidArgument 

func IsInvalidArgument(err error) bool

IsInvalidArgument checks if given error means that given entity already exists.

func IsNotFound 

func IsNotFound(err error) bool

IsNotFound checks if given input error is of code NotFound.

func IsPermissionDenied 

func IsPermissionDenied(err error) bool

IsPermissionDenied checks if given error is of type PermissionDenied.

func IsUnauthenticated 

func IsUnauthenticated(err error) bool

IsUnauthenticated checks if given error is an unauthenticated error.

func IsUnimplemented added in v0.0.5 

func IsUnimplemented(err error) bool

IsUnimplemented checks if given error contains Unimplemented code.

func ToGRPCError 

func ToGRPCError(err error) error

ToGRPCError converts an error to GRPC status.Status.

Types

type Error 

type Error struct {
	ID      string            `json:"id,omitempty"`
	Code    ErrorCode         `json:"code,omitempty"`
	Detail  string            `json:"detail,omitempty"`
	Process string            `json:"process,omitempty"`
	Meta    map[string]string `json:"meta,omitempty"`
	// contains filtered or unexported fields
}

Error is the error message that has id, it's code and a detail.

func ErrAlreadyExists 

func ErrAlreadyExists(a ...interface{}) *Error

ErrAlreadyExists generates a 409 error.

func ErrAlreadyExistsf 

func ErrAlreadyExistsf(format string, a ...interface{}) *Error

ErrAlreadyExistsf generates formatted 409 error.

func ErrDeadlineExceeded 

func ErrDeadlineExceeded(a ...interface{}) *Error

ErrDeadlineExceeded generates a 408 error.

func ErrDeadlineExceededf 

func ErrDeadlineExceededf(format string, a ...interface{}) *Error

ErrDeadlineExceededf generates formatted 408 error.

func ErrFailedPrecondition added in v0.0.21 

func ErrFailedPrecondition(a ...interface{}) *Error

ErrFailedPrecondition generates a 400 error.

func ErrFailedPreconditionf added in v0.0.21 

func ErrFailedPreconditionf(format string, a ...interface{}) *Error

ErrFailedPreconditionf generates a 400 error.

func ErrInternal 

func ErrInternal(a ...interface{}) *Error

ErrInternal generates a 500 error.

func ErrInternalf 

func ErrInternalf(format string, a ...interface{}) *Error

ErrInternalf generates formatted 500 error.

func ErrInvalidArgument 

func ErrInvalidArgument(a ...interface{}) *Error

ErrInvalidArgument generates a 400 error.

func ErrInvalidArgumentf 

func ErrInvalidArgumentf(format string, a ...interface{}) *Error

ErrInvalidArgumentf generates formatted 400 error.

func ErrNotFound 

func ErrNotFound(a ...interface{}) *Error

ErrNotFound generates a 404 error.

func ErrNotFoundf 

func ErrNotFoundf(format string, a ...interface{}) *Error

ErrNotFoundf generates formatted 404 error.

func ErrPermissionDenied 

func ErrPermissionDenied(a ...interface{}) *Error

ErrPermissionDenied generates a 403 error.

func ErrPermissionDeniedf 

func ErrPermissionDeniedf(format string, a ...interface{}) *Error

ErrPermissionDeniedf generates a 403 error.

func ErrUnauthenticated 

func ErrUnauthenticated(a ...interface{}) *Error

ErrUnauthenticated generates a 401 error.

func ErrUnauthenticatedf 

func ErrUnauthenticatedf(format string, a ...interface{}) *Error

ErrUnauthenticatedf generates 401 error with formatted message.

func ErrUnavailable added in v0.0.25 

func ErrUnavailable(a ...interface{}) *Error

ErrUnavailable generates Unavailable error.

func ErrUnavailablef added in v0.0.25 

func ErrUnavailablef(format string, a ...interface{}) *Error

ErrUnavailablef generates Unavailable error with formatting.

func ErrUnimplemented added in v0.0.5 

func ErrUnimplemented(a ...interface{}) *Error

ErrUnimplemented generates Unimplemented error.

func ErrUnimplementedf added in v0.0.5 

func ErrUnimplementedf(format string, a ...interface{}) *Error

ErrUnimplementedf generates Unimplemented error with formatting.

func ErrUnknown added in v0.0.23 

func ErrUnknown(a ...interface{}) *Error

ErrUnknown generates Unknown error.

func ErrUnknownf added in v0.0.23 

func ErrUnknownf(format string, a ...interface{}) *Error

ErrUnknownf generates Unknown error with formatting.

func FromError 

func FromError(err error) *Error

FromError try to convert go error to *Error

func FromString added in v0.0.23 

func FromString(err string) (*Error, bool)

FromString parses string error into an Error structure.

func New 

func New(id, detail string, code ErrorCode) *Error

New generates a custom error.

func Parse 

func Parse(err string) *Error

Parse tries to parse a JSON string into an error. If that fails, it will set the given string as the error detail.

func To 

func To(err error) *Error

To type check if given error is of *Error type or has encoded ErrorCode in it. Otherwise creates a new error with Unknown code.

func Wrap added in v0.0.25 

func Wrap(err error, code ErrorCode, detail string) *Error

Wrap wraps the error with given code and detail.

func Wrapf added in v0.0.25 

func Wrapf(err error, code ErrorCode, format string, args ...interface{}) *Error

Wrapf wraps the error with given code and formatted detail message.

func (*Error) Error 

func (e *Error) Error() string

Error implements error interface.

func (*Error) GRPCStatus 

func (e *Error) GRPCStatus() *status.Status

GRPCStatus implements grpc client interface used to convert statuses.

func (*Error) Is 

func (e *Error) Is(err error) bool

Is implements errors.Is function interface to check if input error matches this error or the one wrapped.

func (*Error) Unwrap added in v0.0.25 

func (e *Error) Unwrap() error

Unwrap implements errors.Unwrap function internal interface.

func (*Error) WithCode 

func (e *Error) WithCode(code ErrorCode) *Error

WithCode sets the code for given error.

func (*Error) WithMeta 

func (e *Error) WithMeta(key, value string) *Error

WithMeta sets the key, value metadata for given error.

func (*Error) WithProcess 

func (e *Error) WithProcess(process string) *Error

WithProcess sets the process for given error.

type ErrorCode 

type ErrorCode int32

ErrorCode is a code that defines errors specification. 

const (
	ErrorCode_OK                 ErrorCode = 0
	ErrorCode_Canceled           ErrorCode = 1
	ErrorCode_Unknown            ErrorCode = 2
	ErrorCode_InvalidArgument    ErrorCode = 3
	ErrorCode_DeadlineExceeded   ErrorCode = 4
	ErrorCode_NotFound           ErrorCode = 5
	ErrorCode_AlreadyExists      ErrorCode = 6
	ErrorCode_PermissionDenied   ErrorCode = 7
	ErrorCode_ResourceExhausted  ErrorCode = 8
	ErrorCode_FailedPrecondition ErrorCode = 9
	ErrorCode_Aborted            ErrorCode = 10
	ErrorCode_OutOfRange         ErrorCode = 11
	ErrorCode_Unimplemented      ErrorCode = 12
	ErrorCode_Internal           ErrorCode = 13
	ErrorCode_Unavailable        ErrorCode = 14
	ErrorCode_DataLoss           ErrorCode = 15
	ErrorCode_Unauthenticated    ErrorCode = 16
)

ErrorCode well known codes.

func Code 

func Code(err error) ErrorCode

Code gets the code defined in given

func (ErrorCode) String 

func (c ErrorCode) String() string

func (ErrorCode) ToGRPCCode 

func (c ErrorCode) ToGRPCCode() codes.Code

ToGRPCCode gets the related grpc code.

type ErrorCoder 

type ErrorCoder interface {
	ErrorCode(err error) ErrorCode
}

ErrorCoder is an interface used to obtain an error code from given error within given implementation.

type GRPCError 

type GRPCError interface {
	GRPCStatus() *status.Status
}

GRPCError is an interface used to get grpcStatus

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.