2018-05-01 23:45:06 +00:00
|
|
|
package cli
|
|
|
|
|
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
"io"
|
|
|
|
"os"
|
|
|
|
"strings"
|
|
|
|
)
|
|
|
|
|
|
|
|
// OsExiter is the function used when the app exits. If not set defaults to os.Exit.
|
|
|
|
var OsExiter = os.Exit
|
|
|
|
|
|
|
|
// ErrWriter is used to write errors to the user. This can be anything
|
|
|
|
// implementing the io.Writer interface and defaults to os.Stderr.
|
|
|
|
var ErrWriter io.Writer = os.Stderr
|
|
|
|
|
|
|
|
// MultiError is an error that wraps multiple errors.
|
|
|
|
type MultiError interface {
|
|
|
|
error
|
2021-02-23 12:23:57 +00:00
|
|
|
// Errors returns a copy of the errors slice
|
2018-05-01 23:45:06 +00:00
|
|
|
Errors() []error
|
|
|
|
}
|
|
|
|
|
2021-02-23 12:23:57 +00:00
|
|
|
// NewMultiError creates a new MultiError. Pass in one or more errors.
|
2018-05-01 23:45:06 +00:00
|
|
|
func newMultiError(err ...error) MultiError {
|
|
|
|
ret := multiError(err)
|
|
|
|
return &ret
|
|
|
|
}
|
|
|
|
|
|
|
|
type multiError []error
|
|
|
|
|
|
|
|
// Error implements the error interface.
|
|
|
|
func (m *multiError) Error() string {
|
|
|
|
errs := make([]string, len(*m))
|
|
|
|
for i, err := range *m {
|
|
|
|
errs[i] = err.Error()
|
|
|
|
}
|
|
|
|
|
|
|
|
return strings.Join(errs, "\n")
|
|
|
|
}
|
|
|
|
|
|
|
|
// Errors returns a copy of the errors slice
|
|
|
|
func (m *multiError) Errors() []error {
|
|
|
|
errs := make([]error, len(*m))
|
|
|
|
for _, err := range *m {
|
|
|
|
errs = append(errs, err)
|
|
|
|
}
|
|
|
|
return errs
|
|
|
|
}
|
|
|
|
|
2020-08-05 10:49:53 +00:00
|
|
|
// ErrorFormatter is the interface that will suitably format the error output
|
2018-05-01 23:45:06 +00:00
|
|
|
type ErrorFormatter interface {
|
|
|
|
Format(s fmt.State, verb rune)
|
|
|
|
}
|
|
|
|
|
|
|
|
// ExitCoder is the interface checked by `App` and `Command` for a custom exit
|
|
|
|
// code
|
|
|
|
type ExitCoder interface {
|
|
|
|
error
|
|
|
|
ExitCode() int
|
|
|
|
}
|
|
|
|
|
|
|
|
type exitError struct {
|
|
|
|
exitCode int
|
|
|
|
message interface{}
|
|
|
|
}
|
|
|
|
|
2021-02-23 12:23:57 +00:00
|
|
|
// NewExitError makes a new *exitError
|
2020-08-05 10:49:53 +00:00
|
|
|
func NewExitError(message interface{}, exitCode int) ExitCoder {
|
|
|
|
return Exit(message, exitCode)
|
|
|
|
}
|
|
|
|
|
2021-02-23 12:23:57 +00:00
|
|
|
// Exit wraps a message and exit code into an ExitCoder suitable for handling by
|
|
|
|
// HandleExitCoder
|
2018-05-01 23:45:06 +00:00
|
|
|
func Exit(message interface{}, exitCode int) ExitCoder {
|
|
|
|
return &exitError{
|
|
|
|
message: message,
|
2020-08-05 10:49:53 +00:00
|
|
|
exitCode: exitCode,
|
2018-05-01 23:45:06 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
func (ee *exitError) Error() string {
|
|
|
|
return fmt.Sprintf("%v", ee.message)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (ee *exitError) ExitCode() int {
|
|
|
|
return ee.exitCode
|
|
|
|
}
|
|
|
|
|
2021-02-23 12:23:57 +00:00
|
|
|
// HandleExitCoder checks if the error fulfills the ExitCoder interface, and if
|
|
|
|
// so prints the error to stderr (if it is non-empty) and calls OsExiter with the
|
|
|
|
// given exit code. If the given error is a MultiError, then this func is
|
|
|
|
// called on all members of the Errors slice and calls OsExiter with the last exit code.
|
2018-05-01 23:45:06 +00:00
|
|
|
func HandleExitCoder(err error) {
|
|
|
|
if err == nil {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
if exitErr, ok := err.(ExitCoder); ok {
|
|
|
|
if err.Error() != "" {
|
|
|
|
if _, ok := exitErr.(ErrorFormatter); ok {
|
2020-08-05 10:49:53 +00:00
|
|
|
_, _ = fmt.Fprintf(ErrWriter, "%+v\n", err)
|
2018-05-01 23:45:06 +00:00
|
|
|
} else {
|
2020-08-05 10:49:53 +00:00
|
|
|
_, _ = fmt.Fprintln(ErrWriter, err)
|
2018-05-01 23:45:06 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
OsExiter(exitErr.ExitCode())
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
if multiErr, ok := err.(MultiError); ok {
|
|
|
|
code := handleMultiError(multiErr)
|
|
|
|
OsExiter(code)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
func handleMultiError(multiErr MultiError) int {
|
|
|
|
code := 1
|
|
|
|
for _, merr := range multiErr.Errors() {
|
|
|
|
if multiErr2, ok := merr.(MultiError); ok {
|
|
|
|
code = handleMultiError(multiErr2)
|
|
|
|
} else if merr != nil {
|
|
|
|
fmt.Fprintln(ErrWriter, merr)
|
|
|
|
if exitErr, ok := merr.(ExitCoder); ok {
|
|
|
|
code = exitErr.ExitCode()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return code
|
|
|
|
}
|