<PackageReference Include="Polly.Core" Version="8.0.0-alpha.6" />

---

API Differences between 8.0.0-alpha.6 and 8.0.0-alpha.1

122 Additions 44 Removals

Polly

• public static class FallbackResilienceStrategyBuilderExtensions
  • public static ResilienceStrategyBuilder<TResult> AddFallback<TResult>(this ResilienceStrategyBuilder<TResult> builder, Action<PredicateBuilder<TResult>> shouldHandle, Func<OutcomeArguments<TResult, HandleFallbackArguments>, ValueTask<Outcome<TResult>>> fallbackAction)
• public static class Outcome
  • public static Outcome<TResult> FromException<TResult>(Exception exception)
  • public static ValueTask<Outcome<TResult>> FromExceptionAsTask<TResult>(Exception exception)
  • public static Outcome<TResult> FromResult<TResult>(TResult value)
  • public static ValueTask<Outcome<TResult>> FromResultAsTask<TResult>(TResult value)
• public struct Outcome<TResult>
  • public Outcome(Exception exception)
  • public Outcome(TResult result)
• public sealed class PredicateBuilder : PredicateBuilder<object>
  • public PredicateBuilder()
• public class PredicateBuilder<TResult>
  • public PredicateBuilder()
  • public static Func<OutcomeArguments<TResult, RetryPredicateArguments>, ValueTask<bool>> op_Implicit(PredicateBuilder<TResult> builder)
  • public static Func<OutcomeArguments<TResult, HedgingPredicateArguments>, ValueTask<bool>> op_Implicit(PredicateBuilder<TResult> builder)
  • public static Func<OutcomeArguments<TResult, FallbackPredicateArguments>, ValueTask<bool>> op_Implicit(PredicateBuilder<TResult> builder)
  • public static Func<OutcomeArguments<TResult, CircuitBreakerPredicateArguments>, ValueTask<bool>> op_Implicit(PredicateBuilder<TResult> builder)
  • public Predicate<Outcome<TResult>> Build()
  • public Func<OutcomeArguments<TResult, TArgs>, ValueTask<bool>> Build<TArgs>()
• public sealed class ResilienceContext
  • public string OperationKey { get; }
  • public IReadOnlyCollection<ResilienceEvent> ResilienceEvents { get; }
  • public IReadOnlyList<ResilienceEvent> ResilienceEvents { get; }
  • public static ResilienceContext Get()
  • public static ResilienceContext Get(CancellationToken cancellationToken = default)
  • public static ResilienceContext Get(string operationKey, CancellationToken cancellationToken = default)
• public abstract class ResilienceStrategyBuilderBase
  • public string InstanceName { get; set; }
  • public void AddStrategy(Func<ResilienceStrategyBuilderContext, ResilienceStrategy> factory, ResilienceStrategyOptions options)
  • public Func<double> Randomizer { get; set; }
• public sealed class ResilienceStrategyBuilderContext
  • public string BuilderInstanceName { get; }
• public static class ResilienceStrategyBuilderExtensions
  • public static ResilienceStrategyBuilder<TResult> AddStrategy<TResult>(this ResilienceStrategyBuilder<TResult> builder, ResilienceStrategy<TResult> strategy)
  • public static TBuilder AddStrategy<TBuilder>(this TBuilder builder, Func<ResilienceStrategyBuilderContext, ResilienceStrategy> factory, ResilienceStrategyOptions options) where TBuilder : ResilienceStrategyBuilderBase
• public static class RetryResilienceStrategyBuilderExtensions
  • public static ResilienceStrategyBuilder<TResult> AddRetry<TResult>(this ResilienceStrategyBuilder<TResult> builder, Action<PredicateBuilder<TResult>> shouldRetry, RetryBackoffType backoffType, int retryCount, TimeSpan baseDelay)

Polly.CircuitBreaker

• public class OnCircuitClosedArguments : IEquatable<OnCircuitClosedArguments>
  • protected virtual Type EqualityContract { get; }
  • protected OnCircuitClosedArguments(OnCircuitClosedArguments original)
  • public virtual OnCircuitClosedArguments <Clone>$()
  • protected virtual bool PrintMembers(StringBuilder builder)
• public class OnCircuitHalfOpenedArguments : IEquatable<OnCircuitHalfOpenedArguments>
  • protected virtual Type EqualityContract { get; }
  • protected OnCircuitHalfOpenedArguments(OnCircuitHalfOpenedArguments original)
  • public virtual OnCircuitHalfOpenedArguments <Clone>$()
  • protected virtual bool PrintMembers(StringBuilder builder)
• public class OnCircuitOpenedArguments : IEquatable<OnCircuitOpenedArguments>
  • protected virtual Type EqualityContract { get; }
  • protected OnCircuitOpenedArguments(OnCircuitOpenedArguments original)
  • public virtual OnCircuitOpenedArguments <Clone>$()
  • protected virtual bool PrintMembers(StringBuilder builder)

Polly.Fallback

• public struct FallbackPredicateArguments : IEquatable<FallbackPredicateArguments>
  • public FallbackPredicateArguments()
  • public static bool op_Equality(FallbackPredicateArguments left, FallbackPredicateArguments right)
  • public static bool op_Inequality(FallbackPredicateArguments left, FallbackPredicateArguments right)
  • public bool Equals(FallbackPredicateArguments other)
• public class FallbackStrategyOptions<TResult> : ResilienceStrategyOptions
  • public Func<OutcomeArguments<TResult, HandleFallbackArguments>, ValueTask<Outcome<TResult>>> FallbackAction { get; set; }
  • public Func<OutcomeArguments<TResult, FallbackPredicateArguments>, ValueTask<Outcome<TResult>>> FallbackAction { get; set; }
  • public Func<OutcomeArguments<TResult, HandleFallbackArguments>, ValueTask<bool>> ShouldHandle { get; set; }
  • public Func<OutcomeArguments<TResult, FallbackPredicateArguments>, ValueTask<bool>> ShouldHandle { get; set; }
• public struct HandleFallbackArguments : IEquatable<HandleFallbackArguments>
• public class OnFallbackArguments : IEquatable<OnFallbackArguments>
  • protected virtual Type EqualityContract { get; }
  • protected OnFallbackArguments(OnFallbackArguments original)
  • public virtual OnFallbackArguments <Clone>$()
  • protected virtual bool PrintMembers(StringBuilder builder)

Polly.Hedging

• public struct HandleHedgingArguments : IEquatable<HandleHedgingArguments>
• public struct HedgingActionGeneratorArguments<TResult> : IEquatable<HedgingActionGeneratorArguments<TResult>>
  • public ResilienceContext ActionContext { get; set; }
  • public ResilienceContext Context { get; set; }
  • public HedgingActionGeneratorArguments(ResilienceContext Context, int Attempt, Func<ResilienceContext, ValueTask<Outcome<TResult>>> Callback)
  • public ResilienceContext PrimaryContext { get; set; }
  • public HedgingActionGeneratorArguments(ResilienceContext PrimaryContext, ResilienceContext ActionContext, int Attempt, Func<ResilienceContext, ValueTask<Outcome<TResult>>> Callback)
  • public void Deconstruct(out ResilienceContext Context, out int Attempt, out Func Callback)
  • public void Deconstruct(out ResilienceContext PrimaryContext, out ResilienceContext ActionContext, out int Attempt, out Func Callback)
• public struct HedgingPredicateArguments : IEquatable<HedgingPredicateArguments>
  • public HedgingPredicateArguments()
  • public static bool op_Equality(HedgingPredicateArguments left, HedgingPredicateArguments right)
  • public static bool op_Inequality(HedgingPredicateArguments left, HedgingPredicateArguments right)
  • public bool Equals(HedgingPredicateArguments other)
• public class HedgingStrategyOptions<TResult> : ResilienceStrategyOptions
  • public Func<OutcomeArguments<TResult, HandleHedgingArguments>, ValueTask<bool>> ShouldHandle { get; set; }
  • public Func<OutcomeArguments<TResult, HedgingPredicateArguments>, ValueTask<bool>> ShouldHandle { get; set; }
• public class OnHedgingArguments : IEquatable<OnHedgingArguments>
  • public OnHedgingArguments(int Attempt)
  • protected virtual Type EqualityContract { get; }
  • public TimeSpan ExecutionTime { get; set; }
  • public bool HasOutcome { get; set; }
  • public OnHedgingArguments(int Attempt, bool HasOutcome, TimeSpan ExecutionTime)
  • protected OnHedgingArguments(OnHedgingArguments original)
  • public void Deconstruct(out int Attempt)
  • public virtual OnHedgingArguments <Clone>$()
  • public void Deconstruct(out int Attempt, out bool HasOutcome, out TimeSpan ExecutionTime)
  • protected virtual bool PrintMembers(StringBuilder builder)

Polly.Registry

• public class ConfigureBuilderContext<TKey>
  • public string BuilderInstanceName { get; }
  • public string StrategyKeyString { get; }
  • public void EnableReloads(Func<CancellationToken> reloadTokenProducer)
  • public void EnableReloads(Func<Func<CancellationToken>> tokenProducerFactory)
• public abstract class ResilienceStrategyProvider<TKey>
  • public virtual ResilienceStrategy Get(TKey key)
  • public virtual ResilienceStrategy<TResult> Get<TResult>(TKey key)
  • public abstract bool TryGet(TKey key, out ResilienceStrategy strategy)
  • public abstract bool TryGet<TResult>(TKey key, out ResilienceStrategy strategy)
  • public virtual ResilienceStrategy GetStrategy(TKey key)
  • public virtual ResilienceStrategy<TResult> GetStrategy<TResult>(TKey key)
  • public abstract bool TryGetStrategy(TKey key, out ResilienceStrategy strategy)
  • public abstract bool TryGetStrategy<TResult>(TKey key, out ResilienceStrategy strategy)
• public sealed class ResilienceStrategyRegistry<TKey> : ResilienceStrategyProvider<TKey>
  • public void Clear()
  • public void Clear<TResult>()
  • public bool Remove(TKey key)
  • public bool Remove<TResult>(TKey key)
  • public void ClearStrategies()
  • public void ClearStrategies<TResult>()
  • public ResilienceStrategy GetOrAddStrategy(TKey key, Action<ResilienceStrategyBuilder> configure)
  • public ResilienceStrategy GetOrAddStrategy(TKey key, Action<ResilienceStrategyBuilder, ConfigureBuilderContext<TKey>> configure)
  • public ResilienceStrategy<TResult> GetOrAddStrategy<TResult>(TKey key, Action<ResilienceStrategyBuilder<TResult>> configure)
  • public ResilienceStrategy<TResult> GetOrAddStrategy<TResult>(TKey key, Action<ResilienceStrategyBuilder<TResult>, ConfigureBuilderContext<TKey>> configure)
  • public bool TryAdd(TKey key, ResilienceStrategy strategy)
  • public bool TryAdd<TResult>(TKey key, ResilienceStrategy<TResult> strategy)
  • public bool RemoveStrategy(TKey key)
  • public bool RemoveStrategy<TResult>(TKey key)
  • public bool TryAddStrategy(TKey key, ResilienceStrategy strategy)
  • public bool TryAddStrategy<TResult>(TKey key, ResilienceStrategy<TResult> strategy)
• public class ResilienceStrategyRegistryOptions<TKey>
  • public Func<TKey, string> InstanceNameFormatter { get; set; }
  • public Func<TKey, string> StrategyKeyFormatter { get; set; }

Polly.Retry

• public class OnRetryArguments : IEquatable<OnRetryArguments>
  • protected virtual Type EqualityContract { get; }
  • public TimeSpan ExecutionTime { get; set; }
  • public OnRetryArguments(int Attempt, TimeSpan RetryDelay)
  • public OnRetryArguments(int Attempt, TimeSpan RetryDelay, TimeSpan ExecutionTime)
  • protected OnRetryArguments(OnRetryArguments original)
  • public void Deconstruct(out int Attempt, out TimeSpan RetryDelay)
  • public virtual OnRetryArguments <Clone>$()
  • public void Deconstruct(out int Attempt, out TimeSpan RetryDelay, out TimeSpan ExecutionTime)
  • protected virtual bool PrintMembers(StringBuilder builder)
• public struct RetryPredicateArguments : IEquatable<RetryPredicateArguments>
  • public int Attempt { get; set; }
  • public RetryPredicateArguments(int Attempt)
  • public static bool op_Equality(RetryPredicateArguments left, RetryPredicateArguments right)
  • public static bool op_Inequality(RetryPredicateArguments left, RetryPredicateArguments right)
  • public void Deconstruct(out int Attempt)
  • public bool Equals(RetryPredicateArguments other)
• public class RetryStrategyOptions<TResult> : ResilienceStrategyOptions
  • public Func<OutcomeArguments<TResult, ShouldRetryArguments>, ValueTask<bool>> ShouldRetry { get; set; }
  • public Func<OutcomeArguments<TResult, RetryPredicateArguments>, ValueTask<bool>> ShouldHandle { get; set; }
• public struct ShouldRetryArguments : IEquatable<ShouldRetryArguments>

Polly.Telemetry

• public class ExecutionAttemptArguments
  • public int Attempt { get; }
  • public TimeSpan ExecutionTime { get; }
  • public bool Handled { get; }
  • public ExecutionAttemptArguments(int attempt, TimeSpan executionTime, bool handled)
• public struct ResilienceEvent : IEquatable<ResilienceEvent>
  • public ResilienceEvent(string EventName)
  • public ResilienceEventSeverity Severity { get; set; }
  • public ResilienceEvent(ResilienceEventSeverity Severity, string EventName)
  • public void Deconstruct(out string EventName)
  • public void Deconstruct(out ResilienceEventSeverity Severity, out string EventName)
• public enum ResilienceEventSeverity
  • Critical = 5
  • Debug = 1
  • Error = 4
  • Information = 2
  • None = 0
  • Warning = 3
• public sealed class ResilienceStrategyTelemetry
  • public void Report<TArgs>(string eventName, ResilienceContext context, TArgs args)
  • public void Report<TArgs, TResult>(string eventName, OutcomeArguments<TResult, TArgs> args)
  • public bool IsEnabled { get; }
  • public void Report<TArgs>(ResilienceEvent resilienceEvent, ResilienceContext context, TArgs args)
  • public void Report<TArgs, TResult>(ResilienceEvent resilienceEvent, OutcomeArguments<TResult, TArgs> args)
• public sealed class ResilienceTelemetrySource : IEquatable<ResilienceTelemetrySource>
  • public string BuilderInstanceName { get; set; }
  • public ResilienceTelemetrySource(string BuilderName, ResilienceProperties BuilderProperties, string StrategyName, string StrategyType)
  • public ResilienceTelemetrySource(string BuilderName, string BuilderInstanceName, ResilienceProperties BuilderProperties, string StrategyName, string StrategyType)
  • public void Deconstruct(out string BuilderName, out ResilienceProperties BuilderProperties, out string StrategyName, out string StrategyType)
  • public void Deconstruct(out string BuilderName, out string BuilderInstanceName, out ResilienceProperties BuilderProperties, out string StrategyName, out string StrategyType)
• public sealed class TelemetryEventArguments : IEquatable<TelemetryEventArguments>
  • public string EventName { get; set; }
  • public ResilienceEvent Event { get; }
  • public TelemetryEventArguments(ResilienceTelemetrySource Source, string EventName, ResilienceContext Context, Outcome<object>? Outcome, object Arguments)
  • public void Deconstruct(out ResilienceTelemetrySource Source, out string EventName, out ResilienceContext Context, out Nullable Outcome, out object Arguments)

Polly.Timeout

• public class OnTimeoutArguments : IEquatable<OnTimeoutArguments>
  • protected virtual Type EqualityContract { get; }
  • protected OnTimeoutArguments(OnTimeoutArguments original)
  • public virtual OnTimeoutArguments <Clone>$()
  • protected virtual bool PrintMembers(StringBuilder builder)
• public class TimeoutRejectedException : ExecutionRejectedException
  • protected TimeoutRejectedException(SerializationInfo info, StreamingContext context)