463,932

Downloads

1,256

Downloads of v 5.0.3

341

Average downloads per day

2017-01-06

Last published

Share on Social Networks

Polly

5.0.3

Polly is a .NET 4.0 / 4.5 / .NET Standard 1.0 library that allows developers to express resilience and transient fault handling policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation and Fallback in a fluent and thread-safe manner.

To install Polly, run the following command in the Package Manager Console

Install-Package Polly

Release Notes

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

    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
    ---------------------
    - .NETStandard1.0 target: Correctly state dependencies.
    - .NETStandard1.0 target: Fix SemVer stamping of Polly.dll.
    - PCL259 project and target: Remove, in favour of .NETStandard1.0 target.  PCL259 targets are still supported, via .NETStandard1.0 target.
    - Mark Polly.dll as CLSCompliant.
   
    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.

    4.2.1
    ---------------------
    - Allowed async onRetry delegates to async retry policies.

    4.2.0
    ---------------------
    - Added AdvancedCircuitBreaker - Thanks to @reisenberger and @kristianhald
   
    4.1.2
    ---------------------
    - Fixed an issue with the onReset delegate of the CircuitBreaker.
   
    4.1.1
    ---------------------
    - Add ExecuteAndCapture support with arbitrary context data - Thanks to @reisenberger
   
    4.1.0
    ---------------------
    - Add Wait and retry forever policy - Thanks to @nedstoyanov
    - Remove time-limit on CircuitBreaker state-change delegates - Thanks to @reisenberger
   
    4.0.0
    ---------------------
    - Add async support and circuit-breaker support for ContextualPolicy
    - Add manual control of circuit-breaker (reset and manual circuit isolation)
    - Add public reporting of circuit-breaker state, for health/performance monitoring
    - Add delegates on changes of circuit state - Thanks to @reisenberger
   
    3.0.0
    ---------------------
    - Add cancellation support for all async Policy execution - Thanks to @reisenberger
   
    2.2.7
    ---------------------
    - Fixes an issue where continueOnCapturedContext needed to be specified in two places (on action execution and Policy configuration), when wanting to flow async action execution on the captured context - Thanks to @reisenberger
    - Fixes excess line ending issues
   
    2.2.6
    ---------------------
    - Async sleep fix, plus added continueOnCapturedContext parameter on async methods to control whether continuation and retry will run on captured synchronization context - Thanks to @yevhen
   
    2.2.5
    ---------------------
    - Policies with a retry count of zero are now allowed
   
    2.2.4
    ---------------------
    - Add .NET Core support
   
    2.2.3
    ---------------------
    - Fix PCL implementation of `SystemClock.Reset`
    - Added ability to capture the results of executing a policy via `ExecuteAndCapture`
   
    2.2.2
    ---------------------
    - Added extra `NotOnCapturedContext` call to prevent potential deadlocks when blocking on asynchronous calls
   
    2.2.1
    ---------------------
    - Replaced non-blocking sleep implementation with a blocking one for PCL
   
    2.2.0
    ---------------------
    - Added Async Support (PCL)
    - PCL Profile updated from Profile78 ->  Profile 259
    - Added missing WaitAndRetryAsync overload
   
    2.1.0
    ---------------------
    - Added Async Support (.NET Framework 4.5 Only)
   
    2.0.0
    ---------------------
    - Added Portable Class Library
    - The "Polly" NuGet package is now no longer strongly named. The strongly named NuGet package is now "Polly-Signed"
   
    1.1.0
    ---------------------
    - Added additional overloads to Retry
    - Allow arbitrary data to be passed to policy execution

Owners

Authors

Michael Wolfenden, App vNext

Copyright

Copyright © 2016, App vNext

Tags

Dependencies

Version History

Version Downloads Last updated
Polly 5.0.2-v5-0-alpha0001 2,274 Tuesday, November 22, 2016
Polly 5.0.1-v5-0-alpha0001 3,318 Tuesday, October 25, 2016
Polly 4.5.0-beta-netstandar-0001 12,264 Tuesday, September 6, 2016
Polly 4.3.0 128,512 Thursday, June 30, 2016
Polly 4.2.4 9,681 Friday, June 17, 2016
Polly 4.2.3 7,629 Tuesday, June 7, 2016
Polly 4.2.2 2,242 Thursday, June 2, 2016
Polly 4.2.1 5,693 Thursday, May 26, 2016
Polly 4.2.0 36,710 Thursday, April 14, 2016
Polly 4.1.2 28,923 Thursday, March 17, 2016
Polly 4.1.1 5,901 Friday, March 11, 2016
Polly 4.1.0 380 Thursday, March 10, 2016
Polly 4.0.0 32,261 Thursday, February 18, 2016
Polly 3.0.0 26,564 Monday, January 11, 2016
Polly 2.2.7 7,563 Friday, January 1, 2016
Polly 2.2.6 884 Wednesday, December 30, 2015
Polly 2.2.5 2,353 Monday, December 28, 2015
Polly 2.2.4 18,855 Thursday, December 3, 2015
Polly 2.2.3 61,920 Sunday, August 9, 2015
Polly 2.2.2 20,802 Tuesday, June 2, 2015
Polly 2.2.1 19,632 Sunday, February 15, 2015
Polly 2.2.0 4,221 Sunday, January 25, 2015
Polly 2.1.0 9,041 Friday, November 28, 2014
Polly 2.0.0 12,825 Thursday, March 13, 2014
Polly 1.1.0 1,954 Sunday, June 16, 2013
Polly 1.0.0 274 Sunday, May 5, 2013