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)