unittest (python标准库-开发工具-单元测试框架)

unittest官方文档摘录翻译 reffer to: https://docs.python.org/3/library/unittest.html#unittest.TextTestRunner

第一部分-使用

1、基本概念

1.1）unittest单元测试框架最初的灵感来自于JUnit，其特点有

支持测试自动化
为测试共享setup和shutdown代码
可以把单个测试集合成测试用例集
将测试报告框架和测试用例独立开来

1.2）unittest支持的面向对象的重要理念

test fixture

测试固件：表示一个或多个测试用例需要的准备，以及关联的清理操作，例如：创建临时DB、目录或启动一个进程
test case

测试用例：一个独立的测试单元，它校验一组输入得到的一个指定的响应，unittest提供一个基类TestCase，用来创建新的测试用例
test suite

测试套件：一个测试用例的集合，用来集合应该被一起执行的测试用例
test runner

测试执行组件：安排测试的执行并给用户提供结果

2、简单实例

unittest库提供了一系列丰富的工具来构建和执行测试，下面讲一下可以满足大部分用户需求的一个小的工具子集

import unittest

class TestStringMethods(unittest.TestCase):

    def test_upper(self):

    	self.assertEqual('foo'.upper(), 'FOO')

    def test_isupper(self):

    	self.assertTrue('FOO'.isupper())

    	self.assertFalse('Foo'.isupper())

    def test_split(self):

    	s = 'hello world'

    	self.assertEqual(s.split(), ['hello', 'world'])

    	# check that s.split fails when the separator is not a string

    	with self.assertRaises(TypeError):

    	s.split(2)

if __name__ == '__main__':

	unittest.main()

测试用例继承TestCase类，单个测试方法需要已test开头，这样便于告诉test runner哪些方法代表测试用例
每一个测试均用到了断言行数assert*(),以便于test runner计算测试结果及生成测试报告
setUp()和tearDown()方法用于定义一些测试前后的操作
unittest.main()为测试脚本提供了一个命令行接口来运行测试

3、命令行执行测试的方式

# 您可以像这样执行一个测试模块：

python -m unittest test_module1 test_module2

# 也可以执行一个测试类，如：

python -m unittest test_module.TestClass

# 或者单独执行一个测试方法

python -m unittest test_module.TestClass.test_method

4、组织测试代码

测试用例：单元测试的基础组成模块是测试用例--必须建立起来并且完成正确性校验的单个场景
编写用例的规范
- 在unittest框架中，测试用例就是TestCase的实例，所以你必须继承TestCase类来写用例
- 测试方法必须带self参数，用来单独运行或则组合运行用例
- assert*()方法是TestCase类提供的，如果测试失败了，它会抛出解释性的说明，unittest则会把这个用例定义为失败，其他的异常都会被视为错误。
- setUp()方法会在每一个test_func执行之前执行，同理的tearDown
- 测试用例的执行顺序是测试方法名的字符串排序

自由组装测试套件

import unittest

class WidgetTestCase(unittest.TestCase):

	def setUp(self):

	self.widget = Widget('The widget')

	def tearDown(self):

	self.widget.dispose()

def suite():

    suite = unittest.TestSuite()

    suite.addTest(WidgetTestCase('test_default_widget_size'))

    suite.addTest(WidgetTestCase('test_widget_resize'))

    return suite

if __name__ == '__main__':

    runner = unittest.TextTestRunner()

    runner.run(suite())

5、跳过用例

5.1 跳过一个用例使用skip()装饰器就可以了，下面是几个实例

class MyTestCase(unittest.TestCase):

@unittest.skip("demonstrating skipping")

def test_nothing(self):

    self.fail("shouldn't happen")

@unittest.skipIf(mylib.__version__ < (1, 3),

                 "not supported in this library version")

def test_format(self):

    # Tests that work for only a certain version of the library.

    pass

@unittest.skipUnless(sys.platform.startswith("win"), "requires Windows")

def test_windows_support(self):

    # windows specific testing code

    pass

第二部分-深入unittest APIs

1、Test cases 测试用例相关

unittest.TestCase(methodName="runTest")

TestCase类的实例展示了unittest宇宙中单元测试逻辑，这个类被设计为基类，由它的子类来实现特定的测试。
这些子类实现test runner需要的接口，来让它控制测试用例和各个失败的检查和报告的测试方法
TestCase实例提供三类方法：
- A：用来运行测试： setUp() 、tearDown()、setUpClass()、tearDownClass()、run(result=None)、skipTest(reason)
- B：用来实现条件检查和报告失败assert*()
- C：一些查询信息的方法

2、Grouping tests 组织测试用例

unittest.TestSuite(tests=())

这个类代表一些单独测试用例或测试集的集合，TestSuite的对象有点像TestCase对象，除了它并不真正实现一个测试外，另外，它们用来集成需要一起运行的测试，下面是一些常用方法：

addTest(test) 向测试集中加入一个测试用例或测试集
addTests(tests) 添加多个test
run(result)运行suite关联的测试，收集测试结果放到result中
countTestCases()

3、Loading and running tests 加载并执行测试

class unittest.TestLoader

用来通过测试类和或者测试模块创建测试集，这个类一般无需实例化，
方法：
- loadTestsFromTestCase(testCaseClass)
- loadTestsFromModule(module, pattern=None)
- loadTestsFromName(name, module=None)
- loadTestsFromNames(names, module=None)
- getTestCaseNames(testCaseClass)
- discover(start_dir, pattern='test*.py', top_level_dir=None)

class unittest.TestResult

TestResult对象保存了测试集的测试结果
TestRunner.run()会返回一个TestResult实例，用于生成测试不报告用
- 结果属性：errors、failures、skipped、testsRun

class unittest.TextTestResult(stream, descriptions, verbosity)

用TextTestRunner对TestResult的实现
方法：
- _makeResult()：通过运行run函数返回一个TestResult实例。
- run(test): TextTestRunner的主入口，以TestSuite或TestCase为参数，并输出一个TestResult
- unittest.main(*):一个从module中载入测试集并执行他们的命令行程序，为了方便测试模块执行。最简单的执行方式是：

# 执行一个module中的所有用例

if __name__ == '__main__':

	unittest.main()

4、 Class and Module Fixtures

class及module级别的固件（Fixture）在测试套件TestSuite中已经实现，当suite遇到一个新类中的测试用例时，前一个类先tearDown且新的类会setUp固件。Shared fixtures

巴特西

unittest (python标准库-开发工具-单元测试框架)

第一部分-使用

1、基本概念

1.1）unittest单元测试框架最初的灵感来自于JUnit，其特点有

1.2）unittest支持的面向对象的重要理念

2、简单实例

3、命令行执行测试的方式

4、组织测试代码

5、跳过用例

第二部分-深入unittest APIs

1、Test cases 测试用例相关

unittest.TestCase(methodName="runTest")

2、Grouping tests 组织测试用例

unittest.TestSuite(tests=())

3、Loading and running tests 加载并执行测试

class unittest.TestLoader

class unittest.TestResult

class unittest.TextTestResult(stream, descriptions, verbosity)

4、 Class and Module Fixtures

最新文章

热门文章