Steelax.XUnit.v3.Flaky
0.1.1
dotnet add package Steelax.XUnit.v3.Flaky --version 0.1.1
NuGet\Install-Package Steelax.XUnit.v3.Flaky -Version 0.1.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="Steelax.XUnit.v3.Flaky" Version="0.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Steelax.XUnit.v3.Flaky" Version="0.1.1" />
<PackageReference Include="Steelax.XUnit.v3.Flaky" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Steelax.XUnit.v3.Flaky --version 0.1.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Steelax.XUnit.v3.Flaky, 0.1.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.
#:package Steelax.XUnit.v3.Flaky@0.1.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Steelax.XUnit.v3.Flaky&version=0.1.1
#tool nuget:?package=Steelax.XUnit.v3.Flaky&version=0.1.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Steelax.XUnit.v3.Flaky
Overview
[FlakyFact] and [FlakyTheory] are test attributes for xUnit v3 that run a test multiple times to detect instability in the implementation under test (for example, a race condition).
Behavior:
- the test is executed up to
ntimes, wherenis theretriesBeforeFailconstructor argument (default: 3); - the test is reported as passed only if every attempt passes;
- if any attempt fails, the test is immediately reported as failed.
The attributes do not mask failures: an unstable test continues to fail, making the instability visible.
Usage
[FlakyFact(n)] is used instead of [Fact], [FlakyTheory(n)] instead of [Theory].
using Steelax.XUnit.v3.Flaky.Attributes;
[FlakyFact(42)]
public void SynchronousTest()
{
// implementation under test
}
[FlakyFact(42)]
public async Task AsynchronousTest()
{
// implementation under test
}
[FlakyTheory(42)]
[InlineData(true)]
[InlineData(false)]
public async Task TheoryTest(bool value)
{
// implementation under test
}
Limitations
- if a test mutates shared state, subsequent attempts run with modified state, which can produce misleading results;
- stateful tests should be reviewed before being marked with these attributes.
| 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. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | 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 | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- xunit.v3.extensibility.core (>= 4.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Initial release.