Skip to content

Retry running tests via Xunit and Specflow

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE.md
Notifications You must be signed in to change notification settings

Calrom-Ltd/nRetry.Core

 
 

Repository files navigation

xRetry for NUnit

Retry flickering test cases for NUnit and SpecFlow.

CI/CD

When to use this

This is intended for use on flickering tests, where the reason for failure is an external dependency and the failure is transient, e.g:

  • HTTP request over the network
  • Database call that could deadlock, timeout etc...

Whenever a test includes real-world infrastructure, particularly when communicated with via the internet, there is a risk of the test randomly failing so we want to try and run it again. This is the intended use case of the library.

If you have a test that covers some flaky code, where sporadic failures are caused by a bug, this library should not be used to cover it up!

Usage: SpecFlow 3

Add the nRetry.Core.SpecFlowPlugin nuget package to your project.

nuget.org link: https://www.nuget.org/packages/nRetry.SpecFlowPlugin/

Above any scenario that should be retried, add a @retry tag, e.g:

@retry
Scenario: Retry three times by default
	When I increment the default retry count
	Then the default result should be 3

This will retry the test up to 3 times by default. You can optionally specify a number of times to retry the test in brackets, e.g. @retry(5).

Contributing

Feel free to open a pull request! If you want to start any sizeable chunk of work, consider opening an issue first to discuss, and make sure nobody else is working on the same problem.

Running locally

To run locally, always build xRetry.NUnit.SpecFlowPlugin before the tests, to ensure MSBuild uses the latest version of your changes.

If you install make and go to the build directory, you can run the following from the terminal to build, run tests and create the nuget packages:

make build unit-tests-run nuget-create

If that works, all is well!

Licence

MIT

About

Retry running tests via Xunit and Specflow

Resources

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE.md

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 88.9%
  • Makefile 5.3%
  • Gherkin 3.6%
  • Shell 2.2%