3.1 - Client-side geographic failover

A.cs

@@ -0,0 +1,15 @@
+public interface IArgs { void Map(); }
+public struct S : IArgs { public int Arg0; public long Arg1; public void Map() { } }
+public interface IInner { int Do(int a, long b); }
+
+// candidate delegate: like Func<TState,TIn,TResult> but with 'in' on the state
+public delegate TResult ArgsFunc<TState, TIn, TResult>(in TState state, TIn inner) where TState : struct, IArgs;
+
+public class C
+{
+    private TResult Execute<TState, TResult>(in TState state, ArgsFunc<TState, IInner, TResult> op)
+        where TState : struct, IArgs => op(in state, null!);
+
+    // TEST 1: fully implicit lambda (what the generator emits today)
+    public int Implicit() => Execute(new S(), static (state, inner) => inner.Do(state.Arg0, state.Arg1));
+}

Directory.Build.props

@@ -11,7 +11,7 @@
     <CodeAnalysisRuleset>$(MSBuildThisFileDirectory)Shared.ruleset</CodeAnalysisRuleset>
     <MSBuildWarningsAsMessages>NETSDK1069</MSBuildWarningsAsMessages>
     <!-- SER002/SER003/SER006 retired (Redis 8.4/8.6/8.8 features no longer experimental); IDs reserved, see Experiments.cs -->
-    <NoWarn>$(NoWarn);NU5105;NU1507;SER001;SER004;SER005;SER008</NoWarn>
+    <NoWarn>$(NoWarn);NU5105;NU1507;SER001;SER004;SER005;SER007;SER008</NoWarn>
     <PackageReleaseNotes>https://stackexchange.github.io/StackExchange.Redis/ReleaseNotes</PackageReleaseNotes>
     <PackageProjectUrl>https://stackexchange.github.io/StackExchange.Redis/</PackageProjectUrl>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>

Directory.Packages.props

@@ -18,7 +18,7 @@
     <!-- Packages only used in the solution, upgrade at will -->
     <PackageVersion Include="BenchmarkDotNet" Version="0.15.8" />
     <PackageVersion Include="GitHubActionsTestLogger" Version="3.0.2" />
-    <PackageVersion Include="Microsoft.CodeAnalysis.PublicApiAnalyzers" Version="4.14.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.PublicApiAnalyzers" Version="5.6.0" />
     <PackageVersion Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.3.0" />
     <PackageVersion Include="Microsoft.SourceLink.GitHub" Version="10.0.201" />

docs/Configuration.md

@@ -128,6 +128,20 @@ Additional code-only options:
   - **Note: heartbeats are not free and that's why the default is 1 second. There is additional overhead to running this more often simply because it does some work each time it fires.**
 - LibraryName - Default: `SE.Redis` (unless a `DefaultOptionsProvider` specifies otherwise)
   - The library name to use with `CLIENT SETINFO` when setting the library name/version on the connection
+- IncludeDetailInExceptions - Default: `true`
+  - Whether exceptions include identifiable details (key names, and additional `.Data` annotations)
+- Defaults (`DefaultOptionsProvider`) - Default: resolved from the configured endpoints
+    - The provider that supplies default values for options that have not been set explicitly (for example, recognized cloud endpoints can apply tuned defaults)
+- IncludePerformanceCountersInExceptions - Default: `false`
+  - Whether exceptions include performance counter details (CPU usage, etc); note that this can be problematic on some platforms
+- RequestBufferPool (`MemoryPool<byte>`) - Default: `null`
+  - The buffer pool to use when buffering requests; when `null`, a shared default pool is used
+- ResponseBufferPool (`MemoryPool<byte>`) - Default: `null`
+  - The buffer pool to use when buffering responses (and for allocating `Lease<byte>` results); when `null`, a shared default pool is used
+- CircuitBreaker (`CircuitBreaker`) - Default: `null`
+  - **[Experimental](exp/SER007)** (client-side geographic failover). A per-connection circuit breaker that *passively* observes the outcome of normal traffic and tears the connection down when it becomes unstable. When the connection is a member of a connection group, this flows in from `MultiGroupOptions.CircuitBreaker` if not set explicitly. See [Client-side geographic failover](Failover)
+- HealthCheck (`HealthCheck`) - Default: `null`
+  - **[Experimental](exp/SER007)** (client-side geographic failover). An *active* health check used when the connection is a member of a connection group; when `null`, the group-level `MultiGroupOptions.HealthCheck` is used. See [Client-side geographic failover](Failover)
 
 Tokens in the configuration string are comma-separated; any without an `=` sign are assumed to be redis server endpoints. Endpoints without an explicit port will use 6379 if ssl is not enabled, and 6380 if ssl is enabled.
 Tokens starting with `$` are taken to represent command maps, for example: `$config=cfg`.