requests

README

requests

Go requests library.

Documentation

Index

• Variables
• func MarshalHeaders(v any) (data http.Header, err error)
• func MarshalJson(v any) (str string, err error)
• func MarshalQuery(v any) (s string, err error)
• func UnmarshalHeaders(data http.Header, v any) (err error)
• type Builder
  • func (rb *Builder) Body(body []byte) *Builder
  • func (rb *Builder) BodyForm(object any) *Builder
  • func (rb *Builder) BodyJson(object any) *Builder
  • func (rb *Builder) BodyReader(reader io.Reader) *Builder
  • func (rb *Builder) Build() *Request
  • func (rb *Builder) BuildURL() (u *url.URL)
  • func (rb *Builder) Header(object any) *Builder
  • func (rb *Builder) HeaderAdd(key string, value string) *Builder
  • func (rb *Builder) HeaderUpdate(header http.Header) *Builder
  • func (rb *Builder) Host(host string) *Builder
  • func (rb *Builder) Method(method string) *Builder
  • func (rb *Builder) Path(path string) *Builder
  • func (rb *Builder) Query(object any) *Builder
  • func (rb *Builder) QueryString(query string) *Builder
  • func (rb *Builder) Scheme(scheme string) *Builder
  • func (rb *Builder) Url(us string) *Builder
• type Conn
  • func NewConn(config ...ConnConfig) Conn
• type ConnConfig
• type Request
  • func (req *Request) Send() (resp *http.Response, err error)
  • func (req *Request) WantBody() (body []byte, err error)
  • func (req *Request) WantJson(v any) error
  • func (req *Request) WithContext(ctx context.Context) *Request
  • func (req *Request) WithHost(host string) *Request
  • func (req *Request) WithProxyTransport(us string) *Request
  • func (req *Request) WithTransport(transport http.RoundTripper) *Request
• type Status
  • func (e *Status) Error() string

Variables

var ErrEmptyBody = errors.New("empty body")

Functions

func MarshalHeaders

func MarshalHeaders(v any) (data http.Header, err error)

func MarshalJson

func MarshalJson(v any) (str string, err error)

func MarshalQuery

func MarshalQuery(v any) (s string, err error)

func UnmarshalHeaders

func UnmarshalHeaders(data http.Header, v any) (err error)

Types

type Builder

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

func (*Builder) Body

func (rb *Builder) Body(body []byte) *Builder

func (*Builder) BodyForm

func (rb *Builder) BodyForm(object any) *Builder

func (*Builder) BodyJson

func (rb *Builder) BodyJson(object any) *Builder

func (*Builder) BodyReader

func (rb *Builder) BodyReader(reader io.Reader) *Builder

func (*Builder) Build

func (rb *Builder) Build() *Request

func (*Builder) BuildURL

func (rb *Builder) BuildURL() (u *url.URL)

func (*Builder) Header

func (rb *Builder) Header(object any) *Builder

func (*Builder) HeaderAdd

func (rb *Builder) HeaderAdd(key string, value string) *Builder

func (*Builder) HeaderUpdate

func (rb *Builder) HeaderUpdate(header http.Header) *Builder

func (*Builder) Host

func (rb *Builder) Host(host string) *Builder

func (*Builder) Method

func (rb *Builder) Method(method string) *Builder

func (*Builder) Path

func (rb *Builder) Path(path string) *Builder

func (*Builder) Query

func (rb *Builder) Query(object any) *Builder

func (*Builder) QueryString

func (rb *Builder) QueryString(query string) *Builder

func (*Builder) Scheme

func (rb *Builder) Scheme(scheme string) *Builder

func (*Builder) Url

func (rb *Builder) Url(us string) *Builder

type Conn

type Conn interface {
	RoundTrip(r *http.Request) (resp *http.Response, err error)
}

func NewConn

func NewConn(config ...ConnConfig) Conn

type ConnConfig

type ConnConfig struct {
	Proxy     string
	DisableH2 bool
	EnableH3  bool
}

type Request

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

func (*Request) Send

func (req *Request) Send() (resp *http.Response, err error)

func (*Request) WantBody

func (req *Request) WantBody() (body []byte, err error)

func (*Request) WantJson

func (req *Request) WantJson(v any) error

func (*Request) WithContext

func (req *Request) WithContext(ctx context.Context) *Request

func (*Request) WithHost

func (req *Request) WithHost(host string) *Request

func (*Request) WithProxyTransport

func (req *Request) WithProxyTransport(us string) *Request

func (*Request) WithTransport

func (req *Request) WithTransport(transport http.RoundTripper) *Request

type Status

type Status struct {
	Code     int    `json:"status"`
	Message  string `json:"message"`
	Location string `json:"location"`
}

func (*Status) Error

func (e *Status) Error() string