Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elliotxx/errors
An errors package for web development in Golang.
https://github.com/elliotxx/errors
errors go golang webapp
Last synced: 15 days ago
JSON representation
An errors package for web development in Golang.
- Host: GitHub
- URL: https://github.com/elliotxx/errors
- Owner: elliotxx
- License: mit
- Created: 2022-09-08T13:48:52.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-07-26T09:37:32.000Z (over 1 year ago)
- Last Synced: 2024-11-06T03:47:05.528Z (2 months ago)
- Topics: errors, go, golang, webapp
- Language: Go
- Homepage: https://pkg.go.dev/github.com/elliotxx/errors
- Size: 531 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-zh.md
- License: LICENSE
Awesome Lists containing this project
README
一个适应于 Web 开发的 Golang 错误包
`elliotxx/errors` 是一个适应于 Web 开发的 Golang 错误包，启发于 [pkg/errors](https://github.com/pkg/errors)!
## 📜 语言
[English](https://github.com/elliotxx/errors/blob/master/README.md) | [简体中文](https://github.com/elliotxx/errors/blob/master/README-zh.md)
## ⚡ 使用
```
go get -u github.com/elliotxx/errors
```
## ✨ 特性
* 更详细的错误信息，比如错误码、错误信息、错误原因、错误堆栈等
* 更强大的 API
* 轻量级
## 📚 样例
样例 1:
```go
package errcodes
import "github.com/elliotxx/errors"
var (
Success = errors.NewErrorCode("00000", "success")
NotFound = errors.NewErrorCode("A0100", "not found")
AccessPermissionError = errors.NewErrorCode("A0200", "abnormal access permission")
AbnormalUserOperation = errors.NewErrorCode("A0300", "abnormal user operation")
InvalidParams = errors.NewErrorCode("A0400", "invalid params")
BlankRequiredParams = errors.NewErrorCode("A0401", "required parameter is blank")
MalformedParams = errors.NewErrorCode("A0403", "parameter format mismatch")
ServerError = errors.NewErrorCode("A0500", "server error")
TooManyRequests = errors.NewErrorCode("A0501", "too many requests")
ConcurrentExceedLimit = errors.NewErrorCode("A0502", "the request parallel number exceeds the limit")
WaitUserOperation = errors.NewErrorCode("A0503", "please wait for user operation")
RepeatedRequest = errors.NewErrorCode("A0504", "repeated request")
)
```
样例 2:
```go
detailErr := New("name is empty")
// detailErr.Error() returns "cause [name is empty]"
ErrBlankParameter := NewErrorCode("A0401", "required parameter is blank")
// ErrBlankParameter.Error() returns "code [A0401], msg [required parameter is blank]"
detailErr = NewDetailError("A0401", "required parameter is blank", fmt.Errorf("name is empty"))
// detailErr.Error() returns "code [A0401], msg [required parameter is blank], cause [name is empty]"
detailErr = Errorf("%s is not exist", "John")
// detailErr.Error() returns "cause [John is not exist]"
detailErr = Code("A0401").Msg("required parameter is blank").Cause(fmt.Errorf("name is empty"))
// detailErr.Error() returns "code [A0401], msg [required parameter is blank], cause [name is empty]"
detailErr = Code("A0401").Msg("required parameter is blank")
// detailErr.Error() returns "code [A0401], msg [required parameter is blank]"
detailErr = Code("A0401").Cause(fmt.Errorf("name is empty"))
// detailErr.Error() returns "code [A0401], cause [name is empty]"
detailErr = Code("A0401").Causef("name is empty")
// detailErr.Error() returns "code [A0401], cause [name is empty]"
detailErr = Code("A0401").Causef("%s is empty", "name")
// detailErr.Error() returns "code [A0401], cause [name is empty]"
rootCause := fmt.Errorf("name is empty")
detailErr = Code("A0401").Causewf(rootCause, "failed to validate parameter")
// detailErr.Error() returns "code [A0401], cause [failed to validate parameter: name is empty]"
detailErr = Msg("required parameter is blank")
// detailErr.Error() returns "msg [required parameter is blank]"
detailErr = ErrBlankParameter.Cause(fmt.Errorf("name is empty"))
// detailErr.Error() returns "code [A0401], msg [required parameter is blank], cause [name is empty]"
```