9736123483
Updates #2541. Squashed commit of the following: commit c81299991876f48836d24872d9145331a0bc9e6e Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Tue Mar 16 18:10:07 2021 +0300 agherr: imp docs commit f43a5f5cde0ea16dd38dd533e16e415a1d306cb2 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Tue Mar 16 17:35:59 2021 +0300 all: imp err handling, fix code commit ed26ad0ff53882725f7747264f8094e6fb9b0423 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Tue Mar 16 12:24:17 2021 +0300 dhcpd: fix ip ranges
110 lines
2.5 KiB
Go
110 lines
2.5 KiB
Go
// Package agherr contains AdGuard Home's error handling helpers.
|
|
package agherr
|
|
|
|
import (
|
|
"fmt"
|
|
"strings"
|
|
)
|
|
|
|
// Error is the constant error type.
|
|
type Error string
|
|
|
|
// Error implements the error interface for Error.
|
|
func (err Error) Error() (msg string) {
|
|
return string(err)
|
|
}
|
|
|
|
// manyError is an error containing several wrapped errors. It is created to be
|
|
// a simpler version of the API provided by github.com/joomcode/errorx.
|
|
type manyError struct {
|
|
message string
|
|
underlying []error
|
|
}
|
|
|
|
// Many wraps several errors and returns a single error.
|
|
//
|
|
// TODO(a.garipov): Add formatting to message.
|
|
func Many(message string, underlying ...error) (err error) {
|
|
err = &manyError{
|
|
message: message,
|
|
underlying: underlying,
|
|
}
|
|
|
|
return err
|
|
}
|
|
|
|
// Error implements the error interface for *manyError.
|
|
func (e *manyError) Error() (msg string) {
|
|
switch len(e.underlying) {
|
|
case 0:
|
|
return e.message
|
|
case 1:
|
|
return fmt.Sprintf("%s: %s", e.message, e.underlying[0])
|
|
default:
|
|
b := &strings.Builder{}
|
|
|
|
// Ignore errors, since strings.(*Buffer).Write never returns
|
|
// errors.
|
|
_, _ = fmt.Fprintf(b, "%s: %s (hidden: %s", e.message, e.underlying[0], e.underlying[1])
|
|
for _, u := range e.underlying[2:] {
|
|
// See comment above.
|
|
_, _ = fmt.Fprintf(b, ", %s", u)
|
|
}
|
|
|
|
// See comment above.
|
|
_, _ = b.WriteString(")")
|
|
|
|
return b.String()
|
|
}
|
|
}
|
|
|
|
// Unwrap implements the hidden errors.wrapper interface for *manyError.
|
|
func (e *manyError) Unwrap() (err error) {
|
|
if len(e.underlying) == 0 {
|
|
return nil
|
|
}
|
|
|
|
return e.underlying[0]
|
|
}
|
|
|
|
// wrapper is a copy of the hidden errors.wrapper interface for tests, linting,
|
|
// etc.
|
|
type wrapper interface {
|
|
Unwrap() error
|
|
}
|
|
|
|
// Annotate annotates the error with the message, unless the error is nil. This
|
|
// is a helper function to simplify code like this:
|
|
//
|
|
// func (f *foo) doStuff(s string) (err error) {
|
|
// defer func() {
|
|
// if err != nil {
|
|
// err = fmt.Errorf("bad foo string %q: %w", s, err)
|
|
// }
|
|
// }()
|
|
//
|
|
// // …
|
|
// }
|
|
//
|
|
// Instead, write:
|
|
//
|
|
// func (f *foo) doStuff(s string) (err error) {
|
|
// defer agherr.Annotate("bad foo string %q: %w", &err, s)
|
|
//
|
|
// // …
|
|
// }
|
|
//
|
|
// msg must contain the final ": %w" verb.
|
|
func Annotate(msg string, errPtr *error, args ...interface{}) {
|
|
if errPtr == nil {
|
|
return
|
|
}
|
|
|
|
err := *errPtr
|
|
if err != nil {
|
|
args = append(args, err)
|
|
|
|
*errPtr = fmt.Errorf(msg, args...)
|
|
}
|
|
}
|