Python Unittest简明教程
1 概述
单元测试是一种软件测试方法,通过来测试源代码中的各个单元,例如类,方法等,以确定它们是否符合要求。直观上来说,可以将单元视为最小的可测试部分。单元测试是程序员在开发过程中创建的短代码片段。 它构成了组件测试的基础。
2 unittest
unitest是python内置的用于测试代码的模块,它支持测试自动化,配置共享和关机代码测试。支持将测试样例聚合到测试集中,并将测试与报告框架独立。
为了实现这些,unittest 通过面向对象的方式支持了一些重要的概念。
- 测试脚手架(test fixture):表示为了开展一项或多项测试所需要进行的准备工作,以及所有相关的清理操作。举个例子,这可能包含创建临时或代理的数据库、目录,再或者启动一个服务器进程。
- 测试用例(test case):一个测试用例是一个独立的测试单元。它检查输入特定的数据时的响应。 unittest
提供一个基类:TestCase ,用于新建测试用例。 - 测试套件(test suite): 是一系列的测试用例,或测试套件,或两者皆有。它用于归档需要一起执行的测试。
- 测试运行器(test
runner):是一个用于执行和输出测试结果的组件。这个运行器可能使用图形接口、文本接口,或返回一个特定的值表示运行测试的结果。
2.1 创建一个简单的单元测试:
步骤:
在程序中导入unittest模块。
定义一个需要测试的函数。在下面的例子中,add()函数将会被测试。
通过集成类unittest.TestCase创建一个测试用例类。
在类中定义一个测试方法,该方法以test作为前缀。
每个测试方法中都调用TestCase类的断言方法。里面有多种类型的断言。
assertEquals()比较把add()函数的结果与第二个参数做比较。如果不想等,会抛出异常assertionError。
调用unittest模块中的main方法。
代码:(文件名为unittest01.py)
import unittestdef add(a, b):return a+b# 一个类是一个测试用例,测试指类中的测试方法,测试用力中可以有多个测试。
class SimpleTest(unittest.TestCase):def test_add(self):self.assertEqual(add(3, 7), 10)def test_add2(self):self.assertEqual(add(3, 5), 10)# __name__是一个全局变量,它的值是模块的名称。该判断语句表示只运行当前文件中的代码。
if __name__ == "__main__":unittest.main()
结果:
.F
======================================================================
FAIL: test_add2 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):File "/home/hookind/Desktop/workspace/pythonTest/unittest01.py", line 13, in test_add2self.assertEqual(add(3, 5), 10)
AssertionError: 8 != 10----------------------------------------------------------------------
Ran 2 tests in 0.001sFAILED (failures=1)
2.2 命令行界面:
可以在命令行使用unittest模块运行模块、类和独立测试方法中的测试(这里测试指指测试用例类中的测试方法):
python -m unittest test1
python -m unittest test_module.TestClass
python -m unittest test_module.TestClass.test_method
示例:对于上面的代码,可以通过下面这些命令运行。
python -m unittest unittest01
python3 -m unittest unittest01.SimpleTest
python3 -m unittest unittest01.SimpleTest.test_add
unittest支持一些命令行选项,可以通过下面的命令查看所有选项。
python3 -m unittest -h
3 API
这章只描述unittest模块中的类与方法。
3.1 TestCase类
该类的对象表示最小的可测试单元。
在TestCase类中的一些方法。
编号 | 方法 | 描述 |
---|---|---|
1 | setUp() | 用来准备测试脚手架的方法,在调用测试方法之前,该方法会被立即调用 |
2 | tearDown() | 测试方法被调用后,该方法会被立即调用,并且结果也会被记录。即使测试方法抛出异常,该方法也会被调用 |
3 | setUpClass() | 一个类方法,在类中所有的测试运行前被调用 |
4 | tearDownClass() | 一个类方法,在类中所有的测试运行后被调用 |
脚手架(Fixture)
在测试用例类中,可以有大量的测试。这些方法可能需要初始化数据库连接、临时文件或其它的资源。这些就是脚手架。测试用力需要一些特别的方法配置和清理测试需要的脚手架。为了配置脚手架,覆盖setUp()方法;为了清理,覆盖tearDown()方法。
类脚手架(Class Fixture)
TestCase类有一个setUpClass()方法,该方法可以在TestCase类中的测试执行之前被覆盖以执行。同样,tearDownClass() 方法将在类中的所有测试之后执行。这两种方法都是类方法。因此,它们必须@classmethod注解装饰。
示例:
import unittestdef add(a, b):return a+bclass SimpleTest(unittest.TestCase):@classmethoddef setUpClass(cls) -> None:print("==========setUpClass=========")return super().setUpClass()@classmethoddef tearDownClass(cls) -> None:print("\n==========tearDownClass=========")return super().tearDownClass()def setUp(self):print("\n==========setUp=========")return super().setUp()def tearDown(self):print("==========tearDown========")return super().tearDown()def test_add(self):print("\n执行test_add")self.assertEqual(add(3, 7), 10)def test_add2(self):print("\n执行test_add2")self.assertEqual(add(3, 5), 10)# __name__是一个全局变量,它的值是模块的名称。该判断语句表示只运行当前文件中的代码。
if __name__ == "__main__":unittest.main()
结果:
==========setUpClass===================setUp=========执行test_add
==========tearDown========
.
==========setUp=========执行test_add2
==========tearDown========
F
==========tearDownClass===============================================================================
FAIL: test_add2 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):File "/home/hookind/Desktop/workspace/pythonTest/unittest01.py", line 34, in test_add2self.assertEqual(add(3, 5), 10)
AssertionError: 8 != 10----------------------------------------------------------------------
Ran 2 tests in 0.001sFAILED (failures=1)
想了解更多,请参考unittest.TestCase
3.2 TestSuite类
Python 的测试框架提供了一种有用的机制,通过该机制可以根据它们测试的特性将测试用例实例组合在一起。该机制由unittest模块中的TestSuite类提供。
步骤:
- 创建一个TestSuite类的实例。
suite = unittest.TestSuite()
- 把测试(测试用例中的一个测试方法)加入TestSuite实例中。
# 添加测试用例类中的一个测试
suite.addTest(SimpleTest2("test_sub"))
# 添加测试用例类中的所有测试
suite.addTest(unittest.makeSuite(SimpleTest))
- 创建一个TextTestRunner类的对象。
runner = unittest.TextTestRunner()
- 调用run()方法去运行在套件中的测试。
runner.run(suite)
示例:
import unittestdef add(a, b):return a+bdef sub(a, b):return a-bclass SimpleTest(unittest.TestCase):@classmethoddef setUpClass(cls) -> None:print("==========setUpClass=========")return super().setUpClass()@classmethoddef tearDownClass(cls) -> None:print("\n==========tearDownClass=========")return super().tearDownClass()def setUp(self):print("\n==========setUp=========")return super().setUp()def tearDown(self):print("==========tearDown========")return super().tearDown()def test_add(self):print("\n执行test_add")self.assertEqual(add(3, 7), 10)def test_add2(self):print("\n执行test_add2")self.assertEqual(add(3, 5), 10)class SimpleTest2(unittest.TestCase):@classmethoddef setUpClass(cls) -> None:print("==========setUpClass=========")return super().setUpClass()@classmethoddef tearDownClass(cls) -> None:print("\n==========tearDownClass=========")return super().tearDownClass()def setUp(self):print("\n==========setUp=========")return super().setUp()def tearDown(self):print("==========tearDown========")return super().tearDown()def test_sub(self):print("\n执行test_sub")self.assertEqual(sub(3, 5), 10)def test_sub2(self):print("\n执行test_sub2")self.assertEqual(sub(3, 5), -2)# __name__是一个全局变量,它的值是模块的名称。该判断语句表示只运行当前文件中的代码。
if __name__ == "__main__":suite = unittest.TestSuite()suite.addTest(SimpleTest2("test_sub"))suite.addTest(unittest.makeSuite(SimpleTest))runner = unittest.TextTestRunner()runner.run(suite)
结果:
==========setUpClass===================setUp=========执行test_sub
==========tearDown========
F
==========tearDownClass=========
==========setUpClass===================setUp=========执行test_add
==========tearDown========
.
==========setUp=========执行test_add2
==========tearDown========
F
==========tearDownClass===============================================================================
FAIL: test_sub (__main__.SimpleTest2)
----------------------------------------------------------------------
Traceback (most recent call last):File "/home/hookind/Desktop/workspace/pythonTest/unittest01.py", line 61, in test_subself.assertEqual(sub(3, 5), 10)
AssertionError: -2 != 10======================================================================
FAIL: test_add2 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):File "/home/hookind/Desktop/workspace/pythonTest/unittest01.py", line 38, in test_add2self.assertEqual(add(3, 5), 10)
AssertionError: 8 != 10----------------------------------------------------------------------
Ran 3 tests in 0.001sFAILED (failures=2)
想了解更多,可参考unittest.TestSuite
3.3 TestLoader类
unittest包具有TestLoader类,用于从类和模块创建测试套件。默认情况下,在调用unittest.main()方法时会自动创建unittest.defaultTestLoader实例。但是,显式实例允许自定义某些属性。
示例:
import unittestdef add(a, b):return a+bdef sub(a, b):return a-bclass SimpleTest(unittest.TestCase):@classmethoddef setUpClass(cls) -> None:print("==========setUpClass=========")return super().setUpClass()@classmethoddef tearDownClass(cls) -> None:print("\n==========tearDownClass=========")return super().tearDownClass()def setUp(self):print("\n==========setUp=========")return super().setUp()def tearDown(self):print("==========tearDown========")return super().tearDown()def test_add(self):print("\n执行test_add")self.assertEqual(add(3, 7), 10)def test_add2(self):print("\n执行test_add2")self.assertEqual(add(3, 5), 10)class SimpleTest2(unittest.TestCase):@classmethoddef setUpClass(cls) -> None:print("==========setUpClass=========")return super().setUpClass()@classmethoddef tearDownClass(cls) -> None:print("\n==========tearDownClass=========")return super().tearDownClass()def setUp(self):print("\n==========setUp=========")return super().setUp()def tearDown(self):print("==========tearDown========")return super().tearDown()def test_sub(self):print("\n执行test_sub")self.assertEqual(sub(3, 5), 10)def test_sub2(self):print("\n执行test_sub2")self.assertEqual(sub(3, 5), -2)# __name__是一个全局变量,它的值是模块的名称。该判断语句表示只运行当前文件中的代码。
if __name__ == "__main__":testCaseList = [SimpleTest, SimpleTest2]testLoad = unittest.TestLoader()testSuiteList=[]for testCase in testCaseList:testSuite = testLoad.loadTestsFromTestCase(testCase)testSuiteList.append(testSuite)newSuite = unittest.TestSuite(testSuiteList)runner = unittest.TextTestRunner()runner.run(newSuite)
想了解更多,可参考unittest.TestLoader
3.4 TestResult类
此类用于编译有关已成功测试和已失败测试的信息。TestResult对象存储一组测试的结果。TextTestRunner.run() 方法返回一个 TestResult 实例。
可以在上面代码中使用下述代码获得TestResult对象。
result = runner.run(newSuite)
更多请参考unittest.TestResult
4 断言
Python测试框架使用Python的内置assert()函数来测试特定条件。如果断言失败,将引发AssertionError。然后测试框架会将测试标识为失败。其他异常被视为错误。
unittest模块中定义了以下三种断言函数:
- 基本布尔断言
- 比较断言
- 集合断言
基本断言函数评估操作的结果是 True 还是 False。所有断言方法都接受一个msg参数,如果指定,则用作失败时的错误消息。
示例:
import unittestclass TestCase01(unittest.TestCase):def test_equal(self):self.assertEqual(12,13,"不相等")def test_equal2(self):self.assertEqual(12,13)def test_equal3(self):self.assertEqual(12,12)if __name__=="__main__":unittest.main()
** 结果**:
FF.
======================================================================
FAIL: test_equal (__main__.TestCase01)
----------------------------------------------------------------------
Traceback (most recent call last):File "/home/hookind/Desktop/workspace/pythonTest/unittest03.py", line 6, in test_equalself.assertEqual(12,13,"不相等")
AssertionError: 12 != 13 : 不相等======================================================================
FAIL: test_equal2 (__main__.TestCase01)
----------------------------------------------------------------------
Traceback (most recent call last):File "/home/hookind/Desktop/workspace/pythonTest/unittest03.py", line 8, in test_equal2self.assertEqual(12,13)
AssertionError: 12 != 13----------------------------------------------------------------------
Ran 3 tests in 0.000sFAILED (failures=2)
想了解更多,请参考assert-methods
5 参考
- UnitTest Framework Tutorial
- unittest — Unit testing framework
Python Unittest简明教程相关推荐
- Python类简明教程
Python类简明教程
- python程序设计简明教程知识点总结_Python程序设计简明教程 在线阅读
介绍\u201CPython编程简明教程\u201D解释了Python语言的基本知识和基本应用技能与简洁的语言和易于理解的例子.\u201CPython编程简明教程\u201D由9章,主要解释Pyth ...
- python程序设计简明教程知识点_《Python 简明教程》读书笔记系列一 —— 基本语法...
基础知识 注释 注释 是 # 符号右侧的任何文本,主要用作程序读者的注释. 在程序中要使用尽可能多的有用注释: 解释假设(或者前提 / 条件) 解释重要的决定 解释重要的细节 解释你想要解决的问题 解 ...
- python argparse 简明教程
本文档为本人自己根据官网文档的理解,重新整理,希望可以帮到大家. argparse是python标准库里面用来处理命令行参数的库 说人话就是:帮助我们能够从终端运行程序,加上需要的参数. 参考资料: ...
- python程序设计实用教程清华大学出版社_清华大学出版社-图书详情-《Python程序设计简明教程》...
前言 程序设计课程是大学计算机基础课的一个重要组成部分,其不仅较好地体现了编程方面的计算思维,还有着广泛的应用价值.Python程序设计语言由于其简洁.高效的特点,且具备众多的标准库和第三方库的支持, ...
- python程序设计简明教程知识点_[转载]看完《python简明教程》笔记及第一个python程序...
主要是摘抄了一些书上需要注意的地方: 1.Python 是一门解释性语言. 在计算机内部, Python 解释器把源代码转换成称为字节码的中间形式,然后再把它翻译成计算机使用的机器语言并运行. 2.版 ...
- Python Requests 简明教程
参考官方文档 http://www.python-requests.org/en/master/ Requests 一个HTTP-Python库 给URL地址传递参数 读出对象的性质 读取二进制文件对 ...
- 飘逸的python - yield简明教程
发现还有非常多人对yield不理解,云里雾里,于是试着用文字表述. 仅仅要函数含有yield语句,它就返回一个生成器.所以我们与其把其看成函数定义,不如看作是生成器定义.函数用return返回,而生成 ...
- python爬虫简明教程第二版答案_高校邦《网络数据采集与Python爬虫》答案教程
不用于治疗风湿性关节炎的药物是: Basic Energy is needed to ( ). 1.查询学生的选课课号(去掉重复的行cno)Select()cnofromcourse 合金的形状记忆效 ...
最新文章
- [javascript] 看知乎学习js闭包
- XMLHttpRepuest2
- 洛谷 - P1198 - 最大数 - 线段树
- Flask爱家租房--订单支付(支付过程)
- 如何控制事物_如何使用QC七大手法?62页QC老七大工具,果断收藏
- BeanShell异常处理
- Django常用命令
- xpath提取目录下所有标签内的内容,递归 //text()
- 485通讯线是几芯的_RS232/485串口通讯基础知识
- zabbix内网安装部署_搭建环境tomcat+nginx+keepalived+zabbix
- Bulk Insert命令详解
- 配置SFML在Mac下开发 iOS游戏
- 3分钟了解LCD1602液晶显示屏的使用
- 从零开始学习OpenWrt完美教程
- 【Codecs系列】AVS+(AVS1 P16)解码器
- 在尚硅谷自学Java全栈工程师课程
- MATLAB2014a的安装
- 解决Chrome插件安装时程序包无效:CRX_HEADER_INVALID
- LeetCode 1218 最长定差子序列
- ApiCloud使用小结图文示例-简单的认识