httputil

README

httputil

The package contains various helpers related to http protocol

Documentation

Index

• Variables
• func AllHTTPMethods() []string
• func ChangePoolSize(x int64) error
• func DrainResponseBody(resp *http.Response)
• func DumpRequest(req *http.Request) (string, error)
• func DumpResponseHeadersAndRaw(resp *http.Response) (headers, fullresp []byte, err error)
• func DumpResponseIntoBuffer(resp *http.Response, body bool, buff *bytes.Buffer) (err error)
• func GetPoolSize() int64
• type ChainItem
  • func GetChain(r *http.Response) (chain []ChainItem, err error)
• type ResponseChain
  • func NewResponseChain(resp *http.Response, maxBody int64) *ResponseChain
  • func (r *ResponseChain) Body() *bytes.Buffer
  • func (r *ResponseChain) Close()
  • func (r *ResponseChain) Fill() error
  • func (r *ResponseChain) FullResponse() *bytes.Buffer
  • func (r *ResponseChain) Has() bool
  • func (r *ResponseChain) Headers() *bytes.Buffer
  • func (r *ResponseChain) Previous() bool
  • func (r *ResponseChain) Request() *http.Request
  • func (r *ResponseChain) Response() *http.Response

Variables

var (
	// reasonably high default allowed allocs
	DefaultBytesBufferAlloc = int64(10000)
)

var (
	MaxBodyRead, _ = units.FromHumanSize("4mb")
)

Functions

func AllHTTPMethods

func AllHTTPMethods() []string

AllHTTPMethods contains all available HTTP methods

func ChangePoolSize

func ChangePoolSize(x int64) error

func DrainResponseBody

func DrainResponseBody(resp *http.Response)

DrainResponseBody drains the response body and closes it.

func DumpRequest

func DumpRequest(req *http.Request) (string, error)

DumpRequest to string

func DumpResponseHeadersAndRaw

func DumpResponseHeadersAndRaw(resp *http.Response) (headers, fullresp []byte, err error)

DumpResponseHeadersAndRaw returns http headers and response as strings

func DumpResponseIntoBuffer

func DumpResponseIntoBuffer(resp *http.Response, body bool, buff *bytes.Buffer) (err error)

DumpResponseIntoBuffer dumps a http response without allocating a new buffer for the response body.

func GetPoolSize

func GetPoolSize() int64

Types

type ChainItem

type ChainItem struct {
	Request    []byte
	Response   []byte
	StatusCode int
	Location   string
	RequestURL string
}

ChainItem request=>response Deprecated: use ResponseChain instead which is more efficient and lazy

func GetChain

func GetChain(r *http.Response) (chain []ChainItem, err error)

GetChain if redirects Deprecated: use ResponseChain instead which is more efficient and lazy

type ResponseChain

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

ResponseChain is a response chain for a http request on every call to previous it returns the previous response if it was redirected.

func NewResponseChain

func NewResponseChain(resp *http.Response, maxBody int64) *ResponseChain

NewResponseChain creates a new response chain for a http request with a maximum body size. (if -1 stick to default 4MB)

func (*ResponseChain) Body

func (r *ResponseChain) Body() *bytes.Buffer

Body returns the current response body in the chain

func (*ResponseChain) Close

func (r *ResponseChain) Close()

Close the response chain and releases the buffers.

func (*ResponseChain) Fill

func (r *ResponseChain) Fill() error

Fill buffers

func (*ResponseChain) FullResponse

func (r *ResponseChain) FullResponse() *bytes.Buffer

FullResponse returns the current response in the chain

func (*ResponseChain) Has

func (r *ResponseChain) Has() bool

Has returns true if the response chain has a response

func (*ResponseChain) Headers

func (r *ResponseChain) Headers() *bytes.Buffer

Response returns the current response in the chain

func (*ResponseChain) Previous

func (r *ResponseChain) Previous() bool

previous updates response pointer to previous response if it was redirected and returns true else false

func (*ResponseChain) Request

func (r *ResponseChain) Request() *http.Request

Request is request of current response

func (*ResponseChain) Response

func (r *ResponseChain) Response() *http.Response

Response is response of current response