使用xUnit.net進行數據驅動的單元測試

目前在.Net框架下的測試工具主要有Nunit、內置的MSTest以及xUnit這三個工具,本文就簡單的介紹一下如何在VS中使用xUnit進行數據驅動的單元測試。

1. 安裝

直接使用NuGet安裝如下兩個庫即可:

PM> Install-Package xunit
PM> Install-Package xunit.runner.visualstudio -Pre (Visual Studio測試瀏覽器支持, VS2015目前必須裝Pre的)

2.搭建項目

新建一個類庫項目包含兩個目錄,分別存放:

TestDatas文件夾:測試需要的數據及其類型
UnitTests文件夾:單元測試

目錄結構

測試數據采用csv格式,好處是可以使用Excel進行編輯,同時數據結構易于解析。
ProviderTypeData_AddProviderType.csv文件在Excel中和VS中編輯的結果如下:

Excel中的測試數據
在VS中打開后的格式

3.解析數據

需要有一個CSVFileHelper基礎類來將csv格式的數據轉換成DataTable。

public static class CSVFileHelper
{
        public static DataTable OpenCSV(string filePath)
        {
            //Encoding encoding = Common.GetType(filePath); //Encoding.ASCII;//
            DataTable dt = new DataTable();
            FileStream fs = new FileStream(filePath, System.IO.FileMode.Open, System.IO.FileAccess.Read);
            StreamReader sr = new StreamReader(fs, System.Text.Encoding.GetEncoding("GB2312"));
            //StreamReader sr = new StreamReader(fs, encoding);
            //string fileContent = sr.ReadToEnd();
            //encoding = sr.CurrentEncoding;
            //記錄每次讀取的一行記錄
            string strLine = "";
            //記錄每行記錄中的各字段內容
            string[] aryLine = null;
            string[] tableHead = null;
            //標示列數
            int columnCount = 0;
            //標示是否是讀取的第一行
            bool IsFirst = true;
            //逐行讀取CSV中的數據
            while ((strLine = sr.ReadLine()) != null)
            {
                //strLine = Common.ConvertStringUTF8(strLine, encoding);
                //strLine = Common.ConvertStringUTF8(strLine);

                if (IsFirst == true)
                {
                    tableHead = strLine.Split(',');
                    IsFirst = false;
                    columnCount = tableHead.Length;
                    //創建列
                    for (int i = 0; i < columnCount; i++)
                    {
                        DataColumn dc = new DataColumn(tableHead[i]);
                        dt.Columns.Add(dc);
                    }
                }
                else
                {
                    aryLine = strLine.Split(',');
                    DataRow dr = dt.NewRow();
                    for (int j = 0; j < columnCount; j++)
                    {
                        dr[j] = aryLine[j];
                    }
                    dt.Rows.Add(dr);
                }
            }
            if (aryLine != null && aryLine.Length > 0)
            {
                dt.DefaultView.Sort = tableHead[0] + " " + "asc";
            }

            sr.Close();
            fs.Close();
            return dt;
        }
}

4.定義數據類型

有了測試數據和數據轉換工具還不夠,還需要一個能被xUnit使用的類型,就是目錄結構中的ProviderTypeData類。

public class ProviderTypeData : TheoryData<string, string, string>
{
        public ProviderTypeData(string csvPath)
        {
            var path = Common.CurrentPath + csvPath;
            var dt = CSVFileHelper.OpenCSV(path);
            foreach (DataRow dr in dt.Rows)
            {
                Add(dr[0].ToString(), dr[1].ToString(), dr[2].ToString());
            }
        }
}

父類TheoryData的泛型參數與數據源的列一一對應,測試數據有三列,所以就有三個泛型參數。
然后使用父類的Add方法加載解析好的數據。

5.編寫測試

public class ProviderTypeTest
{
        //測試數據
        public static ProviderTypeData providerTypeData_AddProviderType = new ProviderTypeData(
            "\\TestDatas\\ProviderTypeData_AddProviderType.csv");

        public ProviderTypeTest()
        {
        }

        [Trait("TPS", "供應商分類")]
        [Theory(DisplayName = "0001_驗證數據_空數據_拋出")]
        [MemberData("providerTypeData_AddProviderType")]
        public void ValidData_EmptyData_ThrowException(
            string providerTypeName, string providerCode, string parentCode)
        {
            //do test
        }
}

簡單說明一下:
1.測試數據需要是公共靜態屬性,在聲明時實例化。
2.xUnit與MSTest在特性和斷言的使用上有區別,見附錄。
3.Trait特性聲明了測試的分類,可以在VS的測試資源管理器中按特征查看。

選擇特征
效果

4.Theory特性聲明當前測試方法需要測試數據作為參數。
5.如果定義了Skip的值,那么測試將會被自動跳過。

[Theory(DisplayName = "0001_驗證數據_空數據_拋出", Skip = "未完成")]
被跳過的測試

6.MemberData特性聲明了測試需要的數據源。

調試測試,結果如下:

調試測試結果

有三條測試數據,就會執行三次測試,測試結果如下:

測試結果

(請忽略測試的時間,因為我在截圖調試結果)
以上,我們就可以實現數據驅動的測試。

附錄

Attribute標記對比:

NUnit 2.2 | MSTest | xUnit.net | 備注
-|-|-
[Test] | [TestMethod] | [Fact] | 標記為測試方法
[TestFixture] | [TestClass] | n/a | 包含有測試方法的類,在xUnit.net中無需標記,它會查找程序集中所有的public的測試方法
[ExpectedException] | [ExpectedException] | Assert.Throws/ Record.Exception | 期望拋出異常
[SetUp] | [TestInitialize] | Constructor(即構造函數) | 在每個測試方法執行之前用于初始化的方法
[TearDown] | [TestCleanup] | IDisposable.Dispose | 在每個測試方法執行之后用于結束的方法
[TestFixtureSetUp] | [ClassInitialize] | IUseFixture<T> | 在所有測試方法執行之前用于初始化的方法
[TestFixtureTearDown] | [ClassCleanup] | IUseFixture<T> | 在所有測試方法執行之后用于結束的方法
[Ignore] | [Ignore] | [Fact(Skip="reason")] | 臨時忽略被標記的方法
n/a | [Timeout] | [Fact(Timeout=n)] | 用于指定被測試方法的最大執行時間(單位毫秒),如果超過指定時間則會被標記為測試失敗
[Property] | [TestProperty] | [Trait] | 設置特征
n/a | [DataSource] | [Theory], [XxxData] | 測試數據

Assertions斷言對比:

NUnit 2.2 | MSTest | xUnit.net | 備注
-|-|-
AreEqual | AreEqual | Equal | 相等比較
AreNotEqual | AreNotEqual | NotEqual | 不相等比較
AreNotSame | AreNotSame | NotSame | 不相同比較
AreSame | AreSame | Same | 相同比較
Contains | Contains (on CollectionAssert) | Contains | 包含
DoAssert | n/a | n/a |
n/a | DoesNotContain (on CollectionAssert) | DoesNotContain | 不包含
n/a | n/a | DoesNotThrow | 沒有拋異常
Fail | Fail | n/a | 可用Assert.True(false, "message")替代
Greater | n/a | n/a | 可用Assert.True(x > y)替代
Ignore | Inconclusive | n/a |
n/a | n/a | InRange | 確保數據在某個范圍內
IsAssignableFrom | n/a | IsAssignableFrom |
IsEmpty | n/a | Empty | 為空
IsFalse | IsFalse | False | 為假
IsInstanceOfType | IsInstanceOfType | IsType |
IsNaN | n/a | n/a | 可用Assert.True(double.IsNaN(x))替代
IsNotAssignableFrom | n/a | n/a | 可用Assert.False(obj is Type)替代
IsNotEmpty | n/a | NotEmpty | 不為空
IsNotInstanceOfType | IsNotInstanceOfType | IsNotType |
IsNotNull | IsNotNull | NotNull |
IsNull | IsNull | Null |
IsTrue | IsTrue | True |
Less | n/a | n/a | 可用Assert.True(x < y)替代
n/a | n/a | NotInRange | 確保數據在不某個范圍內
n/a | n/a | Throws | 確保會拋出異常

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,967評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,273評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,870評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,742評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,527評論 6 407
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,010評論 1 322
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,108評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,250評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,769評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,656評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,853評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,371評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,103評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,472評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,717評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,487評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,815評論 2 372

推薦閱讀更多精彩內容