python的单元测试unittest(一)
一、什么是单元测试&单元测试的对象
1.定义:单元测试是用来对一个模块、一个函数或者一个类来进行正确性检验的测试工作。
2.单元测试中最核心的四个概念:test case(测试用例),test suite(测试套件),test runner(测试运行器),test fixture(测试环境数据准备和数据清理或者测试脚手架)
1)test case:一个testcase的实例就是一个测试用例。测试前准备环境的搭建(setUp),执行测试代码(run),以及测试后环境的还原(tearDown)
2)TestSuite:多个测试用例集合在一起。
3)TestLoader:用来加载Testcase到TestSuite中。
4)TextTestRunner:用来执行测试用例,其中run(test)会执行TestSuite/TestCase中的run(result)方法。
5)test fixture:测试用例环境的搭建和销毁
下图为unittest的静态类图:
综上,整个流程就是首先要写好TestCase,然后由TestLoader加载TestCase到TestSuite,然后由TextTestRunner来运行TestSuite,运行的结果保存在TextTestResult中,整个过程集成在unittest.main模块中。
二、unittest的初级使用
1.步骤
1)导入unittest模块,被测文件或者其中的类
2)创建一个测试类,被继承unittest.TestCase
3)重写setUp和tearDown方法(如果有初始化条件和结束条件)
4)定义测试函数,函数名以test_开头。测试用例
5)在函数体中使用断言来判断测试结果是否符合预期结果
6)调用unittset.main()方法运行测试用例--------无此方法也是可以运行
2.设置setup和teardown:每次用例执行前都会执行初始化条件和结束条件(如下代码可以看到,两个测试用例执行了两次)
import unittest class Test_Math(unittest.TestCase): #每执行一个用例,都会执行setup()和teardown()方法 #如果跑所有用例,只运行一次前提条件和结束条件。则用setupclass()和teardownclass() def setUp(self): print("测试用例执行前的初始化操作========") def tearDown(self): print("测试用例执行完之后的收尾操作=====") def test_addTwoNum_01(self): print(5+7) def test_subTwoNum_02(self): print(3-2)
结果:
测试用例执行前的初始化操作========
12
测试用例执行完之后的收尾操作=====
测试用例执行前的初始化操作========
1
测试用例执行完之后的收尾操作=====
3.设置setupClass和teardownClass:执行所有测试用例,仅执行一次初始化条件和结束条件(如下代码可以看到,两个测试用例只执行了一次)
import unittest class Test_Math(unittest.TestCase): #如果跑所有用例,只运行一次前提条件和结束条件。则用setupclass()和teardownclass() @classmethod def setUpClass(cls): print("在所有的测试用例执行之前,只执行一次============") @classmethod def tearDownClass(cls): print("在所有的测试用例执行之后,只执行一次============") def test_addTwoNum_01(self): print(5+7) def test_subTwoNum_02(self): print(3-2)
#python3中写不写都会执行的
if __name__ == '__main__':
unittest.main()
结果: Testing started at 22:19 ... 在所有的测试用例执行之前,只执行一次============ 12 1 在所有的测试用例执行之后,只执行一次============
4.断言Assert----结果对比的函数
Method |
Checks that |
New In |
assertEqual(a,b):相等 |
a == b |
|
assertNotEqual(a,b) |
a != b |
|
assertTrue(x) |
bool(x) is True |
|
assertFalse(x) |
bool(x) is False |
|
assertIs(a,b) |
a is b:判断是否是同一对象(id(a)) |
3.1 |
asserNottIs(a,b) |
a is not b |
3.1 |
assertIsNone(x) |
x is None |
3.1 |
assertIsNotNone(x) |
x is not None |
3.1 |
assertIn(a,b):a是否在b中 |
a in b |
3.1 |
assertNotIn(a,b) |
a not in b |
3.1 |
assertIsInstance(a,b):实例对象 |
isInstance(a,b) |
3.2 |
assertNotIsInstance(a,b) |
not isInstance(a,b) |
3.2 |
设置断言,当一条测试用例执行失败,不会影响其他测试用例的执行。
import unittest class Test_Math(unittest.TestCase): def setUp(self): print("测试用例执行前的初始化操作========") def tearDown(self): print("测试用例执行完之后的收尾操作=====") #正确的断言 def test_addTwoNum_01(self): sum = 5+7 print(sum) self.assertEqual(12,sum) #设置错误的断言 def test_subTwoNum_02(self): sub = 3-2 self.assertEqual(11,sub) if __name__ == '__main__': unittest.main()
#结果---直接打印出来失败的原因 Testing started at 10:14 ... 测试用例执行前的初始化操作======== 12 测试用例执行完之后的收尾操作===== 测试用例执行前的初始化操作======== 测试用例执行完之后的收尾操作===== Failure Traceback (most recent call last): File "E:\柠檬班\python\python_API\unittest_lianxi.py", line 22, in test_subTwoNum_02 self.assertEqual(11,sub) AssertionError: 11 != 1
另外,断言也可以直接写>= = <= 来判断
def test_addTwoNum_01(self): sum = 5+7 print(sum) assert sum >= 10
写了一个方法,通过unnittest去执行
#方法文件:Myclass_test.py class Myclass_test: def __init__(self,a,b): self.a = a self.b = b def sum(self): sum = self.a + self.b return sum def sub(self): sub = self.a - self.b return sub #单元测试文件:test_Myclass.py import unittest from Myclass_test import Myclass_test class Test_Myclass(unittest.TestCase): def setUp(self): self.myclass = Myclass_test(12,12) def test_sum(self): sum = self.myclass.sum() self.assertEqual(24,sum) def test_sub(self): sub = self.myclass.sub() self.assertEqual(0,sub)
三、unittest的进阶使用
1、testsuite:
addTest():添加一个测试用例
addTest([,,]):添加多个测试用例
#实例化套件对象
s = unittest.TestSuite() #调用addTest来加载测试用例:类名(‘方法名’)的集合 s.addTest(Test_Myclass1("test_sub"))
s.addTests([Test_Myclass1("test_sub"),Test_Myclass1("test_sum")]) #实例化TextTestRunner对象 runner = unittest.TextTestRunner() #调用run()方法 runner.run(s)
2.addTest的参数:是一个测试用例的列表
方式一:类名(‘方法名’)的集合
方式二:unittest.TestLoader.discover方法匹配目录下的用例-----用的最多的,测试用例在一个目录下
discover方法中默认匹配模式是从当前目录下找以test开头的py文件(test*)。测试用例的顺序执行是根据字母a-z,0-9的顺序执行的。
方式三:unittest.TestLoader.loadTestsFromModule匹配模块中的测试用例
PS:TestLoader类、TestSuite类、TestRunner类需要先实例化再使用
如下是一个单元测试的实例:
#实例:采用unittest.TestLoader.discover方式加载测试用例。
######定义函数:Myclass_test.py class Myclass_test: def __init__(self,a,b): self.a = a self.b = b def sum(self): sum = self.a + self.b return sum def sub(self): sub = self.a - self.b return sub ######定义测试类1:test_Myclass1.py import unittest from my_Unittest.Myclass_test import Myclass_test class Test_Myclass1(unittest.TestCase): def setUp(self): self.myclass = Myclass_test(12,12) def test_sum(self): print("sum_1") sum = self.myclass.sum() self.assertEqual(24,sum) def test_sub(self): print("sub_1") sub = self.myclass.sub() self.assertEqual(0,sub) ######定义测试类2:test_Myclass2.py import unittest from my_Unittest.Myclass_test import Myclass_test class Test_Myclass2(unittest.TestCase): def setUp(self): self.myclass = Myclass_test(1,12) def test_sum(self): print("sum_2") sum = self.myclass.sum() self.assertEqual(13,sum) def test_sub(self): print("sub_2") sub = self.myclass.sub() self.assertEqual(-11,sub) ######主函数的调用:Myclass_main.py import unittest import os #实例化测试套件对象 s = unittest.TestSuite() #实例化TestLoader的对象 loader = unittest.TestLoader() #使用discover()去找一个目录下的所有测试用例的文件,并将返回数据添加到测试套件中。 s.addTests(loader.discover(os.getcwd())) run = unittest.TextTestRunner() run.run(s)
3.定义的测试类和测试套件写在不同的模块里,为什么?
4.测试报告的生成
第一种:text文件--写到文件中
#第一种:unittest自带的方法 #创建一个文件,以写的方式打开 import unittest
from test_Myclass1 import Test_Myclass1
s = unittest.TestSuite()
s.addTest(Test_Myclass1("test_sub"))
s.addTests([Test_Myclass1("test_sub"),Test_Myclass1("test_sum")])
fs = open("test_run_report.txt","w")
run = unittest.TextTestRunner(fs)
run.run(s)
第二种:html测试报告--HtmlTestRunner.py文件
python提供第三方库:HtmlTestRunner
官方文档:http://tungwaiyip.info/software/HTMLTestRunner.html(适用python2)
然后放到你安装的python安装目录中:Lib\site-packages目录下即可。示例如下:D:\Python34\Lib\site-packages
import unittest import os from HTMLTestRunnerNew import HTMLTestRunner #实例化测试套件对象 s = unittest.TestSuite() #实例化TestLoader的对象 loader = unittest.TestLoader() #使用discover()去找一个目录下的所有测试用例的文件,并将返回数据添加到测试套件中。 s.addTests(loader.discover(os.getcwd())) fp = open(os.getcwd() +"/test_report.html","wb") runner = HTMLTestRunner(stream=fp, title="测试报告标题", description="测试报告描述信息", tester="测试者") runner.run(s)
四、