retry

type Attempt ¶

type Attempt struct {
	Start time.Time
	Count uint
	Err   error
	*http.Request
	*http.Response
}

Attempt counts the round trips issued, starting from 1. Response is valid only when Err is nil.

type Decision ¶

type Decision int

Decision signals the intent of a Retryer

const (
	Ignore Decision = iota
	Retry
	Abort
)

type Delayer ¶

type Delayer func(Attempt)

Delayer sleeps or selects any amount of time for each attempt.

func Constant(delta time.Duration) Delayer

func Exponential(base time.Duration) Delayer

func Fibonacci(delta time.Duration) Delayer

func Linear(delta time.Duration) Delayer

type MaxError ¶

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

MaxError is returned from RoundTrip when the maximum attempts has been reached.

func (e MaxError) Error() string

type Retryer ¶

type Retryer func(Attempt) (Decision, error)

Retryer chooses whether or not to retry this request. The error is only valid when the Retyer returns Abort.

func All(conditions ...Retryer) Retryer

func EOF() Retryer

func Errors() Retryer

func Idempotent() Retryer

func Max(limit uint) Retryer

func Method(methods ...string) Retryer

func Net() Retryer

func Over(statusCode int) Retryer

func Temporary() Retryer

func Timeout(limit time.Duration) Retryer

type TimeoutError ¶

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

TimeoutError is returned from RoundTrip when the time limit has been reached.

func (e TimeoutError) Error() string

type Transport ¶

type Transport struct {
	// Delay is called for attempts that are retried.  If nil, no delay will be used.
	Delay Delayer

	// Retry is called for every attempt
	Retry Retryer

	// Next is called for every attempt
	Next http.RoundTripper
}

func (t Transport) RoundTrip(req *http.Request) (*http.Response, error)