BuilderHttpClient

README

BuilderHttpClient

BuilderHttpClient is a Go package that provides a simple and flexible HTTP client builder for making HTTP requests. It allows you to easily construct and customize HTTP requests using a fluent interface.

Installation

To use BuilderHttpClient in your Go project, you can simply run the following command:

go get github.com/catnovelapi/BuilderHttpClient

Usage

Import the package in your Go file:

import "github.com/catnovelapi/BuilderHttpClient"

Making GET Requests

To make a GET request, you can use the Get function:

response := BuilderHttpClient.Get(url, options...)

Here, url is the URL of the endpoint you want to send the GET request to, and options is an optional list of request options.

Making POST Requests

To make a POST request, you can use the Post function:

response := BuilderHttpClient.Post(url, options...)

Here, url is the URL of the endpoint you want to send the POST request to, and options is an optional list of request options.

Making PUT Requests

To make a PUT request, you can use the Put function:

response := BuilderHttpClient.Put(url, options...)

Here, url is the URL of the endpoint you want to send the PUT request to, and options is an optional list of request options.

Making DELETE Requests

To make a DELETE request, you can use the Delete function:

response := BuilderHttpClient.Delete(url, options...)

Here, url is the URL of the endpoint you want to send the DELETE request to, and options is an optional list of request options.

Making PATCH Requests

To make a PATCH request, you can use the Patch function:

response := BuilderHttpClient.Patch(url, options...)

Here, url is the URL of the endpoint you want to send the PATCH request to, and options is an optional list of request options.

Request Options

You can customize the request by providing various options. The available options are:

• Method(method string): Sets the HTTP method for the request.
• ApiPath(URL string): Sets the URL of the API endpoint.
• Header(header map[string]interface{}): Sets the headers for the request.
• Body(dataBody interface{}): Sets the request body data.

Here's an example that demonstrates how to use request options:

options := []BuilderHttpClient.Option{
    BuilderHttpClient.Method("POST"),
    BuilderHttpClient.ApiPath("https://api.example.com/users"),
    BuilderHttpClient.Header(map[string]interface{}{
        "Content-Type": "application/json",
        "Authorization": "Bearer token",
    }),
    BuilderHttpClient.Body(map[string]interface{}{
        "name": "John Doe",
        "email": "john@example.com",
    }),
}

response := BuilderHttpClient.Post(url, options...)

Response Handling

The response from the HTTP request is returned as a ResponseInterfaceBuilder. You can use the following methods to handle the response:

• Code() int: Returns the HTTP status code of the response.
• Status() string: Returns the HTTP status message of the response.
• Json(v interface{}) error: Parses the response body as JSON and stores it in the provided struct or map.
• Text() string: Returns the response body as a string.
• Gjson() gjson.Result: Parses the response body as JSON and returns a gjson.Result object.
• Debug() *ResponseBuilder: Prints debug information about the request and response.
• Cookies() string: Returns the cookies from the response.
• Bytes() []byte: Returns the response body as a byte array. Here's an example that demonstrates how to handle the response:

response := BuilderHttpClient.Get(url, options...)

fmt.Println("Status Code:", response.Code())
fmt.Println("Status:", response.Status())
fmt.Println("Response Body:", response.Text())

var data map[string]interface{}
err := response.Json(&data)
if err != nil {
    fmt.Println("Error parsing JSON:", err)
} else {
    fmt.Println("Parsed JSON:", data)
}

Documentation

Index

• type ClientBuilder
  • func Df(option ...Option) *ClientBuilder
  • func (b *ClientBuilder) Build() ResponseInterfaceBuilder
  • func (b *ClientBuilder) NewCookie(cookie map[string]string) *ClientBuilder
• type Option
  • func ApiPath(URL string) Option
  • func Body(dataBody any) Option
  • func Debug() Option
  • func Header(header map[string]any) Option
  • func Method(method string) Option
• type OptionFunc
• type RequestInterfaceBuilder
• type ResponseBuilder
  • func (c *ResponseBuilder) Byte() []byte
  • func (c *ResponseBuilder) Code() int
  • func (c *ResponseBuilder) Cookie() string
  • func (c *ResponseBuilder) Debug() *ResponseBuilder
  • func (c *ResponseBuilder) Gjson() gjson.Result
  • func (c *ResponseBuilder) Json(v any) error
  • func (c *ResponseBuilder) Status() string
  • func (c *ResponseBuilder) Text() string
• type ResponseInterfaceBuilder
  • func Delete(url string, options ...Option) ResponseInterfaceBuilder
  • func Get(url string, options ...Option) ResponseInterfaceBuilder
  • func Patch(url string, options ...Option) ResponseInterfaceBuilder
  • func Post(url string, options ...Option) ResponseInterfaceBuilder
  • func Put(url string, options ...Option) ResponseInterfaceBuilder

Types

type ClientBuilder

type ClientBuilder struct {
	http.Request
	// contains filtered or unexported fields
}

func Df

func Df(option ...Option) *ClientBuilder

func (*ClientBuilder) Build

func (b *ClientBuilder) Build() ResponseInterfaceBuilder

func (*ClientBuilder) NewCookie

func (b *ClientBuilder) NewCookie(cookie map[string]string) *ClientBuilder

type Option

type Option interface {
	// contains filtered or unexported methods
}

func ApiPath

func ApiPath(URL string) Option

func Body

func Body(dataBody any) Option

func Debug

func Debug() Option

func Header

func Header(header map[string]any) Option

func Method

func Method(method string) Option

type OptionFunc

type OptionFunc func(*ClientBuilder)

type RequestInterfaceBuilder

type RequestInterfaceBuilder interface {
	Build() ResponseInterfaceBuilder
}

type ResponseBuilder

type ResponseBuilder struct {
	// contains filtered or unexported fields
}

func (*ResponseBuilder) Byte

func (c *ResponseBuilder) Byte() []byte

func (*ResponseBuilder) Code

func (c *ResponseBuilder) Code() int

func (*ResponseBuilder) Cookie

func (c *ResponseBuilder) Cookie() string

func (*ResponseBuilder) Debug

func (c *ResponseBuilder) Debug() *ResponseBuilder

func (*ResponseBuilder) Gjson

func (c *ResponseBuilder) Gjson() gjson.Result

func (*ResponseBuilder) Json

func (c *ResponseBuilder) Json(v any) error

func (*ResponseBuilder) Status

func (c *ResponseBuilder) Status() string

func (*ResponseBuilder) Text

func (c *ResponseBuilder) Text() string

type ResponseInterfaceBuilder

type ResponseInterfaceBuilder interface {
	Code() int
	Status() string
	Json(v any) error
	Text() string
	Gjson() gjson.Result
	Debug() *ResponseBuilder
}

func Delete

func Delete(url string, options ...Option) ResponseInterfaceBuilder

func Get

func Get(url string, options ...Option) ResponseInterfaceBuilder

func Patch

func Patch(url string, options ...Option) ResponseInterfaceBuilder

func Post

func Post(url string, options ...Option) ResponseInterfaceBuilder

func Put

func Put(url string, options ...Option) ResponseInterfaceBuilder