https://github.com/aarnott/xunit.combinatorial

Adds combinatorial and pairwise testing capability to Xunit tests
https://github.com/aarnott/xunit.combinatorial

combinatorial-testing pairwise-testing testing

Last synced: 5 days ago
JSON representation

Adds combinatorial and pairwise testing capability to Xunit tests

• Host: GitHub
• URL: https://github.com/aarnott/xunit.combinatorial
• Owner: AArnott
• License: other
• Created: 2015-07-18T22:48:24.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2025-01-25T07:57:39.000Z (11 days ago)
• Last Synced: 2025-01-31T19:11:23.564Z (5 days ago)
• Topics: combinatorial-testing, pairwise-testing, testing
• Language: C#
• Homepage: https://aarnott.github.io/Xunit.Combinatorial/
• Size: 1.04 MB
• Stars: 190
• Watchers: 6
• Forks: 16
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Xunit.Combinatorial

This project allows for parameterizing your Xunit test methods such that

they run multiple times, once for each combination of possible arguments

for your test method. You can also limit the number of test cases by using

a pairwise strategy, which generally provides good coverage for testing

but significantly reduces the test case explosion you might have when

you have more than two parameters.

[![NuGet package](https://img.shields.io/nuget/v/xunit.combinatorial.svg)][NuPkg]

[![🏭 Build](https://github.com/AArnott/Xunit.Combinatorial/actions/workflows/build.yml/badge.svg)](https://github.com/AArnott/Xunit.Combinatorial/actions/workflows/build.yml)

## Installation

This project is available as a [NuGet package][NuPkg].

The v1.x versions of this package support xunit 2.

The v2.x versions of this package support xunit 3.

## Example

Suppose you have this test method:

```cs

[Fact]

public void CheckFileSystem(bool recursive)

{

    // verifications here

}

```

To arrange for your test method to be invoked twice, once for each value

of its bool parameter, change the attributes to:

```cs

[Theory, CombinatorialData]

public void CheckFileSystem(bool recursive)

{

    // verifications here

}

```

The `CombinatorialDataAttribute` will supply Xunit with both `true` and `false`

arguments to run the test method with, resulting in two invocations of your

test method with individual results reported for each invocation.

[Learn much more on our docs site](https://aarnott.github.io/Xunit.Combinatorial/).

## Sponsorships

[](https://api.gitsponsors.com/api/badge/link?p=nQjHytizvrezRojvV3fOirqAIJM1LYRsFSv208TTn19R5MAVU0p6fpbgW+hOMXyLl+06sL2V01oX4R2bQ+xir+mXorf4xVZORfyr3vfloWZladXrowLaLYXNkHt0yqluvqLeY5Myfe40/lQwskGLJw==)

[GitHub Sponsors](https://github.com/sponsors/AArnott)

[Zcash](zcash:u1vv2ws6xhs72faugmlrasyeq298l05rrj6wfw8hr3r29y3czev5qt4ugp7kylz6suu04363ze92dfg8ftxf3237js0x9p5r82fgy47xkjnw75tqaevhfh0rnua72hurt22v3w3f7h8yt6mxaa0wpeeh9jcm359ww3rl6fj5ylqqv54uuwrs8q4gys9r3cxdm3yslsh3rt6p7wznzhky7)

[NuPkg]: https://www.nuget.org/packages/Xunit.Combinatorial