Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/uber-go/multierr
Combine one or more Go errors together
https://github.com/uber-go/multierr
errors go golang
Last synced: about 11 hours ago
JSON representation
Combine one or more Go errors together
- Host: GitHub
- URL: https://github.com/uber-go/multierr
- Owner: uber-go
- License: mit
- Created: 2017-03-15T12:25:43.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-04-29T19:14:36.000Z (9 months ago)
- Last Synced: 2024-10-29T11:10:00.432Z (2 months ago)
- Topics: errors, go, golang
- Language: Go
- Homepage: https://go.uber.org/multierr
- Size: 86.9 KB
- Stars: 1,030
- Watchers: 21
- Forks: 41
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- my-awesome - uber-go/multierr - 04 star:1.1k fork:0.0k Combine one or more Go errors together (Go)
- trackawesomelist - multierr (⭐994) - Package for representing a list of errors as a single error. (Recently Updated / [Sep 04, 2024](/content/2024/09/04/README.md))
- awesome-go - multierr - Package for representing a list of errors as a single error. Stars:`1.1K`. (Error Handling / Search and Analytic Databases)
README
# 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.
## 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.
## Installation
```bash
go get -u go.uber.org/multierr@latest
```
## Status
Stable: No breaking changes will be made before 2.0.
-------------------------------------------------------------------------------
Released under the [MIT License].
[MIT License]: LICENSE.txt
[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
[cov-img]: https://codecov.io/gh/uber-go/multierr/branch/master/graph/badge.svg
[ci]: https://github.com/uber-go/multierr/actions/workflows/go.yml
[cov]: https://codecov.io/gh/uber-go/multierr