📚 multierr - Awesome Go Library for Error Handling
Package for representing a list of errors as a single error.
🏷️ Error Handling
📂 Libraries for handling errors.
⭐ 1,021 stars
Detailed Description of multierr
multierr
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.