unittest 单元测试框架总结
unittest单元测试框架不仅可以适用于单元测试,还可以适用WEB自动化测试用例的开发与执行,该测试框架可组织执
行测试用例,并且提供了丰富的断言方法,判断测试用例是否通过,最终生成测试结果。
今天笔者就总结下如何使用unittest单元测试框架来进行WEB自动化测试。
一、 先来理解一下 unittest 的设计理念:
在 unittest 中存在四个重要概念: TestCase, TestSuite, TestRunner 和 TestFixture,
只有理解了这四个基本概念,才能理解单元测试的基本特征
1. TestCase
例: class BaiduTest(unittest.TestCase):
Test Case 是最小的测试单元,用于检查特定输入集合的特定返回值。 unittest 提供了 TestCase基类
我们创建的测试类需要继承该基类,他可以用来创建新的测试用例。
有必要声明一下这三个概念: 测试模块、 测试类、 测试用例
通俗的讲:
测试模块 就是要运行的 .py 文件,
def setUpModule():/def tearDownModule(): 定义测试模块的开始执行和结束
测试类 就是测试文件包含的测试类,所有测测试类的父类都是 unittest.TestCase 类
def setUpClass(cls):/def tearDownClass(cls): 定义测试类的开始和结束
测试用例 就是测试类里面按照 unittest 框架规定以 test 开头的方法 ( def test_case1(self): )
def setUp(self):/def tearDown(self): 定义测试类的开始执行和结束
一个测试模块可以包含多个测试类, 一个测试类可以包含多个测试用例 如下:
##################################################################
import unittest
def setUpModule():
print("test module start >>>>>>>>>>>>>>>>>>>>>>>>")
def tearDownModule():
print("test module end >>>>>>>>>>>>>>>>>>>>>>>>>>")
class MyTest(unittest.TestCase):
@classmethod
def setUpClass(cls):
print("test class start====================>")
@classmethod
def tearDownClass(cls):
print("test class end======================>")
def setUp(self):
print("test case start--------------------->")
def tearDown(self):
print("test case end----------------------->")
def testCase1(self):
print("test case 1 !")
def testCase(self):
print("test case 2 !")
class MyTest2(unittest.TestCase):
@classmethod
def setUpClass(cls):
print("test class start====================>")
@classmethod
def tearDownClass(cls):
print("test class end======================>")
def setUp(self):
print("test case start--------------------->")
def tearDown(self):
print("test case end----------------------->")
def testCase1(self):
print("test case 1 !")
def testCase(self):
print("test case 2 !")
###############################################################
2. TestSuite
例:
suite = unittest.TestSuite()
suite.addTest(test_baidu.BaiduTest('test_baidu'))
测试套件是测试用例、 测试套件 或 两者的集合, 用于组装一组要运行的测试,unittest 提供了
TestSuite 来创建测试套件
3. TestRunner
例:
runner = unittest.TextTestRunner()
runner.run(suite)
TestRunner 是一个组件,用于协调测试的执行并向用户提供结果。 TestRunner 可以使用图形界面、文本
界面或返回特殊值来展示执行测试的结果。 unittest 提供了 TextTestRunner 类来运行测试用例, 为了
生成 HTML 格式的测试报告, 后面会选择使用 HTMLTestRunner 运行类。
4. TestFixture
TestFixture 代表执行一个或多个测试用例所需要的环境设备, 以及关联的清理动作。 例如:创临时或
代理数据库、 目录,或启动服务器进程。 unittest 中提供了 setUp(), tearDown(), setUpClass(),
tearDownClass() 等方法来完成这些操作
二、 unittest 模块的各个属性说明
1.unittest的属性如下:
['BaseTestSuite', 'FunctionTestCase', 'SkipTest', 'TestCase', 'TestLoader', 'TestProgram', 'TestResult', 'TestSuite', 'TextTestResult', 'TextTestRunner', '_TextTestResult', '__all__', '__builtins__', '__doc__', '__file__', '__name__', '__package__', '__path__', '__unittest', 'case', 'defaultTestLoader', 'expectedFailure', 'findTestCases', 'getTestCaseNames', 'installHandler', 'loader', 'main', 'makeSuite', 'registerResult', 'removeHandler', 'removeResult', 'result', 'runner', 'signals', 'skip', 'skipIf', 'skipUnless', 'suite', 'util']
说明:
unittest.TestCase: TestCase 类, 所有测试类 继承的基本类
class BaiduTest(unittest.TestCase):
unittest.main():使用她可以方便的将一个单元测试模块变为可直接运行的测试脚本,main()方法使用TestLoader类来搜索所有包含在该模块中以“test”命名开头的测试方法,并自动执行他们。执行方法的默认顺序是:根据ASCII码的顺序加载测试用例,数字与字母的顺序为:0-9,A-Z,a-z。所以以A开头的测试用例方法会优先执行,以a开头会后执行。
unittest.TestSuite():unittest框架的TestSuite()类是用来创建测试套件的。
例:
suit = unittest.TestSuite()
suit.addTest(TestCalculator("test_add"))
suit.addTest(TestCalculator("test_sub"))
unittest.TextTextRunner():unittest框架的TextTextRunner()类,通过该类下面的run()方法来运行suite所组装的测试用例,入参为suite测试套件。
例:
runner = unittest.TextTestRunner()
runner.run(suit)
unittest.defaultTestLoader(): defaultTestLoader()类,通过该类下面的discover()方法可自动更具测试目录start_dir匹配查找测试用例文件(test*.py),并将查找到的测试用例组装到测试套件,因此可以直接通过run()方法执行discover。
例:
suits = unittest.defaultTestLoader.discover(testDir, pattern='test*.py')
runner = unittest.TextTestRunner()
runner.run(suit)
unittest.skip():装饰器,当运行用例时,有些用例可能不想执行等,可用装饰器暂时屏蔽该条测试用例。一种常见的用法就是比如说想调试某一个测试用例,想先屏蔽其他用例就可以用装饰器屏蔽。
@unittest.skip(reason): skip(reason)装饰器:无条件跳过装饰的测试,并说明跳过测试的原因。
@unittest.skipIf(reason): skipIf(condition,reason)装饰器:条件为真时,跳过装饰的测试,并说明跳过测试的原因。
@unittest.skipUnless(reason): skipUnless(condition,reason)装饰器:条件为假时,跳过装饰的测试,并说明跳过测试的原因。
@unittest.expectedFailure(): expectedFailure()测试标记为失败
2.TestCase类的属性如下:
['__call__', '__class__', '__delattr__', '__dict__', '__doc__', '__eq__', '__format__', '__getattribute__', '__hash__', '__init__', '__module__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', '_addSkip', '_baseAssertEqual', '_classSetupFailed', '_deprecate', '_diffThreshold', '_formatMessage', '_getAssertEqualityFunc', '_truncateMessage', 'addCleanup', 'addTypeEqualityFunc', 'assertAlmostEqual', 'assertAlmostEquals', 'assertDictContainsSubset', 'assertDictEqual', 'assertEqual', 'assertEquals', 'assertFalse', 'assertGreater', 'assertGreaterEqual', 'assertIn', 'assertIs', 'assertIsInstance', 'assertIsNone', 'assertIsNot', 'assertIsNotNone', 'assertItemsEqual', 'assertLess', 'assertLessEqual', 'assertListEqual', 'assertMultiLineEqual', 'assertNotAlmostEqual', 'assertNotAlmostEquals', 'assertNotEqual', 'assertNotEquals', 'assertNotIn', 'assertNotIsInstance', 'assertNotRegexpMatches', 'assertRaises', 'assertRaisesRegexp', 'assertRegexpMatches', 'assertSequenceEqual', 'assertSetEqual', 'assertTrue', 'assertTupleEqual', 'assert_', 'countTestCases', 'debug', 'defaultTestResult', 'doCleanups', 'fail', 'failIf', 'failIfAlmostEqual', 'failIfEqual', 'failUnless', 'failUnlessAlmostEqual', 'failUnlessEqual', 'failUnlessRaises', 'failureException', 'id', 'longMessage', 'maxDiff', 'run', 'setUp', 'setUpClass', 'shortDescription', 'skipTest', 'tearDown', 'tearDownClass']
说明:
setUp():setUp()方法用于测试用例执行前的初始化工作。如测试用例中需要访问数据库,可以在setUp中建立数据库连接并进行初始化。如测试用例需要登录web,可以先实例化浏览器。
tearDown():tearDown()方法用于测试用例执行之后的善后工作。如关闭数据库连接。关闭浏览器。
assert*():一些断言方法:在执行测试用例的过程中,最终用例是否执行通过,是通过判断测试得到的实际结果和预期结果是否相等决定的。
assertEqual(a,b,[msg='测试失败时打印的信息']):断言a和b是否相等,相等则测试用例通过。
assertNotEqual(a,b,[msg='测试失败时打印的信息']):断言a和b是否相等,不相等则测试用例通过。
assertTrue(x,[msg='测试失败时打印的信息']):断言x是否True,是True则测试用例通过。
assertFalse(x,[msg='测试失败时打印的信息']):断言x是否False,是False则测试用例通过。
assertIs(a,b,[msg='测试失败时打印的信息']):断言a是否是b,是则测试用例通过。
assertNotIs(a,b,[msg='测试失败时打印的信息']):断言a是否是b,不是则测试用例通过。
assertIsNone(x,[msg='测试失败时打印的信息']):断言x是否None,是None则测试用例通过。
assertIsNotNone(x,[msg='测试失败时打印的信息']):断言x是否None,不是None则测试用例通过。
assertIn(a,b,[msg='测试失败时打印的信息']):断言a是否在b中,在b中则测试用例通过。
assertNotIn(a,b,[msg='测试失败时打印的信息']):断言a是否在b中,不在b中则测试用例通过。
assertIsInstance(a,b,[msg='测试失败时打印的信息']):断言a是是b的一个实例,是则测试用例通过。
assertNotIsInstance(a,b,[msg='测试失败时打印的信息']):断言a是是b的一个实例,不是则测试用例通过。
3.TestSuite类的属性如下:(组织用例时需要用到)
['__call__', '__class__', '__delattr__', '__dict__', '__doc__', '__eq__', '__format__', '__getattribute__', '__hash__', '__init__', '__iter__', '__module__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', '_addClassOrModuleLevelException', '_get_previous_module', '_handleClassSetUp', '_handleModuleFixture', '_handleModuleTearDown', '_tearDownPreviousClass', '_tests', 'addTest', 'addTests', 'countTestCases', 'debug', 'run']
说明:
addTest(): addTest()方法是将测试用例添加到测试套件中,如下方,是将test_baidu模块下的BaiduTest类下的test_baidu测试用例添加到测试套件。
suite = unittest.TestSuite()
suite.addTest(test_baidu.BaiduTest('test_baidu'))
4.TextTextRunner的属性如下:(组织用例时需要用到)
['__class__', '__delattr__', '__dict__', '__doc__', '__format__', '__getattribute__', '__hash__', '__init__', '__module__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', '_makeResult', 'buffer', 'descriptions', 'failfast', 'resultclass', 'run', 'stream', 'verbosity']
说明:
run(): run()方法是运行测试套件的测试用例,入参为suite测试套件。
runner = unittest.TextTestRunner()
runner.run(suite)