Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cploutarchou/go-requests
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.
https://github.com/cploutarchou/go-requests
client-library go golang golang-library golang-package http http-client http-requests rest-api
Last synced: 13 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/cploutarchou/go-requests
- Owner: cploutarchou
- License: mit
- Created: 2022-10-13T20:01:36.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-01-13T13:45:20.000Z (almost 2 years ago)
- Last Synced: 2024-06-20T03:42:15.234Z (5 months ago)
- Topics: client-library, go, golang, golang-library, golang-package, http, http-client, http-requests, rest-api
- Language: Go
- Homepage:
- Size: 3.59 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# go-requests an HTTP client for Go
_________
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.
## Installation
To use the library for HTTP calls, you must first import the corresponding HTTP package:
```bash
go get github.com/cploutarchou/go-requests
```
## Usage
________________________
### Import the package :
```go
import requests "github.com/cploutarchou/go-requests"
```
### Client
1. Create a new client with the default configuration
```go
builder := requests.NewBuilder()
client := builder.Build()
```
2. Create a new client with a custom configuration
```go
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()
```
3. Create a new client with our own http.Client
```go
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()
```
____________________
### Requests
#### GET
```go
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](https://github.com/cploutarchou/go-requests/tree/master/examples) directory.
## Contributing
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.
## License
[MIT](https://github.com/cploutarchou/go-requests/blob/master/LICENSE)
### 💰 You can help me by Donating
[](https://www.buymeacoffee.com/cploutarchou) [](https://paypal.me/cploutarchou) [](https://ko-fi.com/cploutarchou)
### Thanks for your support! 🙏