This repository provides sample implementations of using the Polly library in a .NET application.

The intent of this project is to help newcomers kick-start the use of Polly within their own projects.

The samples demonstrate the policies in action, against faulting endpoints.

The solution contains three applications and one class library:

• PollyTestWebApi: This application is a web API with several endpoints. (Further information)
• PollyDemos: This library contains the Polly demos. (Further information)
• PollyTestClientConsole: This application provides a CLI to walk through the demos. (Further information)
• PollyTestClientWpf: This application provides a GUI to walk through the demos. (Further information)

flowchart LR
    console{{PollyTestClientConsole}}
    wpf{{PollyTestClientWPF}}
    lib>PollyDemos]
    api[/PollyTestWebApi\]

    console -- uses --> lib
    wpf -- uses --> lib
    lib -- invokes --> api

• The demos run against an example 'faulting server'.
  • To simulate failure, the dummy server rejects more than 3 calls in any five-second period.
• Be sure to read the <summary> at the top of each demo.
  • This explains the intent of that demo, and what resilience it adds to its handling of the calls to the 'faulting server'.
• Sometimes the <summary> also highlights what this demo doesn't achieve, which is often picked up in the following demo.
• Explore the demos in sequence for best understanding.

• For any questions about the operation of the demos, ask on this repo with an issue.
• For any questions about Polly, ask in the Polly repository.
• For full Polly syntax, see Polly repository and the Polly documentation.

View the slides presented at NDC, DevIntersections and other conferences.

You are welcome to use and adapt this presentation for not-for-profit presentations of Polly to co-workers, user groups and similar, subject to the condition that references to the .NET Foundation, App-vNext and the individual members of the Polly team are retained.