go-cleanhttp
Provides clean, isolated HTTP clients in Go that avoid shared state issues with the standard library's default client.
What is go-cleanhttp?
cleanhttp is a Go library that provides functions to obtain "clean" HTTP client instances. It solves the problem of shared state and race conditions that occur when multiple libraries or goroutines modify the global `http.DefaultClient` or its default transport.
Go developers building applications or libraries that make HTTP requests and need to avoid interference from dependencies that might modify shared HTTP client state.
Developers choose cleanhttp because it offers a simple, reliable way to get isolated HTTP clients with standard defaults, preventing subtle bugs and race conditions without requiring manual client configuration or reinventing the wheel.
Overview
cleanhttp offers simple functions to obtain "clean" http.Client instances in Go. These clients use the same default configurations as the standard library but are isolated, preventing the race conditions and strange bugs that can arise from libraries modifying shared global clients like http.DefaultClient.
Key Features
- Isolated Clients — Returns HTTP clients that do not share any state with other clients, eliminating interference between libraries.
- Standard Defaults — Uses the same default transport and timeouts as Go's
http.DefaultClient, ensuring familiar behavior. - Simple API — Provides straightforward functions like
cleanhttp.DefaultClient()to get a clean client without manual configuration. - Concurrency Safe — Clients are safe for concurrent use by multiple goroutines, adhering to Go's best practices.
Philosophy
cleanhttp follows the Go philosophy of simplicity and explicitness, providing minimal, focused utilities that solve a specific, common pain point in Go HTTP client usage.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
