unittest的基本使用（一）

╰半夏微凉° 2023-07-12 08:57 35阅读 0赞

### 文章目录 ###

*   *   *  1. 测试用例实现的方法
         *  2. 测试用例类
         *  3. 执行测试用例

unittest 单元测试框架是受到 JUnit 的启发，与其他语言中的主流单元测试框架有着相似的风格。其支持测试自动化，配置共享和关机代码测试。支持将测试样例聚合到测试集中，并将测试与报告框架独立。

为了实现这些，unittest 通过面向对象的方式支持了一些重要的概念：

*  **TestCase**：见名知意，就是测试用例
 *  **TestSuite**：测试套件，用来存放多个测试用例。其中又包含TestLoader模块，用来加载TestCase
 *  **TextTestRunner**：用来执行测试用例
 *  **fixture**：测试用例环境的搭建和销毁。**环境搭建（SetUp），执行测试用例（Run），以及测试后用例的还原（tearDown）**

我们一般将一个完整的测试用例分成三部分：测试用例实现的方法，测试用例，测试用例的执行。  
这里就分成三个py文件来分别讲解一个注册页面测试用例的实现

### 1. 测试用例实现的方法 ###

这个会用到之前所学的python基本方法，这里直接将代码贴出：

‘’‘
    函数入参：
    注意：参数传字符串类型，不需要考虑其他类型。
    参数1：账号
    参数2：密码1
    参数2：密码2
    
    函数内部处理的逻辑：
       判断是否有参数为空，
        判断账号密码是否在6-18位之间，
        判断账号是否被注册过，
        判断两个密码是否一致。
        上面添加都校验通过才能注册成功，其他情况都注册失败，
    各种情况的返回结果如下：
       注册成功               返回结果：{"code": 1, "msg": "注册成功"}
       有参数为空，            返回结果 {"code": 0, "msg": "所有参数不能为空"}
       两次密码不一致          返回结果：{"code": 0, "msg": "两次密码不一致"}
       账户已存在             返回结果：{"code": 0, "msg": "该账户已存在"}
       密码不在6-18位之间      返回结果：{"code": 0, "msg": "账号和密码必须在6-18位之间"}
       账号不在6-18位之间      返回结果：{"code": 0, "msg": "账号和密码必须在6-18位之间"}
    
    ‘’‘
    
    # 这是一个已经存在的用户的基本信息
    users = [{'user': 'python_tester', 'password': '123456'}]
    
    # 注册方法的实现
    def register(username, password1, password2):
        # 判断是否有参数为空
        if not all([username, password1, password2]):
            return {"code": 0, "msg": "所有参数不能为空"}
        # 注册功能
        for user in users:  # 遍历出所有账号，判断账号是否存在
            if username == user['user']:
                # 账号存在
                return {"code": 0, "msg": "该账户已存在"}
        else:
            if password1 != password2:
                # 两次密码不一致
                return {"code": 0, "msg": "两次密码不一致"}
            else:
                # 账号不存在 密码不重复，判断账号密码长度是否在 6-18位之间
                if 6 <= len(username) <= 18 and 6 <= len(password1) <= 18:
                    # 注册账号
                    users.append({'user': username, 'password': password2})
                    return {"code": 1, "msg": "注册成功"}
                else:
                    # 账号密码长度不对，注册失败
                    return {"code": 0, "msg": "账号和密码必须在6-18位之间"}

### 2. 测试用例类 ###

知晓了注册的实现方法之后，我们就需要写测试用例来对这个方法进行单元测试了，这里使用**unittest框架**，下面意思意思的写三个测试用例，主要介绍一下测试用例方法书写的主要思路：

1.  写一个测试用例类，该类必须继承自unittest.TestCase类，否则无法使用unittest框架
2.  在用例类中开始写一个一个的用例，用例名称这里有几个需要注意的点：  
    1.以 **test 开头的方法**才能够被 unittest 框架认定为一个测试用例，否则是不会被当做测试用例执行的  
    2.测试用例的执行顺序取决于方法名的ASCII编码，所以，写多个有关联的测试用例的时候请一定注意方法名称
3.  每个测试用例中大致分为三步，在第一个方法中有具体说明。

import unittest
    from homework.day14_unittest.registerfunction import register
    
    
    class RegisterTestCase(unittest.TestCase):
    
        def test_register(self):
        	# 第一步：准备测试数据，入参和期望结果等。
            expected = {"code": 1, "msg": "注册成功"}
            data = ['python14', '123456', '123456']
            # 第二步：获取实际结果（调用之前写的相关功能函数，传入准备好的参数，获得返回的结果）
            res = register(*data)
            # 第三步：断言（判断实际结果是否和预期结果相同）
            self.assertEqual(expected, res)
    
        def test_register_exist(self):
            expected = {"code": 0, "msg": "该账户已存在"}
            data = ['python14', '123456', '123456']
            res = register(*data)
            self.assertEqual(expected, res)
    
        def test_user_null(self):
            expected = {"code": 0, "msg": "所有参数不能为空"}
            data = [None,'123456', '123456']
            res = register(*data)
            self.assertEqual(expected, res)

测试用例类是能够单独执行的，在 pycharm 中，点击测试用例类左侧的绿色小箭头就能够执行整个类中的测试用例，点击每一个测试用例前的绿色小箭头也能够单独执行该用例哦，如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3_size_16_color_FFFFFF_t_70]  
执行之后再下方控制台显示信息如图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3_size_16_color_FFFFFF_t_70 1]

### 3. 执行测试用例 ###

虽然点击每个测试用例前的绿色小箭头也能够执行该类的所有测试用例，但是这个方法很不科学，接下来我们学习一种很科学的方法 。 get！٩( ‘ω’ )و  
这里需要引入博客最开始说过的 TestSuit 方法了，大体思路就是:

1.  我们先实例化一个 suite
2.  然后使用 TestLoad 方法，将我们要执行的测试用例 Load 到之前的实例对象 suite 里面
3.  最后我们就可以用 suite 里面的 run 方法将用例执行了。 或者我们也可以用测试报告里面的run方法执行用例并生成对应的测试报告。

好，思路讲完了，就应该开始实战练习啦：

import unittest
    from homework.day14_unittest.test_registecase import RegisterTestCase
    import homework.day14_unittest.test_registecase as test_registecase
    from BeautifulReport import BeautifulReport
    from HTMLTestRunnerNew import HTMLTestRunner
    
    # 第一步：创建一个测试套件 suite
    # suite = unittest.TestSuite()
    # # 第二步：加载测试用例到套件
    # # 第二步又有好几种方法用来加载测试用例，这里我们一一介绍
    # # 2.1 通过测试用例类来加载
    # loader = unittest.TestLoader()
    # suite.addTest(loader.loadTestsFromTestCase(RegisterTestCase))    # 方法中传入的是测试用例类名
    # # 2.2 通过测试用例模块来加载
    # suite.addTest(loader.loadTestsFromModule(test_registecase))     # 方法中传入的是测试用例模块名
    # # 2.3 通过路径去加载测试用例（强烈推荐！）
    # suite.addTest(loader.discover(r'E:\Python_selenium_advance\homework\day14_unittest'))   # 方法中路径只到文件夹名即可，不要具体到哪个py文件
    # # 2.4 一条一条用例去加载(调试的时候可用，但是为什么我不直接在测试用例类中去调呢？来自咸鱼的见解)
    # case = RegisterTestCase('test_register_exist')    # 找到RegisterTestCase类下的test_register_exist测试用例
    # suite.addTest(case)
    # 第一步+第二步的最推荐方法组合版！
    suite = unittest.defaultTestLoader.discover(r'E:\Python_selenium_advance\homework\day14_unittest')
    # 第三步：执行我们的suite
    # runner = unittest.TextTestRunner()
    # runner.run(suite)
    # 第三步加强版 1：使用BeautifulReport来执行测试用例并且生成报告
    br = BeautifulReport(suite)
    # 第一个参数为用例描述，第二个为生成报告的名称，必须以.html结尾，第三个参数是报告文件存放路径，可填可不填，不填就放在本文件相同文件夹下。
    br.report('注册用例的第一次执行报告','test_report.html')
    # 第三步加强版 2：使用HTMLTestRunner来执行测试用例并且生成报告
    # HTMLTestRunner是一个第三方工具，需要自己下载后打包到项目下
    #runner = HTMLTestRunner(stream=open('test_report2.html', 'wb'), title='注册模块测试用例执行情况', tester='kaishui',
                            description='这是1.0版本的测试报告')
    # runner.run(suite)

HTMLTestRunner我执行之后没有生成测试报告，找了很久都没有找到解决办法，所以这里只有不贴图啦。。。  
BeautifulReport的执行结果如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3_size_16_color_FFFFFF_t_70 2]

最后总结一下：  
如果你对此文有任何疑问，如果你也需要接口项目实战，如果你对软件测试、接口测试、自动化测试、面试经验交流感兴趣欢迎加入：软件测试技术群：**593462778**，群里的免费资料都是笔者十多年测试生涯的精华。还有同行大神一起交流技术哦。

作者：暗潮汹涌  
原创不易，欢迎转载，但未经作者同意请保留此段声明，并在文章页面明显位置给出原文链接。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200307224726688.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200307225014355.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200307235317967.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0NjU5Nzc3,size_16,color_FFFFFF,t_70