Polly 5.6.1

There is a newer version of this package available.
See the version list below for details. 
dotnet add package Polly --version 5.6.1                

                    
                

            
NuGet\Install-Package Polly -Version 5.6.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Polly" Version="5.6.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Polly --version 5.6.1                

                    
                

            
#r "nuget: Polly, 5.6.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Polly as a Cake Addin
#addin nuget:?package=Polly&version=5.6.1

// Install Polly as a Cake Tool
#tool nuget:?package=Polly&version=5.6.1

Polly is a .NET 4.5 / .NET Standard 1.1 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.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Polly:

Package Downloads
Microsoft.Extensions.Http.Polly

The HttpClient factory is a pattern for configuring and retrieving named HttpClients in a composable way. This package integrates IHttpClientFactory with the Polly library, to add transient-fault-handling and resiliency through fluent policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/e5f183b656a0e8bc087108130a5a9b54ae94494e
Polly.Extensions.Http

Polly.Extensions.Http is an extensions package containing opinionated convenience methods for configuring Polly policies to handle transient faults typical of calls through HttpClient.

GitHub repositories (237)

Showing the top 5 popular GitHub repositories that depend on Polly:

Repository Stars
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
Jackett/Jackett
API Support for your favorite torrent trackers
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
kgrzybek/modular-monolith-with-ddd
Full Modular Monolith application with Domain-Driven Design approach.
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
Version Downloads Last updated
7.2.2 65 9/19/2022
7.2.1 0 3/6/2021
7.2.0 2 3/6/2021
7.1.1 5 3/6/2021
7.1.0 32,553 3/6/2021
7.0.3 0 3/6/2021
7.0.2 0 3/6/2021
7.0.1 0 3/6/2021
7.0.1-v710-0001 0 3/6/2021
7.0.0 0 3/6/2021
6.1.2 1 3/6/2021
6.1.1 0 3/6/2021
6.1.0 2 3/6/2021
6.0.1 46,947 3/6/2021
6.0.0-v6alpha0001 0 3/6/2021
5.9.0 0 3/6/2021
5.8.0 0 3/6/2021
5.7.0 0 3/6/2021
5.6.1 0 3/6/2021
5.6.0 0 3/6/2021
5.5.0 0 3/6/2021
5.4.0 0 3/6/2021
5.3.1 79 3/6/2021
5.3.0 7 3/6/2021
5.2.0 26 3/6/2021
5.1.1-v5-x-cachealpha0001 1 3/6/2021
5.1.0 25 3/6/2021
5.0.7 3 3/6/2021
5.0.6 18 3/6/2021
5.0.5 8 3/6/2021
5.0.3 6 3/6/2021
5.0.2-v5-0-alpha0001 0 3/6/2021
5.0.1-v5-0-alpha0001 2 3/6/2021
4.5.0-beta-netstandar-0001 2 3/6/2021
4.3.0 66 3/6/2021
4.2.4 3 3/6/2021
4.2.3 0 3/6/2021
4.2.2 0 3/6/2021
4.2.1 0 3/6/2021
4.2.0 7 3/6/2021
4.1.2 6 3/6/2021
4.1.1 0 3/6/2021
4.1.0 0 3/6/2021
4.0.0 4 3/6/2021
3.0.0 1 3/6/2021
2.2.7 0 3/6/2021
2.2.6 0 3/6/2021
2.2.5 0 3/6/2021
2.2.4 1,849 12/3/2015
2.2.3 20,543 8/9/2015
2.2.2 10,880 6/2/2015
2.2.1 14,631 2/15/2015
2.2.0 3,234 1/25/2015
2.1.0 6,641 11/28/2014
2.0.0 11,909 3/13/2014
1.1.0 1,712 6/16/2013
1.0.0 163 5/5/2013

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.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
    ---------------------
    - Update NETStandard.Library dependency to latest 1.6.1 for .NetStandard1.0 target.  Resolves compatibility for some Xamarin targets.

    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
    ---------------------
    - (.NET40Async package changes only)

    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