dangkai

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 unittest
from HTMLTestRunner3 import HTMLTestRunner
import sys
import os
import time

#定义测试类,父类为unittest.TestCase
#可继承unittest.TestCase的方法,如setUp和tearDown方法,不过此方法可以在子类重写,覆盖父类方法
#可继承unittest.TestCase的断言
class Mydemo(unittest.TestCase):

    def setUp(self):
        self.number=1
        self.desc=\'test\'
        print("Test start")

    def test1(self):
        try:#异常处理
            self.number=2
            print(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) \'\'\'

 

分类:

技术点:

相关文章: