Skip to content

Upgrading Polly 7 to 8

Breaking7.2.4 → 8.9.1Breaking43New79Changed103Fixed53Other709

BreakingUpgrade verdict

43 breaking changes.

  • Renames BehaviorAction to BehaviorGenerator.
  • Changes IResilienceStrategy from an interface to an abstract class, which affects how it is implemented.
  • Cleans up the namespaces.
  • Drops Task-based execute methods.
Top 3 of 43 that need code or config changes

Polly publishes an official migration guide for version 8. It covers more than the release notes do.

Migration guide from Polly v7 to v8 ↗

Target frameworks requirement changed in 8.9.0: .NETFramework4.6.1, .NETFramework4.7.2, .NETStandard1.1, .NETStandard2.0 → .NETFramework4.6.2, .NETFramework4.7.2, .NETStandard2.0, net10.0, net6.0, net8.0.

Adds polly.core 8.9.1.

Drops netstandard.library, system.valuetuple.

Breaking43
Renames BehaviorAction to BehaviorGenerator.
BehaviorActionBehaviorGenerator
Makes IResilienceStrategy an abstract class instead of an interface.
IResilienceStrategy
Cleans up the namespaces.
Drops Task-based execute methods.
Changes the retry backoff type default to constant.
Renames ResilienceStrategyBuilder to CompositeStrategyBuilder.
ResilienceStrategyBuilderCompositeStrategyBuilder
Renames ResilienceStrategy to ResiliencePipeline.
ResilienceStrategyResiliencePipeline
Drops DelegatingResilienceStrategy.
DelegatingResilienceStrategy
Drops ResilienceStrategyBuilderOptions.
ResilienceStrategyBuilderOptions
Adds Async suffix to some APIs.
Makes ResilienceStrategyOptions abstract.
ResilienceStrategyOptions
Hides the non-generic Hedging and Fallback API.
HedgingFallback
Uses delegates in TimeoutStrategyOptions and RateLimiterStrategyOptions.
TimeoutStrategyOptionsRateLimiterStrategyOptions
Uses delegates in circuit breaker options.
Uses delegates in RetryStrategyOptions.
RetryStrategyOptions
Uses delegates in HedgingStrategyOptions.
HedgingStrategyOptions
Uses delegates in FallbackStrategyOptions.
FallbackStrategyOptions
Drops the callback API.
Drops Outcome and cleans up the options.
Outcome
Renames AddResilienceStrategy to AddResilienceStrategyRegistry.
AddResilienceStrategyAddResilienceStrategyRegistry
Converts records to classes.
Drops the simple circuit breaker.
Renames Attempt to AttemptNumber.
AttemptAttemptNumber
Drops the Extensions suffix from the Polly.Extensions namespace.
Polly.Extensions
Drops ResilienceTelemetryFactory.
ResilienceTelemetryFactory
Drops internal visibility between assemblies.
Changes BuilderName and StrategyName to default to null.
BuilderNameStrategyName
Drops the Polly.Strategy namespace.
Polly.Strategy
Drops some convenience extensions.
Renames TelemetryResilienceStrategyOptions to TelemetryOptions.
TelemetryResilienceStrategyOptionsTelemetryOptions
Drops custom validation attributes.
Drops TimeProvider.CancelAfter.
TimeProvider.CancelAfter
Renames ExecuteCoreAsync to ExecuteCore.
ExecuteCoreAsyncExecuteCore
Drops the ResilienceStrategyBuilder.IsGenericBuilder property.
ResilienceStrategyBuilder.IsGenericBuilder
Renames BuilderName to Name.
BuilderNameName
Hides CircuitBreakerStateProvider.LastHandledOutcome.
CircuitBreakerStateProvider.LastHandledOutcome
Drops TelemetryResilienceStrategy.
TelemetryResilienceStrategy
Hides validation APIs.
Hides or drops some unused APIs.
Hides the IsSynchronous property.
IsSynchronous
Drops unused ResiliencePipelineRegistry APIs.
ResiliencePipelineRegistry
Drops the OutcomeArguments struct.
OutcomeArguments
Cleans up Outcome internals and drops unused hedging and fallbacks APIs.
Outcome

Generated by DepDelta from published .NET assemblies. Not mixed with prose notes.

  • removed: abstract class ExecutionRejectedException extends Exception
  • removed: protected ctor ExecutionRejectedException()
  • removed: protected ctor ExecutionRejectedException(SerializationInfo info, StreamingContext context)
  • removed: protected ctor ExecutionRejectedException(string message)
  • removed: protected ctor ExecutionRejectedException(string message, Exception inner)
  • added: static class ResiliencePipelineConversionExtensions
  • added: static method ResiliencePipelineConversionExtensions.AsAsyncPolicy(ResiliencePipeline strategy): IAsyncPolicy
  • added: static method ResiliencePipelineConversionExtensions.AsAsyncPolicy<TResult>(ResiliencePipeline<TResult> strategy): IAsyncPolicy<TResult>
  • added: static method ResiliencePipelineConversionExtensions.AsSyncPolicy(ResiliencePipeline strategy): ISyncPolicy
  • added: static method ResiliencePipelineConversionExtensions.AsSyncPolicy<TResult>(ResiliencePipeline<TResult> strategy): ISyncPolicy<TResult>
  • removed: class BrokenCircuitException extends ExecutionRejectedException
  • removed: class IsolatedCircuitException extends BrokenCircuitException
  • removed: ctor BrokenCircuitException(string message)
  • removed: ctor BrokenCircuitException(string message, Exception inner)
  • removed: ctor IsolatedCircuitException(string message)
  • removed: enum CircuitState
  • removed: member CircuitState.Closed
  • removed: member CircuitState.HalfOpen
  • removed: member CircuitState.Isolated
  • removed: member CircuitState.Open
  • removed: protected ctor IsolatedCircuitException(SerializationInfo info, StreamingContext context)
  • changed: ctor BrokenCircuitException() → ctor BrokenCircuitException(string message, Exception inner, TResult result)
  • added: ctor RateLimitRejectedException()
  • added: ctor RateLimitRejectedException(string message)
  • added: ctor RateLimitRejectedException(string message, Exception inner)
  • removed: class TimeoutRejectedException extends ExecutionRejectedException
  • removed: ctor TimeoutRejectedException()
  • removed: ctor TimeoutRejectedException(string message)
  • removed: ctor TimeoutRejectedException(string message, Exception innerException)
  • removed: protected ctor TimeoutRejectedException(SerializationInfo info, StreamingContext context)