2021-10-12 17:47:33 +00:00
|
|
|
# multierr [![GoDoc][doc-img]][doc] [![Build Status][ci-img]][ci] [![Coverage Status][cov-img]][cov]
|
|
|
|
|
|
|
|
|
|
`multierr` allows combining one or more Go `error`s together.
|
|
|
|
|
|
2023-10-15 09:51:11 +00:00
|
|
|
## 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.
|
|
|
|
|
- **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` and `errors.As` functions *just work*.
|
|
|
|
|
- **Lightweight**:
|
|
|
|
|
multierr comes with virtually no dependencies.
|
|
|
|
|
|
2021-10-12 17:47:33 +00:00
|
|
|
## Installation
|
|
|
|
|
|
2023-10-15 09:51:11 +00:00
|
|
|
```bash
|
|
|
|
|
go get -u go.uber.org/multierr@latest
|
|
|
|
|
```
|
2021-10-12 17:47:33 +00:00
|
|
|
|
|
|
|
|
## Status
|
|
|
|
|
|
|
|
|
|
Stable: No breaking changes will be made before 2.0.
|
|
|
|
|
|
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
Released under the [MIT License].
|
|
|
|
|
|
|
|
|
|
[MIT License]: LICENSE.txt
|
2023-10-15 09:51:11 +00:00
|
|
|
[doc-img]: https://pkg.go.dev/badge/go.uber.org/multierr
|
|
|
|
|
[doc]: https://pkg.go.dev/go.uber.org/multierr
|
|
|
|
|
[ci-img]: https://github.com/uber-go/multierr/actions/workflows/go.yml/badge.svg
|
2021-10-12 17:47:33 +00:00
|
|
|
[cov-img]: https://codecov.io/gh/uber-go/multierr/branch/master/graph/badge.svg
|
2023-10-15 09:51:11 +00:00
|
|
|
[ci]: https://github.com/uber-go/multierr/actions/workflows/go.yml
|
2021-10-12 17:47:33 +00:00
|
|
|
[cov]: https://codecov.io/gh/uber-go/multierr
|
