README
¶
HTTP Client
Universal HTTP client with method chaining for building requests.
Features
- Method chaining
- Multipart/form-data support
- Header management
- Thread-safe operations
- Buffer pooling
Usage
client, err := httpclient.NewClient(&http.Client{}, "https://api.example.com")
if err != nil {
panic(err)
}
resp, err := client.MethodPost(context.Background(), "/endpoint").
Header("Authorization", "Bearer token").
JSONBody(map[string]string{"key": "value"}).
Send()
API
Client:
NewClient(httpClient *http.Client, baseURL string) (*Client, error)MethodGet/Post/Put/Patch/Delete(ctx context.Context, path string) *Request
Request:
Header(key, value string) *RequestQueryParam(key, value string) *RequestJSONBody(body any) *RequestFile(fieldName, filename string, content io.Reader) *RequestFormField(fieldName, value string) *RequestSend() (*http.Response, error)
Documentation
¶
Index ¶
- Constants
- type Client
- func (c *Client) MultipartPOST(ctx context.Context, path string) *Multipart
- func (c *Client) NewMultipartRequest(ctx context.Context, method, path string) *Multipart
- func (c *Client) NewRequest(ctx context.Context, method, path string) *Request
- func (c *Client) RequestDELETE(ctx context.Context, path string) *Request
- func (c *Client) RequestGET(ctx context.Context, path string) *Request
- func (c *Client) RequestPATCH(ctx context.Context, path string) *Request
- func (c *Client) RequestPOST(ctx context.Context, path string) *Request
- func (c *Client) RequestPUT(ctx context.Context, path string) *Request
- type Multipart
- func (r *Multipart) ContentType(contentType string) *Multipart
- func (r *Multipart) File(fieldName, filename string, content io.Reader) *Multipart
- func (r *Multipart) FormField(fieldName, value string) *Multipart
- func (r *Multipart) GetRequest() (*Multipart, error)
- func (r *Multipart) Header(key, value string) *Multipart
- func (r *Multipart) Headers(headers map[string]string) *Multipart
- func (r *Multipart) Send() (*http.Response, error)
- type Request
- func (r *Request) Body(body io.ReadCloser) *Request
- func (r *Request) BytesBody(body []byte) *Request
- func (r *Request) ContentType(contentType string) *Request
- func (r *Request) GetRequest() (*Request, error)
- func (r *Request) Header(key, value string) *Request
- func (r *Request) Headers(headers map[string]string) *Request
- func (r *Request) JSONBody(body any) *Request
- func (r *Request) QueryParam(key, value string) *Request
- func (r *Request) QueryParams(params map[string]string) *Request
- func (r *Request) QueryValues(values url.Values) *Request
- func (r *Request) Send() (*http.Response, error)
- func (r *Request) StringBody(body string) *Request
Constants ¶
View Source
const ( ApplicationJSON = "application/json" ContentType = "Content-Type" ContentLength = "Content-Length" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
func (*Client) MultipartPOST ¶ added in v1.2.0
func (*Client) NewMultipartRequest ¶ added in v1.2.0
func (*Client) NewRequest ¶ added in v1.2.0
func (*Client) RequestDELETE ¶ added in v1.2.0
func (*Client) RequestGET ¶ added in v1.2.0
func (*Client) RequestPATCH ¶ added in v1.2.0
func (*Client) RequestPOST ¶ added in v1.2.0
type Multipart ¶ added in v1.1.0
type Multipart struct {
*Client
// contains filtered or unexported fields
}
func (*Multipart) ContentType ¶ added in v1.1.0
func (*Multipart) GetRequest ¶ added in v1.1.0
type Request ¶
type Request struct {
*Client
// contains filtered or unexported fields
}
func (*Request) ContentType ¶
func (*Request) GetRequest ¶ added in v0.0.4
func (*Request) QueryParam ¶
func (*Request) StringBody ¶
Source Files
Click to show internal directories.
Click to hide internal directories.