httpc

Documentation

Index

• Variables
• func Do(ctx context.Context, method, url string, data any) (*http.Response, error)
• func DoRequest(r *http.Request) (*http.Response, error)
• func Parse(resp *http.Response, val any) error
• func ParseHeaders(resp *http.Response, val any) error
• func ParseJsonBody(resp *http.Response, val any) error
• type Option
• type Service
  • func NewService(name string, opts ...Option) Service
  • func NewServiceWithClient(name string, cli *http.Client, opts ...Option) Service

Variables

var ErrGetWithBody = errors.New("HTTP GET should not have body")

ErrGetWithBody indicates that GET request with body.

Functions

func Do

func Do(ctx context.Context, method, url string, data any) (*http.Response, error)

Do sends an HTTP request with the given arguments and returns an HTTP response. data is automatically marshal into a *httpRequest, typically it's defined in an API file.

func DoRequest

func DoRequest(r *http.Request) (*http.Response, error)

DoRequest sends an HTTP request and returns an HTTP response.

func Parse

func Parse(resp *http.Response, val any) error

Parse parses the response.

func ParseHeaders

func ParseHeaders(resp *http.Response, val any) error

ParseHeaders parses the response headers.

func ParseJsonBody

func ParseJsonBody(resp *http.Response, val any) error

ParseJsonBody parses the response body, which should be in json content type.

Types

type Option

type Option func(r *http.Request) *http.Request

Option is used to customize the *http.Client.

type Service

type Service interface {
	// Do sends an HTTP request with the given arguments and returns an HTTP response.
	Do(ctx context.Context, method, url string, data any) (*http.Response, error)
	// DoRequest sends a HTTP request to the service.
	DoRequest(r *http.Request) (*http.Response, error)
}

Service represents a remote HTTP service.

func NewService

func NewService(name string, opts ...Option) Service

NewService returns a remote service with the given name. opts are used to customize the *http.Client.

func NewServiceWithClient

func NewServiceWithClient(name string, cli *http.Client, opts ...Option) Service

NewServiceWithClient returns a remote service with the given name. opts are used to customize the *http.Client.