Polly.Net40Async 5.7.0

Polly.Net40Async is a version of the Polly library for .NET 4.0 with async support via Microsoft.Bcl.Async.  Polly allows developers to express resilience policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner.

There is a newer version of this package available.
See the version list below for details.
Install-Package Polly.Net40Async -Version 5.7.0
dotnet add package Polly.Net40Async --version 5.7.0
<PackageReference Include="Polly.Net40Async" Version="5.7.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Polly.Net40Async --version 5.7.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

v5.0 is a major release with significant new resilience policies: Timeout; Bulkhead Isolation; Fallback; Cache; and PolicyWrap.  See release notes back to v5.0.0 for full details.

    5.7.0
    ---------------------
    - Minor cache fixes
    - Add ability to calculate cache Ttl based on item to cache
    - Allow user-created custom policies

    5.6.1
    ---------------------
    - Extend PolicyWrap syntax with interfaces
    
    5.6.0
    ---------------------
    - Add ability to handle inner exceptions natively: .HandleInner<TEx>()
    - Allow WaitAndRetry policies to calculate wait based on the handled fault
    - Add the ability to access the policies within an IPolicyWrap
    - Allow PolicyWrap to take interfaces as parameters
    - Bug fix: set context keys for generic execute method with PolicyWrap
    - Bug fix: generic TResult method with non-generic fallback policy
    - Performance improvements

    5.5.0
    ---------------------
    - Bug fix: non-generic CachePolicy with PolicyWrap
    - Add Cache interfaces

    5.4.0
    ---------------------
    - Add CachePolicy: cache-aside pattern, with interfaces for pluggable cache providers and serializers.
    - Bug fix: Sync TimeoutPolicy in pessimistic mode no longer interposes AggregateException.
    - Provide public factory methods for PolicyResult, to support testing.
    - Fallback delegates can now take handled fault as input parameter.

    5.3.1
    ---------------------
    - Make ISyncPolicy<TResult> public
    - (Upgrade solution to msbuild15)
    
    5.3.0
    ---------------------
    - Fix ExecuteAndCapture() usage with PolicyWrap   
    - Allow Fallback delegates to take execution Context
    - Provide IReadOnlyPolicyRegistry interface

    5.2.0
    ---------------------
    - Add PolicyRegistry for storing and retrieving policies.
    - Add interfaces by policy type and execution type.
    - Change .NetStandard minimum support to NetStandard1.1.

    5.1.0
    ---------------------
    - Allow different parts of a policy execution to exchange data via a mutable Context travelling with each execution.

    5.0.6
    ---------------------
    - (.NETStandard1.0 changes only.)

    5.0.5
    ---------------------
    - Bug fix: Prevent request stampede during half-open state of CircuitBreaker and AdvancedCircuitBreaker.  Enforce only one new trial call per break duration, during half-open state.
    - Bug fix: Prevent duplicate raising of the onBreak delegate, if executions started when a circuit was closed, return faults when a circuit has already opened.
    - Optimisation: Optimise hotpaths for Circuit-Breaker, Retry and Fallback policies.
    - Add NoOpPolicy: NoOpPolicy executes delegates without intervention; for eg stubbing out Polly in unit testing.

    5.0.4 pre
    ---------------------
    - Fix Microsoft.Bcl and Nito.AsyncEx dependencies for Polly.Net40Async.

    5.0.3 RTM
    ---------------------
    - Refine implementation of cancellable synchronous WaitAndRetry
    - Minor breaking change: Where a user delegate does not observe cancellation, Polly will now honour the delegate's outcome rather than throw for the unobserved cancellation (issue 188).

    5.0.2 alpha
    ---------------------
    - Add full specs support for .NET40.
    - Fix issue 179: Make Net4.0 async implementation for Bulkhead truly async.

    5.0.1 alpha
    ---------------------
    - (Add a .NETStandard1.0 target.)

    5.0.0 alpha
    ---------------------
    A major release, adding significant new resilience policies:
    - Timeout policy: allows timing out any execution
    - Bulkhead isolation policy: limits the resources consumable by governed actions, such that a faulting channel cannot cause cascading failures.
    - Fallback policy: provides for a fallback execution or value, in case of overall failure
    - PolicyWrap: allows flexibly combining Policy instances of any type, to form an overall resilience strategy.

    Other changes include:
    - Add PolicyKeys and context to all policy executions, for logging and to support later introduction of policy events and metrics.
    - Add CancellationToken support to synchronous executions.
    - Add some missing ExecuteAndCapture/Async overloads.
    - Remove invalid ExecuteAsync overloads taking (but not making use of) a CancellationToken
    - Provide .NET4.0 support uniquely through Polly.NET40Async package
    - Retire ContextualPolicy (not part of documented API; support now in Policy base class)
    - Discontinue .NET3.5 support

     4.3.0
     ---------------------
     - Added ability for policies to handle return results.  Optimised circuit-breaker hot path.  Fixed circuit-breaker threshold bug.  

     4.2.4
     ---------------------
     - Added overloads to WaitAndRetry and WaitAndRetryAsync methods that accept an onRetry delegate which includes the attempt count.

     4.2.3
     ---------------------
     - Cleaned up new Polly.Net40Async NuGet package, removing Polly.dll and unused framework folders.

     4.2.2
     ---------------------
     - Add new Polly.Net40Async project supporting async for .NET40 via Microsoft.Bcl.Async.  This is available as separate Nuget packages Polly.Net40Async and Polly.Net40Async-signed.

Version History

Version Downloads Last updated
5.9.0 8,758 4/9/2018
5.8.0 4,617 1/31/2018
5.7.0 780 1/6/2018
5.6.1 1,327 11/29/2017
5.6.0 207 11/27/2017
5.5.0 786 11/3/2017
5.4.0 220 11/1/2017
5.3.1 37,088 8/6/2017
5.3.0 250 7/27/2017
5.2.0 1,025 6/28/2017
5.1.1-v5-x-cachealpha0001 200 6/2/2017
5.1.0 1,388 5/4/2017
5.0.6 15,936 2/11/2017
5.0.5 285 2/4/2017
5.0.4-pre 302 1/17/2017
5.0.3 300 1/6/2017
5.0.2-v5-0-alpha0001 300 11/22/2016
5.0.1-v5-0-alpha0001 279 10/25/2016
4.3.0 11,580 6/30/2016
4.2.4 973 6/17/2016
4.2.3 440 6/7/2016
4.2.2 404 6/2/2016