unittest单元测试框架总结

unittest单元测试框架既可以适用于单元测试，也能够适用WEB自动化测试用例的开发与执行，该测试框架可组织执行测试用例，并且提供了丰富的断言方法，判断测试用例是否通过，最终生成测试结果。今天笔者就总结下如何使用unittest单元测试框架来进行WEB自动化测试。

代码结构介绍 :

case.py         TestCase的基础类,assert函数

loader.py      对测试文件分析,完成生成测试用例列表

main.py        unittest的主函数,解析参数,调用各个模块,完成生成测试用例列表,运行测试用例,生成测试结果

result.py       生成和处理测试结果

runner.py     运行测试用例或测试用例集

signals.py    对信号量注册,发出中断等信号的处理方法

suite.py        配置测试用例集合的

util.py          工具函数包

test               unitest使用的例子

先来聊一聊unittest模块的各个属性，所谓知己知彼方能百战百胜，了解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 Mydemo(unittest.TestCase):

unittest.main():使用她可以方便的将一个单元测试模块变为可直接运行的测试脚本，main()方法使用TestLoader类来搜索所有包含在该模块中以“test”命名开头的测试方法，并自动执行他们。执行方法的默认顺序是：根据ASCII码的顺序加载测试用例，数字与字母的顺序为：0-9，A-Z，a-z。所以以A开头的测试用例方法会优先执行，以a开头会后执行。

unittest.TestSuite()：unittest框架的TestSuite()类是用来创建测试套件的。

unittest.TextTextRunner():unittest框架的TextTextRunner()类，通过该类下面的run()方法来运行suite所组装的测试用例，入参为suite测试套件。

unittest.defaultTestLoader(): defaultTestLoader()类，通过该类下面的discover()方法可自动更具测试目录start_dir匹配查找测试用例文件(test*.py)，并将查找到的测试用例组装到测试套件，因此可以直接通过run()方法执行discover。用法如下：

discover=unittest.defaultTestLoader.discover(test_dir, pattern='test_*.py')

如：

test_dir = os.getcwd()

unittest.defaultTestLoader.discover(start_dir=test_dir, pattern='test*.py', top_level_dir=None)跟据指定目录下所有测试模块，可以查询到子目录下的测试模块，只有匹配到文件名才能被加载，如果不是顶层目录，那么顶层目录必须单独指定

stat_dir：要测试的模块名或者用例目录

pattern=‘test*.py’：文件的匹配原则，此处表示以‘test’开头，以‘py’结尾，‘*’表示任意多个字符

top_level_dir=None：测试模块的顶层目录，如果没有顶层目录，默认为none

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测试用例添加到测试套件。

TestSuite = unittest.TestSuite()

TestSuite.addTest(Mydemo.test1)

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测试套件。

TestSuite =unittest.TextTestRunner()

runner.run(TestSuite)

二、使用unittest框架编写测试用例思路

设计基本思路如下：

import unittestfromHTMLTestRunner3 import HTMLTestRunner

import sys

import os

import time

#定义测试类，父类为unittest.TestCase

#可继承unittest.TestCase的方法，如setUp和tearDown方法，不过此方法可以在子类重写，覆盖父类方法

#可继承unittest.TestCase的断言classMydemo(unittest.TestCase):

def setUp(self):

self.number=1self.desc='test'print("Test start")

def test1(self):try:#异常处理

self.number=2print(self.number)

self.assertEqual(self.number,2,msg='number不是1')

except:

print("无效的")

pass

# @unittest.skip

def test2(self):

print(self.number)

self.assertEqual(self.number,1,msg='number不是1')

# @unittest.skip('暂时跳过该用例')

def test3(self):

print("excute test3")

@unittest.expectedFailure#用例失败了不计入失败case

def test4(self):

print("excute test4")

def tearDown(self):

print('Test over')

#8如果直接运行该文件(__name__值为__main__),则执行以下语句，常用于测试脚本是否能够正常运行

if __name__=='__main__':

#8.1执行测试用例方案一如下：

#unittest.main()方法会搜索该模块下所有以test开头的测试用例方法，并自动执行它们。

#执行顺序是命名顺序：先执行test1，再执行test2、test3、test4

unittest.main()

'''

#8.2执行测试用例方案二如下：

#8.2.1先构造测试集

#8.2.1.1实例化测试套件

suite=unittest.TestSuite()

#8.2.1.2将测试用例加载到测试套件中。

#执行顺序是安装加载顺序：先执行test2，再执行tes1

suite.addTest(Test('test2'))

suite.addTest(Test('test'))

#8.2.2执行测试用例

#8.2.2.1实例化TextTestRunner类

runner=unittest.TextTestRunner()

#8.2.2.2使用run()方法运行测试套件(即运行测试套件中的所有用例)

runner.run(suite)

'''

'''

#8.3执行测试用例方案三如下：

#8.3.1构造测试集(简化了方案二中先要创建测试套件然后再依次加载测试用例)

#执行顺序同方案一：执行顺序是命名顺序：先执行test_case1，再执行test_case2

test_dir = './'

discover = unittest.defaultTestLoader.discover(test_dir, pattern='test_*.py')

#8.3.2执行测试用例

#8.3.2.1实例化TextTestRunner类

runner=unittest.TextTestRunner()

#8.3.2.2使用run()方法运行测试套件(即运行测试套件中的所有用例)

runner.run(discover)

'''