feat(options): add DialerRetries and DialerRetryTimeout to ClusterOptions, RingOptions, and FailoverOptions (#3686)

Add DialerRetries and DialerRetryTimeout fields to ClusterOptions, RingOptions,
and FailoverOptions to allow users to configure connection retry behavior for
cluster, ring, and sentinel clients.

These options were previously only available for the standard Client and were
added to connection pools in #3518. This change ensures feature parity across
all client types.

Changes:
- Add DialerRetries and DialerRetryTimeout fields to ClusterOptions
- Add DialerRetries and DialerRetryTimeout fields to RingOptions
- Add DialerRetries and DialerRetryTimeout fields to FailoverOptions
- Update clientOptions() methods to pass through these values
- Update sentinelOptions() method to pass through these values
- Add tests to verify correct pass-through behavior

Fixes issue where ClusterClient, Ring, and FailoverClient users could not
customize connection retry behavior and were stuck with defaults (5 retries,
100ms backoff).

Co-authored-by: Nedyalko Dyakov <1547186+ndyakov@users.noreply.github.com>

Author: naveenchander30

options_test.go

@@ -333,3 +333,60 @@ func TestMaxConcurrentDialsOptions(t *testing.T) {
 		})
 	}
 }
+
+func TestClusterOptionsDialerRetries(t *testing.T) {
+	clusterOpt := &ClusterOptions{
+		DialerRetries:      10,
+		DialerRetryTimeout: 200 * time.Millisecond,
+	}
+
+	opt := clusterOpt.clientOptions()
+
+	if opt.DialerRetries != 10 {
+		t.Errorf("expected DialerRetries=10, got %d", opt.DialerRetries)
+	}
+	if opt.DialerRetryTimeout != 200*time.Millisecond {
+		t.Errorf("expected DialerRetryTimeout=200ms, got %v", opt.DialerRetryTimeout)
+	}
+}
+
+func TestRingOptionsDialerRetries(t *testing.T) {
+	ringOpt := &RingOptions{
+		DialerRetries:      10,
+		DialerRetryTimeout: 200 * time.Millisecond,
+	}
+
+	opt := ringOpt.clientOptions()
+
+	if opt.DialerRetries != 10 {
+		t.Errorf("expected DialerRetries=10, got %d", opt.DialerRetries)
+	}
+	if opt.DialerRetryTimeout != 200*time.Millisecond {
+		t.Errorf("expected DialerRetryTimeout=200ms, got %v", opt.DialerRetryTimeout)
+	}
+}
+
+func TestFailoverOptionsDialerRetries(t *testing.T) {
+	failoverOpt := &FailoverOptions{
+		DialerRetries:      10,
+		DialerRetryTimeout: 200 * time.Millisecond,
+	}
+
+	opt := failoverOpt.clientOptions()
+
+	if opt.DialerRetries != 10 {
+		t.Errorf("expected DialerRetries=10, got %d", opt.DialerRetries)
+	}
+	if opt.DialerRetryTimeout != 200*time.Millisecond {
+		t.Errorf("expected DialerRetryTimeout=200ms, got %v", opt.DialerRetryTimeout)
+	}
+
+	// Also verify sentinelOptions passes them through
+	sentinelOpt := failoverOpt.sentinelOptions("localhost:26379")
+	if sentinelOpt.DialerRetries != 10 {
+		t.Errorf("expected sentinel DialerRetries=10, got %d", sentinelOpt.DialerRetries)
+	}
+	if sentinelOpt.DialerRetryTimeout != 200*time.Millisecond {
+		t.Errorf("expected sentinel DialerRetryTimeout=200ms, got %v", sentinelOpt.DialerRetryTimeout)
+	}
+}

osscluster.go

@@ -86,7 +86,18 @@ type ClusterOptions struct {
 	MinRetryBackoff time.Duration
 	MaxRetryBackoff time.Duration
 
-	DialTimeout           time.Duration
+	DialTimeout time.Duration
+
+	// DialerRetries is the maximum number of retry attempts when dialing fails.
+	//
+	// default: 5
+	DialerRetries int
+
+	// DialerRetryTimeout is the backoff duration between retry attempts.
+	//
+	// default: 100 milliseconds
+	DialerRetryTimeout time.Duration
+
 	ReadTimeout           time.Duration
 	WriteTimeout          time.Duration
 	ContextTimeoutEnabled bool
@@ -367,6 +378,8 @@ func (opt *ClusterOptions) clientOptions() *Options {
 		MaxRetryBackoff: opt.MaxRetryBackoff,
 
 		DialTimeout:           opt.DialTimeout,
+		DialerRetries:         opt.DialerRetries,
+		DialerRetryTimeout:    opt.DialerRetryTimeout,
 		ReadTimeout:           opt.ReadTimeout,
 		WriteTimeout:          opt.WriteTimeout,
 		ContextTimeoutEnabled: opt.ContextTimeoutEnabled,

ring.go

@@ -108,7 +108,18 @@ type RingOptions struct {
 	MinRetryBackoff time.Duration
 	MaxRetryBackoff time.Duration
 
-	DialTimeout           time.Duration
+	DialTimeout time.Duration
+
+	// DialerRetries is the maximum number of retry attempts when dialing fails.
+	//
+	// default: 5
+	DialerRetries int
+
+	// DialerRetryTimeout is the backoff duration between retry attempts.
+	//
+	// default: 100 milliseconds
+	DialerRetryTimeout time.Duration
+
 	ReadTimeout           time.Duration
 	WriteTimeout          time.Duration
 	ContextTimeoutEnabled bool
@@ -220,6 +231,8 @@ func (opt *RingOptions) clientOptions() *Options {
 		MaxRetries: -1,
 
 		DialTimeout:           opt.DialTimeout,
+		DialerRetries:         opt.DialerRetries,
+		DialerRetryTimeout:    opt.DialerRetryTimeout,
 		ReadTimeout:           opt.ReadTimeout,
 		WriteTimeout:          opt.WriteTimeout,
 		ContextTimeoutEnabled: opt.ContextTimeoutEnabled,

sentinel.go

@@ -89,7 +89,18 @@ type FailoverOptions struct {
 	MinRetryBackoff time.Duration
 	MaxRetryBackoff time.Duration
 
-	DialTimeout           time.Duration
+	DialTimeout time.Duration
+
+	// DialerRetries is the maximum number of retry attempts when dialing fails.
+	//
+	// default: 5
+	DialerRetries int
+
+	// DialerRetryTimeout is the backoff duration between retry attempts.
+	//
+	// default: 100 milliseconds
+	DialerRetryTimeout time.Duration
+
 	ReadTimeout           time.Duration
 	WriteTimeout          time.Duration
 	ContextTimeoutEnabled bool
@@ -176,6 +187,8 @@ func (opt *FailoverOptions) clientOptions() *Options {
 		WriteBufferSize: opt.WriteBufferSize,
 
 		DialTimeout:           opt.DialTimeout,
+		DialerRetries:         opt.DialerRetries,
+		DialerRetryTimeout:    opt.DialerRetryTimeout,
 		ReadTimeout:           opt.ReadTimeout,
 		WriteTimeout:          opt.WriteTimeout,
 		ContextTimeoutEnabled: opt.ContextTimeoutEnabled,
@@ -225,6 +238,8 @@ func (opt *FailoverOptions) sentinelOptions(addr string) *Options {
 		WriteBufferSize: 4096,
 
 		DialTimeout:           opt.DialTimeout,
+		DialerRetries:         opt.DialerRetries,
+		DialerRetryTimeout:    opt.DialerRetryTimeout,
 		ReadTimeout:           opt.ReadTimeout,
 		WriteTimeout:          opt.WriteTimeout,
 		ContextTimeoutEnabled: opt.ContextTimeoutEnabled,