Polly 7.0.3
Prefix ReservedSee the version list below for details.
dotnet add package Polly --version 7.0.3
NuGet\Install-Package Polly -Version 7.0.3
<PackageReference Include="Polly" Version="7.0.3" />
paket add Polly --version 7.0.3
#r "nuget: Polly, 7.0.3"
// Install Polly as a Cake Addin #addin nuget:?package=Polly&version=7.0.3 // Install Polly as a Cake Tool #tool nuget:?package=Polly&version=7.0.3
Polly is a .NET Standard 1.1 and .NET Standard 2.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.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
| .NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard1.1 is compatible. netstandard1.2 was computed. netstandard1.3 was computed. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net45 was computed. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
| Universal Windows Platform | uap was computed. uap10.0 was computed. |
| Windows Phone | wpa81 was computed. |
| Windows Store | netcore was computed. netcore45 was computed. netcore451 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 1.1
- NETStandard.Library (>= 1.6.1)
- System.ValueTuple (>= 4.5.0)
-
.NETStandard 2.0
- No dependencies.
NuGet packages (2.7K)
Showing the top 5 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/af22effae4069a5dfb9b0735859de48820104f5b |
|
|
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. |
|
|
Polly.Caching.Memory
Polly.Caching.Memory is a plug-in for the .NET OSS resilience library Polly, supporting Microsoft.Extensions.Caching.Memory.MemoryCache as a provider for Polly's CachePolicy. |
|
|
SheshaMobile.Core
Common application functionality and features to be shared across the framework |
|
|
Okta.Sdk
Official .NET SDK for the Okta API |
GitHub repositories (235)
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 |
|---|---|---|
| 8.5.0 | 292,429 | 11/12/2024 |
| 8.4.2 | 4,059,190 | 9/26/2024 |
| 8.4.1 | 11,494,915 | 6/28/2024 |
| 8.4.0 | 8,664,134 | 5/10/2024 |
| 8.3.1 | 12,238,155 | 3/6/2024 |
| 8.3.0 | 8,291,799 | 2/5/2024 |
| 8.2.1 | 6,264,458 | 1/5/2024 |
| 8.2.0 | 11,252,142 | 11/14/2023 |
| 8.1.0 | 4,441,061 | 10/31/2023 |
| 8.0.0 | 9,281,370 | 9/28/2023 |
| 8.0.0-beta.2 | 65,257 | 9/8/2023 |
| 8.0.0-beta.1 | 11,179 | 8/31/2023 |
| 8.0.0-alpha.9 | 3,409 | 8/30/2023 |
| 8.0.0-alpha.8 | 40,782 | 8/8/2023 |
| 8.0.0-alpha.7 | 12,884 | 7/26/2023 |
| 8.0.0-alpha.6 | 55,016 | 7/14/2023 |
| 8.0.0-alpha.5 | 22,931 | 7/3/2023 |
| 8.0.0-alpha.4 | 3,922 | 6/26/2023 |
| 8.0.0-alpha.3 | 762 | 6/23/2023 |
| 8.0.0-alpha.2 | 6,841 | 6/21/2023 |
| 8.0.0-alpha.1 | 4,846 | 6/15/2023 |
| 7.2.4 | 50,736,404 | 6/14/2023 |
| 7.2.3 | 157,822,812 | 1/17/2022 |
| 7.2.2 | 114,489,886 | 4/11/2021 |
| 7.2.1 | 79,872,844 | 5/2/2020 |
| 7.2.0 | 44,402,964 | 11/27/2019 |
| 7.1.1 | 18,920,725 | 9/2/2019 |
| 7.1.0 | 102,826,237 | 3/13/2019 |
| 7.0.3 | 1,900,215 | 2/21/2019 |
| 7.0.2 | 1,001,624 | 2/11/2019 |
| 7.0.1 | 1,384,757 | 2/9/2019 |
| 6.1.2 | 12,525,012 | 11/27/2018 |
| 6.1.1 | 1,050,867 | 11/12/2018 |
| 6.1.0 | 9,775,814 | 7/15/2018 |
| 6.0.1 | 24,501,057 | 5/6/2018 |
| 6.0.0-v6alpha0001 | 10,661 | 5/3/2018 |
| 5.9.0 | 5,957,233 | 4/9/2018 |
| 5.8.0 | 4,995,519 | 1/31/2018 |
| 5.7.0 | 930,575 | 1/6/2018 |
| 5.6.1 | 1,614,879 | 11/29/2017 |
| 5.6.0 | 101,913 | 11/27/2017 |
| 5.5.0 | 1,202,541 | 11/3/2017 |
| 5.4.0 | 150,534 | 11/1/2017 |
| 5.3.1 | 4,419,808 | 8/6/2017 |
| 5.3.0 | 259,083 | 7/27/2017 |
| 5.2.0 | 612,622 | 6/28/2017 |
| 5.1.1-v5-x-cachealpha0001 | 56,584 | 6/2/2017 |
| 5.1.0 | 1,057,761 | 5/4/2017 |
| 5.0.6 | 1,060,435 | 2/11/2017 |
| 5.0.5 | 510,399 | 2/4/2017 |
| 5.0.3 | 955,252 | 1/6/2017 |
| 5.0.2-v5-0-alpha0001 | 19,420 | 11/22/2016 |
| 5.0.1-v5-0-alpha0001 | 20,624 | 10/25/2016 |
| 4.5.0-beta-netstandar-0001 | 30,495 | 9/6/2016 |
| 4.3.0 | 2,308,147 | 6/30/2016 |
| 4.2.4 | 55,878 | 6/17/2016 |
| 4.2.3 | 44,511 | 6/7/2016 |
| 4.2.2 | 19,741 | 6/2/2016 |
| 4.2.1 | 146,530 | 5/26/2016 |
| 4.2.0 | 217,727 | 4/14/2016 |
| 4.1.2 | 283,237 | 3/17/2016 |
| 4.1.1 | 37,412 | 3/11/2016 |
| 4.1.0 | 9,396 | 3/10/2016 |
| 4.0.0 | 91,432 | 2/18/2016 |
| 3.0.0 | 88,678 | 1/11/2016 |
| 2.2.7 | 69,465 | 1/1/2016 |
| 2.2.6 | 9,698 | 12/30/2015 |
| 2.2.5 | 17,645 | 12/28/2015 |
| 2.2.4 | 60,829 | 12/3/2015 |
| 2.2.3 | 225,456 | 8/9/2015 |
| 2.2.2 | 131,140 | 6/2/2015 |
| 2.2.1 | 90,542 | 2/15/2015 |
| 2.2.0 | 46,527 | 1/25/2015 |
| 2.1.0 | 30,344 | 11/28/2014 |
| 2.0.0 | 36,365 | 3/13/2014 |
| 1.1.0 | 11,848 | 6/16/2013 |
| 1.0.0 | 158,237 | 5/5/2013 |
7.0.3
---------------------
- Bug fix for AdvancedCircuitBreakerAsync<TResult> (issue affecting v7.0.1-2 only)
7.0.2
---------------------
- Bug fix for PolicyRegistry (issue affecting v7.0.1 only)
7.0.1
---------------------
- Clarify separation of sync and async policies (breaking change)
- Enable extensibility by custom policies hosted external to Polly
- Enable collection initialization syntax for PolicyRegistry
- Enable cache policies to cache default(TResult) (breaking change)
- Restore Exception binary serialization for .Net Standard 2.0
6.1.2
---------------------
- Bug Fix: Async continuation control for async executions (issue 540, affected only v6.1.1)
6.1.1
---------------------
- Bug Fix: Context.PolicyKey behaviour in PolicyWrap (issue 510)
6.1.0
---------------------
- Bug Fix: Context.PolicyKey behaviour in PolicyWrap
- Bug Fix: CachePolicy behaviour with non-nullable types
- Enhancement: WaitAnd/RetryForever overloads where onRetry takes the retry number as a parameter
- Enhancement: Overloads where onTimeout takes thrown exception as a parameter
6.0.1
---------------------
- Version 6 RTM, for integration to ASPNET Core 2.1 IHttpClientFactory
6.0.0-v6alpha
---------------------
- Publish as strong-named package only (discontinue non-strong-named versions)
- Add .NetStandard 2.0 tfm
- Provide .NET4.5 support via .NetStandard 1.1 tfm
- Discontinue .NET4.0 support
- Remove methods marked as deprecated in v5.9.0
5.9.0
---------------------
- Allow Timeout.InfiniteTimeSpan (no timeout) for TimeoutPolicy.
- Add .AsPolicy<TResult> and .AsAsyncPolicy<TResult> methods for converting non-generic policies to generic policies.
- Per Semver, indicates deprecation of overloads and properties intended to be removed or renamed in Polly v6.
5.8.0
---------------------
- Add a new onBreak overload that provides the prior state on a transition to an open state
- Bug fix: RelativeTtl in CachePolicy now always returns a ttl relative to time item is cached
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
---------------------
- 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
Earlier versions
----------------
For versions prior to v5.0, please see the detailed ChangeLog on the Polly project site.