NUnitと同様のxUnit.netでのパラメーター化のテスト


106

xUnit.netフレームワークには、NUnitの以下の機能に類似した手段はありますか?

[Test, TestCaseSource("CurrencySamples")]
public void Format_Currency(decimal value, string expected){}

static object[][] CurrencySamples = new object[][]
{
    new object[]{ 0m, "0,00"},
    new object[]{ 0.0004m, "0,00"},
    new object[]{ 5m, "5,00"},
    new object[]{ 5.1m, "5,10"},
    new object[]{ 5.12m, "5,12"},
    new object[]{ 5.1234m, "5,12"},
    new object[]{ 5.1250m, "5,13"}, // round
    new object[]{ 5.1299m, "5,13"}, // round
}

これにより、NUnit GUIで8つの個別のテストが生成されます

[TestCase((string)null, Result = "1")]
[TestCase("", Result = "1")]
[TestCase(" ", Result = "1")]
[TestCase("1", Result = "2")]
[TestCase(" 1 ", Result = "2")]
public string IncrementDocNumber(string lastNum) { return "some"; }

これにより、5つの個別のテストが生成され、結果が自動的に比較されます(Assert.Equal())。

[Test]
public void StateTest(
    [Values(1, 10)]
    int input,
    [Values(State.Initial, State.Rejected, State.Stopped)]
    DocumentType docType
){}

これにより、6つの組み合わせテストが生成されます。貴重な。

数年前、私はxUnitを試して気に入ったが、これらの機能が欠けていた。それらなしでは生きられない。何か変わった?


単体テストで複雑なオブジェクトをパラメーターとしてTestメソッドの複雑な型に
Iman Bahrampour

回答:


138

xUnitは、データ理論と呼ばれるものを通じてパラメーター化されたテストを実行する方法を提供します。このコンセプトはNUnitにあるものと同等ですが、そのまま使用できる機能は完全ではありません。

次に例を示します。

[Theory]
[InlineData("Foo")]
[InlineData(9)]
[InlineData(true)]
public void Should_be_assigned_different_values(object value)
{
    Assert.NotNull(value);
}

この例では、xUnitは指定された値を引数として渡すShould_format_the_currency_value_correctlyたびにテストを実行InlineDataAttributeします。

データ理論は、パラメーター化されたテストを実行する新しい方法を作成するために使用できる拡張ポイントです。これを行う方法は、検査し、オプションでテストメソッドの引数と戻り値に作用する新しい属性作成することです。

AutoFixtureAutoDataおよびInlineAutoData理論でxUnitのデータ理論を拡張する方法の良い実用的な例を見つけることができます。


3
どうやら、属性パラメーターとして10進リテラルを使用することは許可されいません
2013

1
@RubenBartelinkリンクが見つかりません。代わりにここに行ってください:blog.benhall.me.uk/2008/01/introduction-to-xunit-net-extensions
Ronnie Overby

9
あなたは必要があります拡張機能:xUnit.net(NuGetパッケージ)またはその他の[Theory]属性が利用できませんが。
Daniel AA Pelsmaeker 2014

4
最も推奨.NETユニットテストフレームワークは、いくつかのドキュメントを持っていた場合、それは素晴らしいことだ...
アイザック・クレインマン

6
Googleは、あなたのSOの答えはxUnitのドキュメントだと言っています。
nathanchere 2014

55

誰かに時間を節約するために、ここにもう1つのサンプルを示します。

[Theory]
[InlineData("goodnight moon", "moon", true)]
[InlineData("hello world", "hi", false)]
public void Contains(string input, string sub, bool expected)
{
    var actual = input.Contains(sub);
    Assert.Equal(expected, actual);
}

2行目の閉じ括弧を忘れましたか?
cs0815

便利、ありがとう:)
Zeek2

21

最初のリクエストで、ここにある例に従ってください

テストのコレクションに必要なデータを含む静的クラスを構築できます

using System.Collections.Generic;

namespace PropertyDataDrivenTests
{
    public static class DemoPropertyDataSource
    {
        private static readonly List<object[]> _data = new List<object[]>
            {
                new object[] {1, true},
                new object[] {2, false},
                new object[] {-1, false},
                new object[] {0, false}
            };

        public static IEnumerable<object[]> TestData
        {
            get { return _data; }
        }
    }
}

次に、MemberData属性を使用して、テストをそのように定義します

public class TestFile1
{
    [Theory]
    [MemberData("TestData", MemberType = typeof(DemoPropertyDataSource))]
    public void SampleTest1(int number, bool expectedResult)
    {
        var sut = new CheckThisNumber(1);
        var result = sut.CheckIfEqual(number);
        Assert.Equal(result, expectedResult);
    }
}

または、C#6.0を使用している場合は、

[Theory]
[MemberData(nameof(PropertyDataDrivenTests.TestData), MemberType = typeof(DemoPropertyDataSource))]

MemberDataAttributeの最初の引数を使用すると、データソースとして使用するメンバーを定義できるため、再利用にかなりの柔軟性があります。


13

xUnitのこの記事によると 3つの「パラメーター化」オプションがあります。

  1. InlineData
  2. ClassData
  3. MemberData

InlineDataの例

[Theory]
[InlineData(1, 2)]
[InlineData(-4, -6)]
[InlineData(2, 4)]
public void FooTest(int value1, int value2)
{
    Assert.True(value1 + value2 < 7)
}

ClassDataの例

public class BarTestData : IEnumerable<object[]>
{
    public IEnumerator<object[]> GetEnumerator()
    {
        yield return new object[] { 1, 2 };
        yield return new object[] { -4, -6 };
        yield return new object[] { 2, 4 };
    }

    IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}


[Theory]
[ClassData(typeof(BarTestData))]
public void BarTest(int value1, int value2)
{
    Assert.True(value1 + value2 < 7)
}

MemberDataの例

[Theory]
[MemberData(nameof(BazTestData))]
public void BazTest(int value1, int value2)
{
    Assert.True(value1 + value2 < 7)
}

public static IEnumerable<object[]> BazTestData => new List<object[]>
    {
        new object[] { 1, 2 },
        new object[] { -4, -6 },
        new object[] { 2, 4 },
    };

12

Xunit.Combinatorial[Values]と呼ばれるNUnitの属性と同等の機能を生成するライブラリを見つけました。

パラメータレベルの値を指定できます。

[Theory, CombinatorialData]
public void CheckValidAge([CombinatorialValues(5, 18, 21, 25)] int age, 
    bool friendlyOfficer)
{
    // This will run with all combinations:
    // 5  true
    // 18 true
    // 21 true
    // 25 true
    // 5  false
    // 18 false
    // 21 false
    // 25 false
}

または、可能なすべての組み合わせをカバーするために、呼び出しの最小数を暗黙的に把握させることもできます。

[Theory, PairwiseData]
public void CheckValidAge(bool p1, bool p2, bool p3)
{
    // Pairwise generates these 4 test cases:
    // false false false
    // false true  true
    // true  false true
    // true  true  false
}

6

ここにすべての回答を搭載し、さらにXUnitのTheoryData<,>ジェネリック型を利用して、次の例のように、テストの「MemberData」属性のシンプルで読みやすく、タイプセーフなデータ定義を提供しました。

/// must be public & static for MemberDataAttr to use
public static TheoryData<int, bool, string> DataForTest1 = new TheoryData<int, bool, string> {
    { 1, true, "First" },
    { 2, false, "Second" },
    { 3, true, "Third" }
};

[Theory(DisplayName = "My First Test"), MemberData(nameof(DataForTest1))]
public void Test1(int valA, bool valB, string valC)
{
    Debug.WriteLine($"Running {nameof(Test1)} with values: {valA}, {valB} & {valC} ");
}

「My First Test」のテストエクスプローラーから観察された3つのテスト実行


.NET CoreでのVS2017(15.3.3)、C#7、およびXUnit 2.2.0の使用


これは素敵です。
Brett Rowberry
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.