errors

package
v3.38.7 Latest Latest
Warning

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

 Go to latest Published: Jul 24, 2024 License: MIT Imports: 15 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	CodeOk      int = iota // Used when the program exits without errors
	CodeUnknown            // Used when no other exit code is appropriate
)

General exit codes

View Source 
const (
	CodeTaskfileNotFound int = iota + 100
	CodeTaskfileAlreadyExists
	CodeTaskfileDecode
	CodeTaskfileFetchFailed
	CodeTaskfileNotTrusted
	CodeTaskfileNotSecure
	CodeTaskfileCacheNotFound
	CodeTaskfileVersionCheckError
	CodeTaskfileNetworkTimeout
	CodeTaskfileInvalid
	CodeTaskfileCycle
)

Taskfile related exit codes

View Source 
const (
	CodeTaskNotFound int = iota + 200
	CodeTaskRunError
	CodeTaskInternal
	CodeTaskNameConflict
	CodeTaskCalledTooManyTimes
	CodeTaskCancelled
	CodeTaskMissingRequiredVars
)

Task related exit codes

Variables

This section is empty.

Functions

func As 

func As(err error, target any) bool

As wraps the standard errors.As function so that we don't need to alias that package.

func Is 

func Is(err, target error) bool

Is wraps the standard errors.Is function so that we don't need to alias that package.

func New 

func New(text string) error

New returns an error that formats as the given text. Each call to New returns a distinct error value even if the text is identical. This wraps the standard errors.New function so that we don't need to alias that package.

func Unwrap 

func Unwrap(err error) error

Unwrap wraps the standard errors.Unwrap function so that we don't need to alias that package.

Types

type TaskCalledTooManyTimesError 

type TaskCalledTooManyTimesError struct {
	TaskName        string
	MaximumTaskCall int
}

TaskCalledTooManyTimesError is returned when the maximum task call limit is exceeded. This is to prevent infinite loops and cyclic dependencies.

func (*TaskCalledTooManyTimesError) Code 

func (err *TaskCalledTooManyTimesError) Code() int

func (*TaskCalledTooManyTimesError) Error 

func (err *TaskCalledTooManyTimesError) Error() string

type TaskCancelledByUserError 

type TaskCancelledByUserError struct {
	TaskName string
}

TaskCancelledByUserError is returned when the user does not accept an optional prompt to continue.

func (*TaskCancelledByUserError) Code 

func (err *TaskCancelledByUserError) Code() int

func (*TaskCancelledByUserError) Error 

func (err *TaskCancelledByUserError) Error() string

type TaskCancelledNoTerminalError 

type TaskCancelledNoTerminalError struct {
	TaskName string
}

TaskCancelledNoTerminalError is returned when trying to run a task with a prompt in a non-terminal environment.

func (*TaskCancelledNoTerminalError) Code 

func (err *TaskCancelledNoTerminalError) Code() int

func (*TaskCancelledNoTerminalError) Error 

func (err *TaskCancelledNoTerminalError) Error() string

type TaskError 

type TaskError interface {
	error
	Code() int
}

TaskError extends the standard error interface with a Code method. This code will be used as the exit code of the program which allows the user to distinguish between different types of errors.

type TaskInternalError 

type TaskInternalError struct {
	TaskName string
}

TaskInternalError when the user attempts to invoke a task that is internal.

func (*TaskInternalError) Code 

func (err *TaskInternalError) Code() int

func (*TaskInternalError) Error 

func (err *TaskInternalError) Error() string

type TaskMissingRequiredVars 

type TaskMissingRequiredVars struct {
	TaskName    string
	MissingVars []string
}

TaskMissingRequiredVars is returned when a task is missing required variables.

func (*TaskMissingRequiredVars) Code 

func (err *TaskMissingRequiredVars) Code() int

func (*TaskMissingRequiredVars) Error 

func (err *TaskMissingRequiredVars) Error() string

type TaskNameConflictError 

type TaskNameConflictError struct {
	Call      string
	TaskNames []string
}

TaskNameConflictError is returned when multiple tasks with a matching name or alias are found.

func (*TaskNameConflictError) Code 

func (err *TaskNameConflictError) Code() int

func (*TaskNameConflictError) Error 

func (err *TaskNameConflictError) Error() string

type TaskNotFoundError 

type TaskNotFoundError struct {
	TaskName   string
	DidYouMean string
}

TaskNotFoundError is returned when the specified task is not found in the Taskfile.

func (*TaskNotFoundError) Code 

func (err *TaskNotFoundError) Code() int

func (*TaskNotFoundError) Error 

func (err *TaskNotFoundError) Error() string

type TaskRunError 

type TaskRunError struct {
	TaskName string
	Err      error
}

TaskRunError is returned when a command in a task returns a non-zero exit code.

func (*TaskRunError) Code 

func (err *TaskRunError) Code() int

func (*TaskRunError) Error 

func (err *TaskRunError) Error() string

func (*TaskRunError) TaskExitCode 

func (err *TaskRunError) TaskExitCode() int

type TaskfileAlreadyExistsError 

type TaskfileAlreadyExistsError struct{}

TaskfileAlreadyExistsError is returned on creating a Taskfile if one already exists.

func (TaskfileAlreadyExistsError) Code 

func (err TaskfileAlreadyExistsError) Code() int

func (TaskfileAlreadyExistsError) Error 

func (err TaskfileAlreadyExistsError) Error() string

type TaskfileCacheNotFoundError 

type TaskfileCacheNotFoundError struct {
	URI string
}

TaskfileCacheNotFoundError is returned when the user attempts to use an offline (cached) Taskfile but the files does not exist in the cache.

func (*TaskfileCacheNotFoundError) Code 

func (err *TaskfileCacheNotFoundError) Code() int

func (*TaskfileCacheNotFoundError) Error 

func (err *TaskfileCacheNotFoundError) Error() string

type TaskfileCycleError 

type TaskfileCycleError struct {
	Source      string
	Destination string
}

TaskfileCycleError is returned when we detect that a Taskfile includes a set of Taskfiles that include each other in a cycle.

func (TaskfileCycleError) Code 

func (err TaskfileCycleError) Code() int

func (TaskfileCycleError) Error 

func (err TaskfileCycleError) Error() string

type TaskfileDecodeError 

type TaskfileDecodeError struct {
	Message  string
	Location string
	Line     int
	Column   int
	Tag      string
	Snippet  TaskfileSnippet
	Err      error
}

func NewTaskfileDecodeError 

func NewTaskfileDecodeError(err error, node *yaml.Node) *TaskfileDecodeError

func (*TaskfileDecodeError) Code 

func (err *TaskfileDecodeError) Code() int

func (*TaskfileDecodeError) Error 

func (err *TaskfileDecodeError) Error() string

func (*TaskfileDecodeError) Unwrap 

func (err *TaskfileDecodeError) Unwrap() error

func (*TaskfileDecodeError) WithFileInfo 

func (err *TaskfileDecodeError) WithFileInfo(location string, b []byte, padding int) *TaskfileDecodeError

func (*TaskfileDecodeError) WithMessage 

func (err *TaskfileDecodeError) WithMessage(format string, a ...any) *TaskfileDecodeError

func (*TaskfileDecodeError) WithTypeMessage 

func (err *TaskfileDecodeError) WithTypeMessage(t string) *TaskfileDecodeError

type TaskfileFetchFailedError 

type TaskfileFetchFailedError struct {
	URI            string
	HTTPStatusCode int
}

TaskfileFetchFailedError is returned when no appropriate Taskfile is found when searching the filesystem.

func (TaskfileFetchFailedError) Code 

func (err TaskfileFetchFailedError) Code() int

func (TaskfileFetchFailedError) Error 

func (err TaskfileFetchFailedError) Error() string

type TaskfileInvalidError 

type TaskfileInvalidError struct {
	URI string
	Err error
}

TaskfileInvalidError is returned when the Taskfile contains syntax errors or cannot be parsed for some reason.

func (TaskfileInvalidError) Code 

func (err TaskfileInvalidError) Code() int

func (TaskfileInvalidError) Error 

func (err TaskfileInvalidError) Error() string

type TaskfileNetworkTimeoutError 

type TaskfileNetworkTimeoutError struct {
	URI          string
	Timeout      time.Duration
	CheckedCache bool
}

TaskfileNetworkTimeoutError is returned when the user attempts to use a remote Taskfile but a network connection could not be established within the timeout.

func (*TaskfileNetworkTimeoutError) Code 

func (err *TaskfileNetworkTimeoutError) Code() int

func (*TaskfileNetworkTimeoutError) Error 

func (err *TaskfileNetworkTimeoutError) Error() string

type TaskfileNotFoundError 

type TaskfileNotFoundError struct {
	URI  string
	Walk bool
}

TaskfileNotFoundError is returned when no appropriate Taskfile is found when searching the filesystem.

func (TaskfileNotFoundError) Code 

func (err TaskfileNotFoundError) Code() int

func (TaskfileNotFoundError) Error 

func (err TaskfileNotFoundError) Error() string

type TaskfileNotSecureError 

type TaskfileNotSecureError struct {
	URI string
}

TaskfileNotSecureError is returned when the user attempts to download a remote Taskfile over an insecure connection.

func (*TaskfileNotSecureError) Code 

func (err *TaskfileNotSecureError) Code() int

func (*TaskfileNotSecureError) Error 

func (err *TaskfileNotSecureError) Error() string

type TaskfileNotTrustedError 

type TaskfileNotTrustedError struct {
	URI string
}

TaskfileNotTrustedError is returned when the user does not accept the trust prompt when downloading a remote Taskfile.

func (*TaskfileNotTrustedError) Code 

func (err *TaskfileNotTrustedError) Code() int

func (*TaskfileNotTrustedError) Error 

func (err *TaskfileNotTrustedError) Error() string

type TaskfileSnippet 

type TaskfileSnippet struct {
	Lines     []string
	StartLine int
	EndLine   int
	Padding   int
}

type TaskfileVersionCheckError 

type TaskfileVersionCheckError struct {
	URI           string
	SchemaVersion *semver.Version
	Message       string
}

TaskfileVersionCheckError is returned when the user attempts to run a Taskfile that does not contain a Taskfile schema version key or if they try to use a feature that is not supported by the schema version.

func (*TaskfileVersionCheckError) Code 

func (err *TaskfileVersionCheckError) Code() int

func (*TaskfileVersionCheckError) Error 

func (err *TaskfileVersionCheckError) Error() string

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.