errorhelper

func CallerError ¶ added in v0.6.0

func CallerError(err error) error

CallerError prepends the provided error with caller function name.

func Must ¶ added in v0.2.0

func Must[R any](r R, err error) R

Must returns 'r' if 'err' is nil. Otherwise, it panics with 'err'.

func Must0 ¶ added in v0.3.0

func Must0(err error)

Must0 panics with 'err', if 'err' is not nil.

func Must2 ¶ added in v0.5.0

func Must2[R1, R2 any](r1 R1, r2 R2, err error) (R1, R2)

Must2 returns ('r1', 'r2') if 'err' is nil. Otherwise, it panics with 'err'.

func PanicToError ¶ added in v0.4.0

func PanicToError(panicArg any, err *error)

PanicToError converts panic to error in the following way:

• if surrounding function panics with an error, this error is returned;
• if surrounding function panics with a string, the error wrapping this string is returned;
• if surrounding function panics with a fmt.Stringer, the error wrapping fmt.Stringer.String is returned;
• if surrounding function panics with an encoding.TextMarshaler, the error wrapping encoding.TextMarshaler.MarshalText is returned;
• otherwise the panic is reraised.

PanicToError must be called from a defer statement:

func Example() (err error) {
  defer func() {
    PanicToError(recover(), &err)
  }()
  return nil
}

(See tests.)

func UnwrapErrors ¶

func UnwrapErrors(err error) []error

UnwrapErrors returns the result of calling the Unwrap method on 'err', if err's type contains an Unwrap method returning []error. Otherwise or if the Unwrap method returns error, UnwrapErrors returns nil.