2017-04-17

NUnit 幾個參數化測試的方式

QA 同事最近正在進行一個龐大計劃:打算將上百個單元測試,整併為一個。剛聽到這個需求,我當然是持反對意見,將那麼多測試整併成一個,一定會需要為多個測試做取最大相容性的處理,難免在測試中就會必須加上條件判斷,雖然測試看起來變少,但整併後的測試複雜度一定會變高,結果同事說那上百個測試只是 data 跟 result 不同,只是一開始寫的人沒有 OOP 的概念,所以全部都拆開,導致現在難以維護,聽完說明我就立馬改為支持整併了XD

改寫過程使用了 TestCase 、 TestCaseSource、Values、ValueSource 多種給值的做法,紀錄一下避免忘記


基本設定

  1. NUnit framework 3.6.1
  2. ASP.NET WebAPI 5.2.3 預設專案範本
    • 稍微修改一下回傳內容
    public string Get(string name)
    {
        return $"{name}:{name.Length}";
    }
    

基本 TestCase 用法

  • 測試程式
    [TestFixture()]
    public class ValuesControllerTests
    {
        [Test]
        [TestCase("Yowko", 5)]
        [TestCase("Admin", 5)]
        [TestCase("test", 4)]
    
        public void GetById(string name, int length)
        {
            // Arrange
            ValuesController controller = new ValuesController();
    
            // Act
            string result = controller.Get(name);
    
            // Assert
            Assert.AreEqual($"{name}:{length}", result);
        }
    }
    
  • 測試結果
    • Test Explorer 會將測試方法代入測試參數全部列出來,一目了然

      1testcaseresult

使用 TestFixture 改寫

  • 測試程式
    [TestFixture("YowkoTsai",9)]
    [TestFixture("SuperAdmin",10)]
    [TestFixture("TestUser",8)]
    public class ValuesControllerTests
    {
        private readonly string name;
        private readonly int length;
    
        public ValuesControllerTests(string name, int length)
        {
            this.name = name;
            this.length = length;
        }
        public void GetById()
        {
            // Arrange
            ValuesController controller = new ValuesController();
    
            // Act
            string result = controller.Get(name);
    
            // Assert
            Assert.AreEqual($"{name}:{length}", result);
        }
    }
    
  • 改寫結果
    • Test Explorer 會列出測試方式及執行次數,但不會代入參數值
    • 如果有多個測試方法可以全部套用

      2texttextureresult

使用 TestCaseSource 改寫

  • 測試程式
    [TestFixture()]
    public class ValuesControllerTests
    {
    
        private static IEnumerable<TestCaseData> DataSources()
        {
            yield return new TestCaseData("Yowko", 5);
            yield return new TestCaseData("Admin", 5);
            yield return new TestCaseData("test", 4);
        }
    
    
        [Test, TestCaseSource("DataSources")]
    
        public void GetById(string name, int length)
        {
            // Arrange
            ValuesController controller = new ValuesController();
    
            // Act
            string result = controller.Get(name);
    
            // Assert
            Assert.AreEqual($"{name}:{length}", result);
        }
    }
    
  • 改寫結果

    3testcasesource

使用 Values 改寫

  • 測試程式
    [TestFixture()]
    public class ValuesControllerTests
    {
        [Test]
        public void GetById(
            [Values("Yowko", "LOL", "test")] string name,
            [Values(5, 3, 4)]int length)
        {
            // Arrange
            ValuesController controller = new ValuesController();
    
            // Act
            string result = controller.Get(name);
    
            // Assert
            Assert.AreEqual($"{name}:{length}", result);
        }
    }
    
  • 測試結果

    4valueresult

  • 測試案例會列出所有組合,如果需要一對一測試組合就要加上Sequential
    [TestFixture()]
    public class ValuesControllerTests
    {
        [Test, Sequential]
        public void GetById(
            [Values("Yowko", "LOL", "test")] string name,
            [Values(5, 3, 4)]int length)
        {
            // Arrange
            ValuesController controller = new ValuesController();
    
            // Act
            string result = controller.Get(name);
    
            // Assert
            Assert.AreEqual($"{name}:{length}", result);
        }
    }
    
  • 測試結果

    5valueresult

使用 ValueSource 改寫

  • 測試程式
    [TestFixture()]
    public class ValuesControllerTests
    {
        private static string[] TestNames()
        {
            return new string[] { "Yowko", "Lol", "test" };
        }
    
        private static int[] TestLengths()
        {
            return new int[] { 5, 3, 4 };
        }
        [Test]
        public void GetById([ValueSource("TestNames")] string name,
            [ValueSource("TestLengths")] int length)
        {
            // Arrange
            ValuesController controller = new ValuesController();
    
            // Act
            string result = controller.Get(name);
    
            // Assert
            Assert.AreEqual($"{name}:{length}", result);
        }
    
    }
    
  • 測試結果

    6valuesourceresult

  • 測試案例會列出所有組合,如果需要一對一測試組合就要加上Sequential
    [TestFixture()]
    public class ValuesControllerTests
    {
        private static string[] TestNames()
        {
            return new string[] { "Yowko", "Lol", "test" };
        }
    
        private static int[] TestLengths()
        {
            return new int[] { 5, 3, 4 };
        }
        [Test,Sequential]
        public void GetById([ValueSource("TestNames")] string name,
            [ValueSource("TestLengths")] int length)
        {
            // Arrange
            ValuesController controller = new ValuesController();
    
            // Act
            string result = controller.Get(name);
    
            // Assert
            Assert.AreEqual($"{name}:{length}", result);
        }
    
    }
    
  • 測試結果

    7valuesourceresult

參考資訊

  1. Parameterized Tests Made Simple
  2. NUnit's Test Case Source
  3. Nunit test setup method with argument

沒有留言:

張貼留言