单元测试unittest

一、定义

unittest单元测试框架不仅可以适用于单元测试，还可以适用WEB自动化测试用例的开发与执行，该测试框架可组织执行测试用例，并且提供了丰富的断言方法，判断测试用例是否通过，最终生成测试结果。

unittest通过建立类并继承父类unittest.TestCase将用例组织起来，统一执行

示例：

import unittest
class Testcase(unittest.TestCase):#类继承unittest.TestCase
    def setUp(self):#每条用例运行前，运行。一般可用来做些准备工作
        print('我是setup，什么时候运行')

    def tearDown(self):#每条用例结束后，运行，一般可用来做些收尾工作
        print('teardown什么时候运行')
    def testa(self):
        print('测试用例a')
        self.assertEqual(1,2,'计算结果不正确')
        #assertEqual是父类unittest.TestCase的函数，用来验证实际结果是否与预期结果相等
       #第一个参数是预期结果，第二个参数是实际结果，第三个参数是当前面两个不相等时，回显示的提示信息。第三个参数是非必填的
    def testb(self):
        '''这里是测试用例的描述，会最终显示在测试报告中的，必须用三个单引号括起来才可以，用#d不行'''
        print('测试用例b')
        self.assertEqual(1,1)
    def c(self):
        print('c函数不是以test开头的，所以不会当做用例被执行')
        # self.assertIn('a','abc')
    @classmethod
    def setUpClass(cls):#所有的用例运行前，运行setupClass
        print('什么时候运行setupClass')
    def tearDownClass(cls):#所有用例运行后，执行tearDownClass
        print('什么时候运行tearDownClass')

unittest.main()#执行当前python文件中的所有用例，会在控制台显示运行结果，不会产生测试报告
#运行的时候不要右键运行run unittest for...，这个是pycharm自己给运行的unittest,不会产生测试报告
# 应点击菜单栏中Run--run,弹出提示框后，选择自己要运行的文件进行run
#函数名用例必须以test开头，才会被执行

二、用例集suite+HTMLTestRunner/BeautifulReport

用例集即测试套件，可以吧所有的用例放入用例集当中执行，并结合HTMLTestRunner或者BeautifulReport产生出直观的漂亮的测试报告

#-------------------------------------------------------------------HTMLTestRunner写报告（丑）
#将下载好的HTMLTestRunner.py 放到 pycharm的External Libraries目录下的lib目录下，然后导入：import HTMLTestRunner,紧接着上面的代码：（把unittest.main注释掉）

suite=unittest.TestSuite()#定义用例集，是个list
suite.addTest(unittest.makeSuite(Testcase))#将类TestCase先变成一个用例集合，然后再加入到suite中
f=open('测试报告.html','wb')#建立一个测试报告文件
runner=HTMLTestRunner.HTMLTestRunner(f,title='测试报告标题',description='测试报告描述')#title和decription都是非必填。将用例结果写入测试报告.html
runner.run(suite)#运行用例集,用例执行的顺序是按照字母排序的

然后通过run-run选中要执行的当前文件，运行后，就会产生一个html格式的报告，可用浏览器打开，如下：

#--------------------------------------------------------BeautifulReport 报告

#下载BeautifulReport ,解压后运行setup.py。可以将解压后的文件拷贝到pycharm中，然后运行setup.py也可。然后要导入：

from BeautifulReport import BeautifulReport as bf #bf就是个别名，方便使用

suite=unittest.TestSuite()#定义用例集，是个list
suite.addTest(unittest.makeSuite(Testcase))#将类TestCase先变成一个用例集合，然后再加入到suite中
report=bf(suite)##先实例化这个类
report.report(description='用例描述',filename='用例文件名字')
#description必填参数,log_path是非必写的，默认在当前目录下。也可以定义别的目录
#filename可写可不写，回自动生成个名字。名字后缀默认就是html。可写上也可不写

执行后，生成html格式报告：打开：

 

 三、用unittest测接口示例

1、接口数据：yaml格式文件，存有3条用例数据

2、用ddt自动读取用例数据并传递给测试类中的测试用例函数

3、执行用例

4、写报告

用例数据

- #用减号-区分不同的用例。最终是个list,然后每个list是个字典:  [{}{}]
  url: /api/user/login
  detail: 正常登录
  method: post
  data:
    username: aaa
    passwd: aA123456
  check:
    - userId
    - error_code

-
  url: /api/user/login
  detail: 密码错误
  method: post
  data:
    username: aaa
    passwd: aA1234
  check:
    - 密码错误

-
  url: /api/user/login
  detail: 必填参数未填，用户名不传
  method: post
  data:
    passwd: aA1234
  check:
    - 必填参数未填

接口测试代码：获取数据，执行测试用例并发送测试结果报告

import unittest
import  ddt#自动读取文件内容,该模块需要先安装pip install ddt
import requests
from BeautifulReport import BeautifulReport as bf
from urllib import parse
@ddt.ddt #声明这个类要用ddt
class Login(unittest.TestCase):
    base_url='http://100.20.20.40'
    @ddt.file_data('login1.yaml')#ddt自动读取文件，并获取内容传给下面的函数，循环调用.运行如果出现字符编码问题，就直接打开file_data源文件，搜索open，将打开文件的代码中，加上encoding=utf-8
    def test_request(self,**kwargs):#**kwargs可以传入字典参数，不限个数.此处用来接收从login1.yaml中读出来的用例，是字典
        detail=kwargs.get('detail','没写用例描述')#如果没有定义detail，默认给个值’没写用例描述‘
        self._testMethodDoc=detail#设置用例描述

        url=kwargs.get('url')
        url=parse.urljoin(self.base_url,url)#自动拼接url,
        method=kwargs.get('method','get')#method默认给个get方法
        data=kwargs.get('data',{})#如果没给data,默认给个空字典
        header=kwargs.get('header',{})#如果没有header参数，默认给个空字典
        cookie=kwargs.get('cookie',{})
        check=kwargs.get('check')#获取login1.yaml中的预期结果check,是list
        method=method.lower()#
        try:
            if method=='get':
                res=requests.get(url,params=data,cookies=cookie,headers=header).text
                #因为实际结果失败的话，不会返回json串，所以不能转成字典
            else:
                res=requests.post(url,data,cookies=cookie,headers=header).text
        except Exception as e:
            print('接口请求出错')
            res=e
        for c in check:#循环遍历check中的所有预期结果，判断是否包含在实际结果中
            self.assertIn(c,res,msg='预期结果不符，预期结果%s,实际结果%s'%(c,res))#断言，如果预期结果在实际结果中，pass.否则断言失败并给出错误信息msg
suite=unittest.TestSuite()
suite.addTest(unittest.makeSuite(Login))
run=bf(suite)
run.report('login_test','登录测试用例')#第一个是描述，第二个是文件名
print(run.success_count)#通过的次数
print(run.failure_count)#失败次数)

笔者创建了一个测试交流群，如果对软件测试、接口测试、自动化测试、面试经验交流感兴趣可以加测试交流群：829792258，还会有同行一起技术交流