第十五單元 Python單元測試之unittest

目錄	類容
unittest	單元測試，集成測試，功能測試 Unittest的重要組成部分斷言的使用測試用例方法的命名規則執行測試用例原始的測試報告和第三方的html格式報告讀取xml文件數據進行單元測試讀取csv文件數據進行單元測試

一、單元測試、集成測試、功能測試

單元測試

顆粒度最小，一般由開發小組採用白盒方式來測試，主要測試單元是否符合“設計”；是指對軟件中的最小可測試單元進行檢查和驗證

集成測試

介於單元測試和系統測試之間，一般由開發小組採用白盒+黑盒的方法來測試，即驗證“設計”又驗證“需求”。主要用來測試模板與模板之間的接口，同時還要測試一些主要的業務功能。

功能測試

顆粒度最大，一般由獨立的測試小組採用黑盒的方式來測試，主要測試系統是否符合“需求規格說明書

問題：什麼是白盒測試，什麼是黑盒測試

白盒：主要應用於單元測試階段，主要是對代碼級別的測試，針對程序內部的邏輯結構。測試的手段有：語句覆蓋、判定覆蓋、條件覆蓋、路徑覆蓋和條件組合覆蓋
黑盒：不考慮程序內部結構和邏輯結構，主要是測試系統的功能是否滿足“需求規格說明書”。一般會有一個輸入值和一個輸出值，和期望值做比較。

二、Unittest重要組成

Python中有一個自帶的單元測試框架是unittest模塊，用它來做單元測試，它裏面封裝好了一些校驗返回的結果方法（斷言）和一些用例執行前的初始化操作。

unittest中最核心的部分是：TestFixture、TestCase、TestSuite、TestRunner

1. TestFixture

作用:用於一個測試環境的準備和銷燬還原。
功能: 當測試用例每次執行之前需要準備測試環境，每次測試完成後還原測試環境，比如執行前連接數據庫、打開瀏覽器等，執行完成後需要還原數據庫、關閉瀏覽器等操作。這時候就可以啓用testfixture

主要方法:

setUp()：準備環境，執行每個測試用例的前置條件；
tearDown()：環境還原，執行每個測試用例的後置條件；
setUpClass()：必須使用@classmethod裝飾器，所有case執行的前置條件，只運行一次；
tearDownClass()：必須使用@classmethod裝飾器，所有case運行完後只運行一次；

2. TestCase:測試用例

定義：一個類class繼承 unittest.TestCase，就是一個測試用例
什麼是測試用例?
就是一個完整的測試流程，包括測試前準備環境的搭建(setUp)，執行測試代碼(run)，以及測試後環境的還原(tearDown)。
測試用例命名規則
繼承自unittest.TestCase的類中，測試方法的名稱要以test開頭。且只會執行以test開頭定義的方法（測試方法）,測試用例執行的順序會按照方法名的ASCII值排序。
如果想跳過某個測試用例，需要添加@unittest.skip)(‘描述信息')
代碼

import unittest
class Calc_testcase(unittest.TestCase):
    def setUp(self) :  #測試用例方法執行前的操作
        print("start")
    def test1(self):   #測試用例，方法名稱必須以test開頭
        resl = 4
        self.assertEqual(resl,5)
def tearDown(self) :  #測試用例方法執行後的操作
        print("end")
if __name__ =="__main__":
    unittest.main()       #調用測試用例中以test開頭的方法，直接輸入main

思考：如果有兩個測試用例呢？哪個先執行呢？test002在test001前邊呢？

import unittest
class UnitTestTwo(unittest.TestCase):
    def setUp(self) -> None:
        print("開始")
    def test002(self):
        print("測試用例002")
    def test001(self):
        print("測試用例001")
    def tearDown(self) -> None:
        print("結束")
if __name__ == '__main__':
    unittest.main

3. TestSuite

測試套件，可以將多個測試用例集合在一起，能一起執行選中的測試用例

方式一：

suite = unittest.TestSuite()#創建測試套件
case_list = [“test1”,”test2”….]
For case in case_list:
    suite.addTest(類名(case))

代碼：

if __name__ == '__main__':
    # unittest.main
    suite = unittest.TestSuite()
    caseList = ["test001", "test002"]
    for case in caseList:
        suite.addTest(UnitTestTwo(case))
    # 運行測試用例
    runner = unittest.TextTestRunner(verbosity=2)
    runner.run(suite)

方式二：用的不多

suite = unittest.TestSuite()#創建測試套件
        suite.addTest(類名 (“test1“))
        suite.addTest(類名 (“test2“))

方式三:

suite = unittest.TestSuite()#創建測試套件
loader = unittest.TestLoader()# 創建一個加載對象 
suite .addTest(loader.loadTestsFromTestCase(類名))

4. TextRunner

執行測試用例
通過TextTestRunner類提供的run()方法來執行test suite/test cas
格式

runner = unittest.TextTestRunner(verbosity=2)
runner.run(suite)

註釋

 verbosity ：表示測試報告信息的詳細程度，一共三個值，默認是2
0 (靜默模式)：你只能獲得總的測試用例數和總的結果，如：總共100個 失敗10 成功90
1 (默認模式)：類似靜默模式，只是在每個成功的用例前面有個. 每個失敗的用例前面有個F
2 (詳細模式)：測試結果會顯示每個測試用例的所有相關的信息

三、斷言

驗證預期結果和實際結果(第一個用的最多)

assertEqual(a,b):斷言a和b是否相等，相等則測試用例通過。
assertNotEqual(a,b):斷言a和b是否相等，不相等則測試用例通過。
assertTrue(x)：斷言x是否True，是True則測試用例通過。
assertFalse(x)：斷言x是否False，是False則測試用例通過。
assertIs(a,b):斷言a是否是b，是則測試用例通過。
assertNotIs(a,b):斷言a是否是b，不是則測試用例通過。
assertIsNone(x)：斷言x是否None，是None則測試用例通過。
assertIsNotNone(x)：斷言x是否None，不是None則測試用例通過。
assertIn(a,b)：斷言a是否在b中，在b中則測試用例通過。
assertNotIn(a,b)：斷言a是否在b中，不在b中則測試用例通過。
assertIsInstance(a,b)：斷言a是是b的一個實例，是則測試用例通過。
assertNotIsInstance(a,b)：斷言a是是b的一個實例，不是則測試用例通過。

案例：

import unittest
class TestOne(unittest.TestCase):
    def setUp(self) -> None:
        print("start")
    def test002(self):
        # self.assertEqual(1, 1)# 相等表示測試通過
        self.assertEqual(1, 2)# 不相等代表測試未通過，會報錯
    def tearDown(self) -> None:
        print('end')
if __name__ == '__main__':
    unittest.main

實際測試案例-主要測試一個代碼塊
①測試代碼和開發代碼是分開的

②Calculate.py代碼：

class Caculate():
    def add(self, a, b):
        c = a + b
        return c
    def reduce(self, a, b):
        c = a - b
        return c

③testdemotwo.py代碼：

import unittest
from dev.Caculate import Caculate
c = Caculate()
add = c.add(1, 4)
reduce = c.reduce(4, 1)
class UnitTestTwo(unittest.TestCase):
    def setUp(self) -> None:
        print("開始")
    def test001(self):
        self.assertEqual(add, 5)
    def test002(self):
        self.assertEqual(reduce, 3)
    def tearDown(self) -> None:
        print("結束")
if __name__ == '__main__':
    unittest.main

四、生成測試報告

html格式的就是HTMLTestRunner了，HTMLTestRunner是 Python 標準庫的 unittest 框架的一個擴展，它可以生成一個直觀清晰的 HTML 測試報告。

下載 HTMLTestRunner.py,複製到項目中
格式

 with open("../report.html","wb") as f:
            HTMLTestRunner(
                stream=f,
           title="單元測試",
                description="測試一期",
                verbosity=2
            ).run(suite)

相關參數說明

stream：指定輸出的方式
description：報告中要顯示的面熟信息
title：測試報告的標題
verbosity ：表示測試報告信息的詳細程度，一共三個值，默認是2
0 (靜默模式)：你只能獲得總的測試用例數和總的結果，如：總共100個 失敗10 成功90
1 (默認模式)：類似靜默模式，只是在每個成功的用例前面有個. 每個失敗的用例前面有個F
2 (詳細模式)：測試結果會顯示每個測試用例的所有相關的信息

創建一個類，testhtml

import unittest
from testdic.HTMLTestRunner import HTMLTestRunner
from testdic.testdemotwo import UnitTestTwo
class UseHtml():
    def testHtml(self):
        suite = unittest.TestSuite()
        suite = unittest.TestSuite()
        caseList = ["test001", "test002"]
        for case in caseList:
            suite.addTest(UnitTestTwo(case))
        with open("../report.html", "wb") as f:
            HTMLTestRunner(
                stream=f,
                title="單元測試",
                description="測試一期",
                verbosity=2
            ).run(suite)
u = UseHtml()
u.testHtml()

生成測試報告

五、操作

1：導入unittest模塊   >>>import unittest
2:編寫一個類繼承unittest.TestCase
3:調用setUp(self), tearDown(self)方法實現測試用例前後階段的操作
4:編寫測試用例方法
    (1)該方法必須以test開頭,否則在unittest.main()中調用測試找不到該方法
    (2)設置斷言進行判斷，輸入數據和輸出數據的預期結果
5:創建套件，將多個測試用例存放套件中，一併執行()
6:生成測試報告(python自帶或者導入HTMLTestRunner生成html格式的測試報告)
7：運行測試用例unittest.main(),調用測試用例中以test開頭的方法

六、代碼展示

對開發的代碼塊進行單元測試
開發被測代碼

class Calc():
    def add(self,a,b):
        c =a+b
        return c
    def redc(self,a,b):
        c = a-b
        print(c)
if __name__ == "__main__":
    c = Calc()
    c.add(2,3)
    print(c.add(2,3))

單元測試代碼

from day.Calc import Calc
import  unittest
c = Calc()  #實例化開發的類
class Test(unittest.TestCase):#unittest單元測試類必須繼承unittest.TestCase
    def setUp(self): #測試用例之前執行
        print("start")
    def test001(self):#測試用例必須test開頭
        res = c.add(2,1)   #調取相加的方法
        self.assertEqual (res,5)  #斷言,預期結果和實際結果的對比
    def test002(self):#測試用例必須test開頭
        res = c.redc(2,3)   #調取相減的方法
        self.assertEqual (res,-1)  #斷言,預期結果和實際結果的對比
    def tearDown(self):#測試用例結束之後執行
        print("end")
if __name__ == '__main__':
    unittest.main()

七、讀取文件

1. 讀取xml文件

先學習xml

2. 創建xml文件

<note>
    <add>
        <add1>2</add1>
        <add2>3</add2>
        <add3>5</add3>
    </add>

    <reduce>
        <reduce1>6</reduce1>
        <reduce2>4</reduce2>
        <reduce3>2</reduce3>
    </reduce>
</note>

3. 讀取xml文件

from xml.dom import minidom
class Readxml():
    def read_xml(self,filename,onename,twoname):
        root =minidom.parse(filename)
        firstnode =root.getElementsByTagName(onename)[0]
        secondnode=firstnode.getElementsByTagName(twoname)[0].firstChild.data
        return secondnode

案例：

2. 讀取csv文件

在data下創建CSV文件a.csv
創建讀文件的文件

import csv   #導入csv模塊
class ReadCsv():
    def read_csv(self):
        item =[]    #定義一個空列表
        c = csv.reader(open("../commonDemo/test1.csv","r"))    #得到csv文件對象
        for csv_i in c:
            item.append(csv_i)      #將獲取的數據添加到列表中
        return item
            
r = ReadCsv()
print(r.read_csv())

在測試用例的類中

完整代碼

import unittest
from dev.Caculate import Caculate
from readdata.readcsv import ReadCsv

c = Caculate()
r = ReadCsv()
# add = c.add(1, 4)
# reduce = c.reduce(4, 1)
class UnitTestTwo(unittest.TestCase):
    def setUp(self) -> None:
        print("開始")

    def test001(self):
        pass
        # self.assertEqual(add, 5)
        for i in r.readCsv():
            add = c.add(int(i[0]), int(i[1]))
            self.assertEqual(add, int(i[2]))

    # def test002(self):
    #     self.assertEqual(reduce, 3)

    def tearDown(self) -> None:
        print("結束")
if __name__ == '__main__':
    # unittest.main
    suite = unittest.TestSuite()
    caseList = ["test001", "test002"]
    for case in caseList:
        suite.addTest(UnitTestTwo(case))

    # 運行測試用例
    runner = unittest.TextTestRunner(verbosity=2)
    runner.run(suite)

作業

作業1：
       1：單元測試：測試開發的加減乘除函數傳遞兩個參數
       2：通過csv文件和xml文件讀取數據進行單元測試並生成html格式的測試報告
博客
編寫單元測試中的手動傳參
編寫單元測試中的通過讀取csv傳參
編寫單元測試中的通過讀取xml傳參