terrors
Terrors is a package for wrapping Golang errors. Terrors provides additional context to an error, such as an error code and a stack trace.
Terrors is built and used at Monzo.
Usage
Terrors can be used to wrap any object that satisfies the error interface:
Terrors can be instantiated directly:
"context": "my_context"
})
Terrors offers built-in functions for instantiating Errors with common codes:
"context": my_context
})
Terrors provides functions for matching specific Errors:
fmt.Println(Matches(err, "not_found.handler_missing")) // true
Retryability
Terrors contains the ability to declare whether or not an error is retryable. This property is derived from the error code if not specified explicitly.
When using the the wrapping functionality (e.g. Wrap, Augment, Propagate), the retryability
of an error is preserved as expected. Importantly, it is also preserved when constructing a new error from
a causal error with NewInternalWithCause.
API
Full API documentation can be found on godoc
Install
$ go get -u github.com/monzo/terrors
License
Terrors is licenced under the MIT License