1
0
mirror of https://github.com/go-gitea/gitea.git synced 2024-12-21 13:42:36 +08:00
gitea/vendor/github.com/hashicorp/go-cleanhttp
6543 fe628d8406
Vendor Update ()
* github.com/yuin/goldmark v1.3.1 -> v1.3.2

* github.com/xanzy/go-gitlab v0.42.0 -> v0.44.0

* github.com/prometheus/client_golang v1.8.0 -> v1.9.0

* github.com/minio/minio-go v7.0.7 -> v7.0.9

* github.com/lafriks/xormstore v1.3.2 -> v1.4.0

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
2021-02-16 22:47:24 -05:00
..
cleanhttp.go Vendor Update () 2021-02-16 22:47:24 -05:00
doc.go Vendor Update: go-gitlab v0.22.1 -> v0.31.0 () 2020-04-19 21:23:05 +01:00
go.mod Vendor Update () 2021-02-16 22:47:24 -05:00
handlers.go Vendor Update: go-gitlab v0.22.1 -> v0.31.0 () 2020-04-19 21:23:05 +01:00
LICENSE Vendor Update: go-gitlab v0.22.1 -> v0.31.0 () 2020-04-19 21:23:05 +01:00
README.md Vendor Update: go-gitlab v0.22.1 -> v0.31.0 () 2020-04-19 21:23:05 +01:00

cleanhttp

Functions for accessing "clean" Go http.Client values


The Go standard library contains a default http.Client called http.DefaultClient. It is a common idiom in Go code to start with http.DefaultClient and tweak it as necessary, and in fact, this is encouraged; from the http package documentation:

The Client's Transport typically has internal state (cached TCP connections), so Clients should be reused instead of created as needed. Clients are safe for concurrent use by multiple goroutines.

Unfortunately, this is a shared value, and it is not uncommon for libraries to assume that they are free to modify it at will. With enough dependencies, it can be very easy to encounter strange problems and race conditions due to manipulation of this shared value across libraries and goroutines (clients are safe for concurrent use, but writing values to the client struct itself is not protected).

Making things worse is the fact that a bare http.Client will use a default http.Transport called http.DefaultTransport, which is another global value that behaves the same way. So it is not simply enough to replace http.DefaultClient with &http.Client{}.

This repository provides some simple functions to get a "clean" http.Client -- one that uses the same default values as the Go standard library, but returns a client that does not share any state with other clients.