backoff

Documentation

Overview

Package backoff provides exponential backoff calculation and context-aware sleep utilities.

Index

• Constants
• func Calculate(attempt int) time.Duration
• func SleepWithContext(ctx context.Context, d time.Duration) bool

Constants

const (

	// MaxRetryAfterWait caps how long we'll honor a Retry-After header to prevent
	// a misbehaving server from blocking the agent for an unreasonable amount of time.
	MaxRetryAfterWait = 60 * time.Second
)

Configuration constants for exponential backoff.

Functions

func Calculate

func Calculate(attempt int) time.Duration

Calculate returns the backoff duration for a given attempt (0-indexed). Uses exponential backoff with jitter.

func SleepWithContext

func SleepWithContext(ctx context.Context, d time.Duration) bool

SleepWithContext sleeps for the specified duration, returning early if context is cancelled. Returns true if the sleep completed, false if it was interrupted by context cancellation.