Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ybbus/httpretry
Enriches the standard go http client with retry functionality.
https://github.com/ybbus/httpretry
golang http-client resilience retry
Last synced: about 2 months ago
JSON representation
Enriches the standard go http client with retry functionality.
- Host: GitHub
- URL: https://github.com/ybbus/httpretry
- Owner: ybbus
- License: mit
- Created: 2020-02-05T10:17:42.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-18T06:41:44.000Z (7 months ago)
- Last Synced: 2024-07-31T20:52:37.220Z (4 months ago)
- Topics: golang, http-client, resilience, retry
- Language: Go
- Homepage:
- Size: 55.7 KB
- Stars: 44
- Watchers: 4
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - httpretry - Enriches the default go HTTP client with retry functionality. (Networking / HTTP Clients)
- zero-alloc-awesome-go - httpretry - Enriches the default go HTTP client with retry functionality. (Networking / HTTP Clients)
- awesome-go-extra - httpretry - 02-05T10:17:42Z|2020-02-14T08:20:21Z| (Networking / HTTP Clients)
README
[](https://goreportcard.com/report/github.com/ybbus/httpretry)
[](https://github.com/ybbus/httpretry)
[](https://codecov.io/github/ybbus/httpretry)
[](https://godoc.org/github.com/ybbus/httpretry)
[]()
# httpRetry
Enriches the standard go http client with retry functionality using a wrapper around the Roundtripper interface.
The advantage of this library is that it makes use of the default http.Client.
This means you can provide it to any library that accepts the go standard http.Client.
This in turn gives you the possibility to add resilience to a lot of http based go libraries with just a single line of code.
Of course it can also be used as standalone http client in your own projects.
## Installation
```sh
go get -u github.com/ybbus/httpretry
```
## Quickstart
To get a standard http client with retry functionality:
```golang
client := httpretry.NewDefaultClient()
// use this as usual when working with http.Client
```
This single line of code returns a default http.Client that uses an exponential backoff and sends up to 5 retries if the request was not successful.
Requests will be retried if the error seems to be temporary or the requests returns a status code that may change over time (e.g. GetwayTimeout).
### Modify / customize the Roundtripper (http.Transport)
Since httpretry wraps the actual Roundtripper of the http.Client, you should not try to replace / modify the client.Transport field after creation.
You either configure the http.Client upfront and then "make" it retryable like in this code:
```golang
customHttpClient := &http.Client{}
customHttpClient.Transport = &http.Transport{...}
retryClient := httpretry.NewCustomClient(cumstomHttpClient)
```
or you use one of the available helper functions to gain access to the underlying Roundtripper / http.Transport:
```golang
// replaces the original roundtripper
httpretry.ReplaceOriginalRoundtripper(retryClient, myRoundTripper)
// modifies the embedded http.Transport by providing a function that receives the client.Transport as parameter
httpretry.ModifyOriginalTransport(retryClient, func(t *http.Transport) { t.TLSHandshakeTimeout = 5 * time.Second })
// returns the embedded Roundtripper
httpretry.GetOriginalRoundtripper(retryClient)
// returns the embedded Roundtripper as http.Transport if it is of that type
httpretry.GetOriginalTransport(retryClient)
```
### Customize retry settings
You may provide your own Backoff- and RetryPolicy.
```golang
client := httpretry.NewDefaultClient(
// retry up to 5 times
httpretry.WithMaxRetryCount(5),
// retry on status >= 500, if err != nil, or if response was nil (status == 0)
httpretry.WithRetryPolicy(func(statusCode int, err error) bool {
return err != nil || statusCode >= 500 || statusCode == 0
}),
// every retry should wait one more second
httpretry.WithBackoffPolicy(func(attemptNum int) time.Duration {
return time.Duration(attemptNum+1) * 1 * time.Second
}),
)
```