README
¶
errors
Replacement for golang errors package.
Benchmarks
Take all benchmarks with a bucket of salt.
go test -bench=. -benchmem -count=1 -parallel 8 ./...
goos: linux
goarch: amd64
pkg: github.com/wspowell/errors
cpu: AMD Ryzen 9 4900HS with Radeon Graphics
BenchmarkErrorsNew-8 301735152 3.890 ns/op 0 B/op 0 allocs/op
BenchmarkErrorsWithStackTrace-8 1283198 929.4 ns/op 284 B/op 3 allocs/op
BenchmarkErrorsNewFmt-8 16286179 69.42 ns/op 4 B/op 1 allocs/op
BenchmarkGoerrorsNew-8 46670034 25.19 ns/op 16 B/op 1 allocs/op
BenchmarkGoerrorsWrap-8 6644190 169.2 ns/op 36 B/op 2 allocs/op
BenchmarkErrorString-8 1000000000 0.7221 ns/op 0 B/op 0 allocs/op
BenchmarkErrorStringWithStackTrace-8 416150 3012 ns/op 400 B/op 9 allocs/op
PASS
ok github.com/wspowell/errors 11.682s
goos: linux
goarch: amd64
pkg: github.com/wspowell/errors/result
cpu: AMD Ryzen 9 4900HS with Radeon Graphics
BenchmarkResultOkInt-8 328060 3646 ns/op 0 B/op 0 allocs/op
BenchmarkResultErrInt-8 326503 3643 ns/op 0 B/op 0 allocs/op
BenchmarkGoerrorOkInt-8 244785 4864 ns/op 0 B/op 0 allocs/op
BenchmarkGoerrorErrInt-8 501597 2488 ns/op 0 B/op 0 allocs/op
PASS
ok github.com/wspowell/errors/result 4.987s
Documentation
¶
Overview ¶
Copied (and modified) from: github.com/pkg/errors@v0.9.1/stack.go
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type Error ¶ added in v0.4.0
type Error[T ~string] struct { // contains filtered or unexported fields }
Error is an instance of a sentinel error. If the error was created via New() then the error is considered and inline error and is not comparable with another Error.
Error should not be used with "==". Instead, use Error.As().
func Catch ¶ added in v0.2.0
Catch potential panics that occur in a function call. Panics should never occur, therefore stack traces print regardless of build mode (release or debug).
func New ¶
New error instance.
This should be called when the application creates a new error. This new Error is not (intended to be) comparable with other Errors and therefore cannot be used as a sentinel error. A Sentinel may be used and compared using Error.Sentinel(). A context is accepted in order to pass through API level feature flags.
func (Error[T]) Into ¶ added in v0.5.1
func (self Error[T]) Into() T
Into the sentinel type for the error.
This allows Error to be used in a switch in conjunction with linter "exhaustive".
For example:
type myError errors.Sentinel
const (
errOne = myError("one")
errTwo = myError("two")
errThree = myError("three")
)
func multipleErrors(ctx context.Context, err int) errors.Error {
switch err {
case 1:
return errors.New(ctx, errOne)
case 2:
return errors.New(ctx, errTwo)
case 3:
return errors.New(ctx, errThree)
default:
return errors.ErrNone
}
}
func TestSentinelEnum(t *testing.T) {
t.Parallel()
err := multipleErrors(context.Background(), 1)
//nolint:exhaustive // reason: expected lint error for testing
switch err.Into() {
case errOne:
// Expected case.
default:
assert.Fail(t, "expected errOne")
}
}
Source Files
Directories