polling

Aug 19, 2026

Changes in this version

+ var ErrNilClient = errors.New("polling: nil *http.Client")

type Option

+ func WithFullJitter(frac float64) Option

May 2, 2026

Changes in this version

+ var ErrInvalidInterval = errors.New("polling: interval must be > 0")

+ var ErrInvalidOption = errors.New("polling: invalid option")

+ var ErrMaxAttemptsExceeded = errors.New("polling: max attempts exceeded")

+ var ErrMaxWallClockExceeded = fmt.Errorf("polling: max wall-clock exceeded: %w", context.DeadlineExceeded)

+ var ErrPredicatePanic = errors.New("polling: predicate panicked")

+ func As[T any](ctx context.Context, c *http.Client, method, url string, headers http.Header, ...) iter.Seq2[T, error]

+ func Poll(ctx context.Context, c *http.Client, method, url string, headers http.Header, ...) iter.Seq2[*http.Response, error]

+ type Option func(*config)

+ func WithChangeOnly() Option

+ func WithDecode[T any](decode func(*http.Response) (T, error)) Option

+ func WithDone(predicate func(*http.Response) bool) Option

+ func WithDoneT[T any](predicate func(T) bool) Option

+ func WithHonorRetryAfter(b bool) Option

+ func WithJitter(frac float64) Option

+ func WithLogger(l *slog.Logger) Option

+ func WithMaxAttempts(n int) Option

+ func WithMaxWallClock(d time.Duration) Option

+ func WithNowFunc(f func() time.Time) Option

+ func WithSleepFunc(f func(time.Duration)) Option