README
¶
go-http-client
An enhanced http client for Golang
This package provides you a http client package for your http requests. You can send requests quicly with this package. If you want to contribute this package, please fork and create a pull request.
Installation
$ go get -u github.com/bozd4g/go-http-client/
Usage
import (
"encoding/json"
"fmt"
client "github.com/bozd4g/go-http-client"
)
type Todo struct {
Id int
UserId int
Title string
Completed bool
}
func main() {
httpClient := client.New("https://jsonplaceholder.typicode.com/")
request, err := httpClient.Get("posts/10")
if err != nil {
panic(err)
}
response, err := httpClient.Do(request)
if err != nil {
panic(err)
}
var todo Todo
err = json.Unmarshal(response.Get().Body, &todo)
if err != nil {
panic(err)
}
fmt.Println(todo.Title) // Lorem ipsum dolor sit amet
// or
var todo2 Todo
response, err = httpClient.Do(request)
if err == nil {
response.To(&todo2)
fmt.Println(todo2.Title) // Lorem ipsum dolor sit amet
} else {
fmt.Println(err.Error())
}
}
Functions
You can call these functions from your application.
| Function | Has Params |
|---|---|
| Get(endpoint string) | - |
| GetWith(endpoint string, params interface {}) | Yes |
| Post(endpoint string) | - |
| PostWith(endpoint string, params interface {}) | Yes |
| Patch(endpoint string) | - |
| PatchWith(endpoint string, params interface{}) | Yes |
| Put(endpoint string) | - |
| PutWith(endpoint string, params interface{}) | Yes |
| Delete(endpoint string) | - |
| DeleteWith(endpoint string, params interface{}) | Yes |
| Do() (Response, error) | - |
| To(value interface{}) | - |
License
Copyright (c) 2020 Furkan Bozdag
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Client ¶
type Client interface {
Get(endpoint string) (*http.Request, error)
GetWith(endpoint string, params interface{}) (*http.Request, error)
Post(endpoint string) (*http.Request, error)
PostWith(endpoint string, params interface{}) (*http.Request, error)
Put(endpoint string) (*http.Request, error)
PutWith(endpoint string, params interface{}) (*http.Request, error)
Patch(endpoint string) (*http.Request, error)
PatchWith(endpoint string, params interface{}) (*http.Request, error)
Delete(endpoint string) (*http.Request, error)
DeleteWith(endpoint string, params interface{}) (*http.Request, error)
Do(ctx context.Context, request *http.Request) (Response, error)
}
Client is a interface who calls the methods
type Response ¶
type Response interface {
Get() ResponseStruct
To(value interface{})
}
Response is an interface of ResponseStruct struct
type ResponseStruct ¶
type ResponseStruct struct {
Status string
StatusCode int
Header http.Header
ContentLength int64
Body []byte
}
ResponseStruct is a struct who returns after requests
func (ResponseStruct) Get ¶
func (r ResponseStruct) Get() ResponseStruct
Get func returns ResponseStruct struct of request
func (ResponseStruct) To ¶
func (r ResponseStruct) To(value interface{})
To func returns converts string to struct
Source Files