requester

Feb 15, 2023

Changes in this version

type ExponentialBackoff

+ func ConstantBackoff(delay time.Duration) *ExponentialBackoff

+ func ConstantBackoffWithJitter(delay time.Duration) *ExponentialBackoff

+ func NoBackoff() *ExponentialBackoff

May 21, 2021

Changes in this version

+ func OnlyIdempotentShouldRetry(_ int, req *http.Request, _ *http.Response, _ error) bool

type RetryConfig

+ ReadResponse bool

type ShouldRetryer

+ func AllRetryers(s ...ShouldRetryer) ShouldRetryer

Mar 15, 2021

Changes in this version

+ var DefaultBackoff = ExponentialBackoff

+ var DefaultRetryConfig = RetryConfig

+ func DefaultShouldRetry(attempt int, req *http.Request, resp *http.Response, err error) bool

+ type Backoffer interface

+ Backoff func(attempt int) time.Duration

+ type BackofferFunc func(int) time.Duration

+ func (b BackofferFunc) Backoff(attempt int) time.Duration

+ type ExponentialBackoff struct

+ BaseDelay time.Duration

+ Jitter float64

+ MaxDelay time.Duration

+ Multiplier float64

+ func (c *ExponentialBackoff) Backoff(attempt int) time.Duration

type Middleware

+ func Retry(config *RetryConfig) Middleware

+ type RetryConfig struct

+ Backoff Backoffer

+ MaxAttempts int

+ ShouldRetry ShouldRetryer

+ type ShouldRetryer interface

+ ShouldRetry func(attempt int, req *http.Request, resp *http.Response, err error) bool

+ type ShouldRetryerFunc func(attempt int, req *http.Request, resp *http.Response, err error) bool

+ func (s ShouldRetryerFunc) ShouldRetry(attempt int, req *http.Request, resp *http.Response, err error) bool

Jan 29, 2021

Changes in this version

+ type ContentTypeUnmarshaler struct

+ Unmarshalers map[string]Unmarshaler

+ func NewContentTypeUnmarshaler() *ContentTypeUnmarshaler

+ func (c *ContentTypeUnmarshaler) Apply(r *Requester) error

+ func (c *ContentTypeUnmarshaler) Unmarshal(data []byte, contentType string, v interface{}) error

Feb 12, 2019

Changes in this version

+ const HeaderRange

type Option

+ func AppendPath(elements ...string) Option

+ func Range(byteRange string) Option

May 17, 2018

Changes in this version

type FormMarshaler

+ func (m *FormMarshaler) Apply(r *Requester) error

type JSONMarshaler

+ func (m *JSONMarshaler) Apply(r *Requester) error

type Middleware

+ func DumpToStderr() Middleware

type MultiUnmarshaler

+ func (m *MultiUnmarshaler) Apply(r *Requester) error

type Requester

+ func (r *Requester) MustWith(opts ...Option) *Requester

type XMLMarshaler

+ func (m *XMLMarshaler) Apply(r *Requester) error

May 8, 2018

Changes in this version

type Inspector

+ func (i *Inspector) MiddlewareFunc(next Doer) Doer

May 9, 2018

Changes in this version

+ func ChannelHandler() (chan<- *http.Response, http.Handler)

+ func MockHandler(statusCode int, options ...Option) http.Handler

+ func MockResponse(statusCode int, options ...Option) *http.Response

type DoerFunc

+ func ChannelDoer() (chan<- *http.Response, DoerFunc)

+ func MockDoer(statusCode int, options ...Option) DoerFunc

+ func (f DoerFunc) Apply(r *Requester) error

+ type Inspector struct

+ Request *http.Request

+ RequestBody *bytes.Buffer

+ Response *http.Response

+ ResponseBody *bytes.Buffer

+ func Inspect(r *Requester) *Inspector

+ func (i *Inspector) Apply(r *Requester) error

+ func (i *Inspector) Clear()

+ func (i *Inspector) Wrap(next Doer) Doer

type MarshalFunc

+ func (f MarshalFunc) Apply(r *Requester) error

type Marshaler

+ Marshal func(v interface{}) (data []byte, contentType string, err error)

type Middleware

+ func DumpToStout() Middleware

+ func ExpectCode(code int) Middleware

+ func ExpectSuccessCode() Middleware

type Option

+ func WithMarshaler(m Marshaler) Option

+ func WithUnmarshaler(m Unmarshaler) Option

type UnmarshalFunc

+ func (f UnmarshalFunc) Apply(r *Requester) error

type Unmarshaler

+ Unmarshal func(data []byte, contentType string, v interface{}) error

Feb 8, 2018

Changes in this version

+ const HeaderAccept

+ const HeaderAuthorization

+ const HeaderContentType

+ const MediaTypeForm

+ const MediaTypeJSON

+ const MediaTypeMultipart

+ const MediaTypeMultipartForm

+ const MediaTypeOctetStream

+ const MediaTypeTextPlain

+ const MediaTypeXML

+ var DefaultRequester = Requester

+ func Receive(successV interface{}, opts ...Option) (*http.Response, []byte, error)

+ func ReceiveContext(ctx context.Context, successV interface{}, opts ...Option) (*http.Response, []byte, error)

+ func Request(opts ...Option) (*http.Request, error)

+ func RequestContext(ctx context.Context, opts ...Option) (*http.Request, error)

+ func Send(opts ...Option) (*http.Response, error)

+ func SendContext(ctx context.Context, opts ...Option) (*http.Response, error)

+ type BodyMarshaler interface

+ Marshal func(v interface{}) (data []byte, contentType string, err error)

+ var DefaultMarshaler BodyMarshaler = &JSONMarshaler{}

+ type BodyUnmarshaler interface

+ Unmarshal func(data []byte, contentType string, v interface{}) error

+ var DefaultUnmarshaler BodyUnmarshaler = &MultiUnmarshaler{}

+ type Doer interface

+ Do func(req *http.Request) (*http.Response, error)

+ func Wrap(d Doer, m ...Middleware) Doer

+ type DoerFunc func(req *http.Request) (*http.Response, error)

+ func (f DoerFunc) Do(req *http.Request) (*http.Response, error)

+ type FormMarshaler struct

+ func (*FormMarshaler) Marshal(v interface{}) (data []byte, contentType string, err error)

+ type JSONMarshaler struct

+ Indent bool

+ func (m *JSONMarshaler) Marshal(v interface{}) (data []byte, contentType string, err error)

+ func (m *JSONMarshaler) Unmarshal(data []byte, contentType string, v interface{}) error

+ type MarshalFunc func(v interface{}) ([]byte, string, error)

+ func (f MarshalFunc) Marshal(v interface{}) ([]byte, string, error)

+ type Middleware func(Doer) Doer

+ func Dump(w io.Writer) Middleware

+ func DumpToLog(logf func(a ...interface{})) Middleware

+ func DumpToStandardOut() Middleware

+ func Non2XXResponseAsError() Middleware

+ func (m Middleware) Apply(r *Requester) error

+ type MultiUnmarshaler struct

+ func (m *MultiUnmarshaler) Unmarshal(data []byte, contentType string, v interface{}) error

+ type Option interface

+ Apply func(*Requester) error

+ func Accept(accept string) Option

+ func AddHeader(key, value string) Option

+ func BasicAuth(username, password string) Option

+ func BearerAuth(token string) Option

+ func Body(body interface{}) Option

+ func Client(opts ...httpclient.Option) Option

+ func ContentType(contentType string) Option

+ func Delete(paths ...string) Option

+ func DeleteHeader(key string) Option

+ func Form() Option

+ func Get(paths ...string) Option

+ func Head(paths ...string) Option

+ func Header(key, value string) Option

+ func Host(host string) Option

+ func JSON(indent bool) Option

+ func Marshaler(m BodyMarshaler) Option

+ func Method(m string, paths ...string) Option

+ func Patch(paths ...string) Option

+ func Post(paths ...string) Option

+ func Put(paths ...string) Option

+ func QueryParam(k, v string) Option

+ func QueryParams(queryStructs ...interface{}) Option

+ func RelativeURL(paths ...string) Option

+ func URL(rawurl string) Option

+ func Unmarshaler(m BodyUnmarshaler) Option

+ func Use(m ...Middleware) Option

+ func WithDoer(d Doer) Option

+ func XML(indent bool) Option

+ type OptionFunc func(*Requester) error

+ func (f OptionFunc) Apply(r *Requester) error

+ type Requester struct

+ Body interface{}

+ Close bool

+ ContentLength int64

+ Doer Doer

+ GetBody func() (io.ReadCloser, error)

+ Header http.Header

+ Host string

+ Marshaler BodyMarshaler

+ Method string

+ Middleware []Middleware

+ QueryParams url.Values

+ Trailer http.Header

+ TransferEncoding []string

+ URL *url.URL

+ Unmarshaler BodyUnmarshaler

+ func MustNew(options ...Option) *Requester

+ func New(options ...Option) (*Requester, error)

+ func (r *Requester) Apply(opts ...Option) error

+ func (r *Requester) Clone() *Requester

+ func (r *Requester) Do(req *http.Request) (*http.Response, error)

+ func (r *Requester) Headers() http.Header

+ func (r *Requester) MustApply(opts ...Option)

+ func (r *Requester) Params() url.Values

+ func (r *Requester) Receive(into interface{}, opts ...Option) (resp *http.Response, body []byte, err error)

+ func (r *Requester) ReceiveContext(ctx context.Context, into interface{}, opts ...Option) (resp *http.Response, body []byte, err error)

+ func (r *Requester) Request(opts ...Option) (*http.Request, error)

+ func (r *Requester) RequestContext(ctx context.Context, opts ...Option) (*http.Request, error)

+ func (r *Requester) Send(opts ...Option) (*http.Response, error)

+ func (r *Requester) SendContext(ctx context.Context, opts ...Option) (*http.Response, error)

+ func (r *Requester) Trailers() http.Header

+ func (r *Requester) With(opts ...Option) (*Requester, error)

+ type UnmarshalFunc func(data []byte, contentType string, v interface{}) error

+ func (f UnmarshalFunc) Unmarshal(data []byte, contentType string, v interface{}) error

+ type XMLMarshaler struct

+ Indent bool

+ func (*XMLMarshaler) Unmarshal(data []byte, contentType string, v interface{}) error

+ func (m *XMLMarshaler) Marshal(v interface{}) (data []byte, contentType string, err error)