httpclient

README

httpclient

Customised http client for Go

Documentation

Index

• Constants
• func NewConnectionRefusedError(code int, err error) error
• func NewHttpError(code int, err error) error
• func NewServiceUnreachableError(code int, message string) error
• type BreakError
  • func (be BreakError) Error() string
• type Client
• type ConnectionRefusedError
  • func (e *ConnectionRefusedError) Code() int
  • func (e *ConnectionRefusedError) Error() string
  • func (e *ConnectionRefusedError) Is(tgt error) bool
• type HttpClient
  • func New() *HttpClient
  • func (c *HttpClient) Get(url string, args map[string]any, headers map[string]string) ([]byte, map[string]string, int, error)
  • func (c *HttpClient) Post(url string, args map[string]any, headers map[string]string) ([]byte, map[string]string, int, error)
  • func (c *HttpClient) SkipTlsVerify() *HttpClient
  • func (c *HttpClient) WithBasicAuth(login, password string) *HttpClient
  • func (c *HttpClient) WithBearerAuth(token string) *HttpClient
  • func (c *HttpClient) WithBreaker(failureThreshold uint, initial, max time.Duration) *HttpClient
  • func (c *HttpClient) WithNoAuth() *HttpClient
  • func (c *HttpClient) WithRetry(retries uint, delay time.Duration) *HttpClient
  • func (c *HttpClient) WithTimeout(timeout time.Duration) *HttpClient
• type HttpError
  • func (e *HttpError) Code() int
  • func (e *HttpError) Error() string
  • func (e *HttpError) Is(tgt error) bool
• type ServiceCall
• type ServiceUnreachableError
  • func (e *ServiceUnreachableError) Code() int
  • func (e *ServiceUnreachableError) Error() string
  • func (e *ServiceUnreachableError) Is(tgt error) bool

Constants

const (
	HttpClientUnknownError            = int(httpClientUnknownError)
	HttpClientMarshallingError        = int(httpClientMarshallingError)
	HttpClientServiceUnavailableError = int(httpClientServiceUnavailableError)
	HttpClientConnectionRefusedError  = int(httpClientConnectionRefusedError)
	HttpClientRetriesExhaustedError   = int(httpClientRetriesExhaustedError)
	HttpClientHoSuchHostError         = int(httpClientHoSuchHostError)
)

Functions

func NewConnectionRefusedError

func NewConnectionRefusedError(code int, err error) error

func NewHttpError

func NewHttpError(code int, err error) error

func NewServiceUnreachableError

func NewServiceUnreachableError(code int, message string) error

Types

type BreakError

type BreakError struct {
	Wait time.Duration
	Err  error
}

func (BreakError) Error

func (be BreakError) Error() string

type Client

type Client interface {
	Post(url string, data map[string]any, headers map[string]string) ([]byte, map[string]string, int, error)
	Get(url string, args map[string]any, headers map[string]string) ([]byte, map[string]string, int, error)
}

type ConnectionRefusedError

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

func (*ConnectionRefusedError) Code

func (e *ConnectionRefusedError) Code() int

func (*ConnectionRefusedError) Error

func (e *ConnectionRefusedError) Error() string

func (*ConnectionRefusedError) Is

func (e *ConnectionRefusedError) Is(tgt error) bool

type HttpClient

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

func New

func New() *HttpClient

func (*HttpClient) Get

func (c *HttpClient) Get(url string, args map[string]any, headers map[string]string) ([]byte, map[string]string, int, error)

func (*HttpClient) Post

func (c *HttpClient) Post(url string, args map[string]any, headers map[string]string) ([]byte, map[string]string, int, error)

func (*HttpClient) SkipTlsVerify

func (c *HttpClient) SkipTlsVerify() *HttpClient

func (*HttpClient) WithBasicAuth

func (c *HttpClient) WithBasicAuth(login, password string) *HttpClient

func (*HttpClient) WithBearerAuth

func (c *HttpClient) WithBearerAuth(token string) *HttpClient

func (*HttpClient) WithBreaker

func (c *HttpClient) WithBreaker(failureThreshold uint, initial, max time.Duration) *HttpClient

func (*HttpClient) WithNoAuth

func (c *HttpClient) WithNoAuth() *HttpClient

func (*HttpClient) WithRetry

func (c *HttpClient) WithRetry(retries uint, delay time.Duration) *HttpClient

func (*HttpClient) WithTimeout

func (c *HttpClient) WithTimeout(timeout time.Duration) *HttpClient

type HttpError

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

func (*HttpError) Code

func (e *HttpError) Code() int

func (*HttpError) Error

func (e *HttpError) Error() string

func (*HttpError) Is

func (e *HttpError) Is(tgt error) bool

type ServiceCall

type ServiceCall func(
	client *http.Client, ctx context.Context, url string,
	args map[string]any, headers map[string]string) ([]byte, map[string]string, int, error)

type ServiceUnreachableError

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

func (*ServiceUnreachableError) Code

func (e *ServiceUnreachableError) Code() int

func (*ServiceUnreachableError) Error

func (e *ServiceUnreachableError) Error() string

func (*ServiceUnreachableError) Is

func (e *ServiceUnreachableError) Is(tgt error) bool