Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/talento90/goliath
ðĪš Goliath is an opinionated set of libraries to build resilient, scalable and maintainable applications.
https://github.com/talento90/goliath
Last synced: 2 months ago
JSON representation
ðĪš Goliath is an opinionated set of libraries to build resilient, scalable and maintainable applications.
- Host: GitHub
- URL: https://github.com/talento90/goliath
- Owner: Talento90
- License: mit
- Created: 2024-04-26T08:12:40.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-06-13T23:38:37.000Z (7 months ago)
- Last Synced: 2024-10-05T02:30:52.176Z (3 months ago)
- Language: Go
- Homepage:
- Size: 762 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
[](https://codecov.io/gh/Talento90/goliath)
[](https://goreportcard.com/report/github.com/Talento90/goliath)
[](https://godoc.org/github.com/Talento90/goliath)
# ð Summary
Goliath is an opinionated set of libraries to build resilient, scalable and maintainable applications. The goal of these libraries is to allow focusing on building applications instead of reinventing the wheel.
# ð Features
- [app](/app) - set of common utilities such as elegant errors and enriched `ctx.Context`
- [retry](/retry/) - retry a specific task securely
- [clock](/clock) - wrapper around `time.Now` to help during testing
- [sleep](/sleep) - wrapper around `time.Sleep` for testing
- [httperror](/httperror) - implementation of the [RFC7807 Problem Details](https://datatracker.ietf.org/doc/html/rfc7807)
# ð Examples
### app
```go
// create elegant application errors
err := app.NewErrorValidation("validate_user", "Error Validating User")
err.AddValidationError(NewFieldValidationError("name", "name is empty"))
err.AddValidationError(NewFieldValidationError("age", "user is under 18", "user must be an adult"))
// wrap the inner cause of the error
conn, err := db.Connect(...)
if err != nil {
return app.NewErrorInternal("database_connection", "Error connecting to the database").SetSeverity(app.ErrorSeverityCritical).Wrap(err)
}
// create a raw error
err := app.NewError(("error_code", app.ErrorInternal, app.ErrorSeverityHigh, "Error message"))
// enriched context
func Hello(w http.ResponseWriter, r *http.Request) {
ctx := app.FromContext(r.Context())
traceId := appCtx.TraceID()
userID, checkUser := ctx.UserID()
if checkUser {
//request authorized
}
}
```
### retry
```go
var GetPersonTask = func() (Person, error) {
var p Person
resp, err := http.Get("http://example.com/")
if err != nil {
return p, err
}
err = json.NewDecoder(resp.Body).Decode(&p)
return resp, err
}
config := retry.NewConfig(3)
result, err := retry.Execute(config, task)
```
### clock
```go
clock := NewUtcClock()
timeNowUtc := clock.Now().Format(time.RFC822)
```
### sleep
```go
sleeper := sleep.New()
sleeper.Sleep(1000)
```
### httperror
```go
appCtx := app.FromContext(ctx)
err := app.NewErrorValidation("invalid_payment_data", "The payment request is invalid")
err.AddValidationError(app.NewFieldValidationError("amount", "Amount needs to be positive"))
err.AddValidationError(app.NewFieldValidationError("currency", "currency is required"))
httpErr := New(appCtx, err, "/payments")
```
*Problem Detail Output*
```json
{
"type": "invalid_payment_data",
"title": "The payment request is invalid",
"status": 400,
"instance": "/payments",
"traceId": "9b1b4579-b455-4eed-ac80-923668593dcc",
"errors": {
"amount": ["Amount needs to be positive"],
"currency": ["currency is required"]
}
}
```