An HTTP client that is ready for production in Go for a lot of useful features while only using the standard library of the language.
To use the library for HTTP calls, you must first import the corresponding HTTP package:
go get github.com/cploutarchou/go-requests import requests "github.com/cploutarchou/go-requests"- Create a new client with the default configuration
builder := requests.NewBuilder()
client := builder.Build()- Create a new client with a custom configuration
builder := requests.NewBuilder()
builder.Headers().
SetContentType("application/json").
SetAccept("application/json").
SetUserAgent("go-requests")
builder.SetRequestTimeout(10 * time.Second).
SetResponseTimeout(10 * time.Second).
SetMaxIdleConnections(10)
client := builder.Build()- Create a new client with our own http.Client
customClient := &http.Client{
Timeout: 10 * time.Second,
Transport: &http.Transport{
MaxIdleConnsPerHost: 10,
ResponseHeaderTimeout: 10 * time.Second,
DialContext: (&net.Dialer{
Timeout: 10 * time.Second,
}).DialContext,
},
}
builder := requests.NewBuilder()
builder.Headers().
SetContentType("application/json").
SetAccept("application/json").SetUserAgent("go-requests")
builder.SetHTTPClient(customClient)
client := builder.Build() type PetTag struct {
PhotoUrls []string `json:"photoUrls"`
Name string `json:"name"`
ID int64 `json:"id"`
Category struct {
Name string `json:"name"`
ID int64 `json:"id"`
} `json:"category"`
Tags []struct {
Name string `json:"name"`
ID int64 `json:"id"`
} `json:"tags"`
Status string `json:"status"`
}
type PetsTags []PetTag
tags := "dogs,cats"
client.QueryParams().Set("tags", tags)
resp, err := jsonContentClient.Get("https://request-url.com/pet/findByTags")
if err != nil {
fmt.Println(err)
}
var pets PetsTags
// Unmarshal the response body into the struct we support the JSON, XML, YAML,Text formats
err = resp.Unmarshal(&pets)
if err != nil {
fmt.Println(err)
}
fmt.Println(string(pets))For more examples, see the examples directory.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.
