The highest tagged major version is
Documentation
¶
Overview ¶
Package retry runs a function with configurable retries, exponential backoff, and optional jitter.
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Do ¶
Do runs fn, retrying on error per the options. It returns nil on the first success, the last error once attempts are exhausted (or pred is false), or ctx.Err() if the context ends.
Example ¶
Retry a flaky operation a few times with exponential backoff.
package main
import (
"context"
"errors"
"fmt"
"time"
"github.com/rahmadafandi/fibr/retry"
)
func main() {
attempts := 0
err := retry.Do(context.Background(), func() error {
attempts++
if attempts < 3 {
return errors.New("temporary failure")
}
return nil
}, retry.WithAttempts(5), retry.WithDelay(time.Millisecond))
fmt.Println("attempts:", attempts, "err:", err)
}
Output: attempts: 3 err: <nil>
Types ¶
type Option ¶
type Option func(*config)
Option configures a retry.
func WithAttempts ¶
WithAttempts sets the total number of attempts including the first. Values below 1 are clamped to 1. The default is 3.
func WithJitter ¶
WithJitter adds random jitter as a fraction (0..1) of each delay. The default is 0 (no jitter).
func WithMaxDelay ¶
WithMaxDelay caps the per-attempt backoff delay. Zero (default) means no cap.
func WithMultiplier ¶
WithMultiplier sets the exponential backoff factor. The default is 2.0.
func WithRetryIf ¶
WithRetryIf retries only when pred(err) is true. The default retries on any non-nil error.
Source Files