Skip to content

TheDSCPL/minimal-errors

Repository files navigation

Minimal Go errors

This package is a drop-in replacement for the standard library's errors package.

It then the functionalities from the github.com/pkg/errors package that are missing from the standard library. The difference from this package to github.com/pkg/errors is that this package does not automatically add a stack trace to the error, but the user can add one by calling errors.WithStack() and passing in another error.

Creating the stacktrace is a costly operation, so it is not done by default. This package is meant to be used in situations where the stacktrace is not needed, or where the stacktrace is added manually.

All the functions in this package that are the same as the standard library's errors package are actually just vars that are set to the same value as the standard library's errors package. This means that this package can be used as a drop-in replacement for the standard library's errors package and has minimal implementation and stable API.

Usage

package main

import "github.com/TheDSCPL/minimal-errors"

func main() {
    err := errors.New("this is an error")
    err = errors.WithStack(err)
}

About

Proxy to std's errors package with extra functionality

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages