|
||
---|---|---|
.. | ||
.codecov.yml | ||
.gitignore | ||
CHANGELOG.md | ||
LICENSE.txt | ||
Makefile | ||
README.md | ||
error.go | ||
error_post_go120.go | ||
error_pre_go120.go |
README.md
multierr
![Coverage Status](https://codecov.io/gh/uber-go/multierr/branch/master/graph/badge.svg)
multierr
allows combining one or more Go error
s together.
Features
- Idiomatic:
multierr follows best practices in Go, and keeps your code idiomatic.
- It keeps the underlying error type hidden,
allowing you to deal in
error
values exclusively. - It provides APIs to safely append into an error from a
defer
statement.
- It keeps the underlying error type hidden,
allowing you to deal in
- Performant:
multierr is optimized for performance:
- It avoids allocations where possible.
- It utilizes slice resizing semantics to optimize common cases like appending into the same error object from a loop.
- Interoperable:
multierr interoperates with the Go standard library's error APIs seamlessly:
- The
errors.Is
anderrors.As
functions just work.
- The
- Lightweight: multierr comes with virtually no dependencies.
Installation
go get -u go.uber.org/multierr@latest
Status
Stable: No breaking changes will be made before 2.0.
Released under the MIT License.