赞
踩
一、Python+unittest+requests+HTMLTestRunner 完整的接口自动化测试框架搭建_00——框架结构简解
大家可以先简单了解下该项目的目录结构介绍,后面会针对每个文件有详细注解和代码。
common:
——configDb.py:这个文件主要编写数据库连接池的相关内容,本项目暂未考虑使用数据库来存储读取数据,此文件可忽略,或者不创建。本人是留着以后如果有相关操作时,方便使用。
——configEmail.py:这个文件主要是配置发送邮件的主题、正文等,将测试报告发送并抄送到相关人邮箱的逻辑。
——configHttp.py:这个文件主要来通过get、post、put、delete等方法来进行http请求,并拿到请求响应。
——HTMLTestRunner.py:主要是生成测试报告相关
——Log.py:调用该类的方法,用来打印生成日志
result:
——logs:生成的日志文件
——report.html:生成的测试报告
testCase:
——test01case.py:读取userCase.xlsx中的用例,使用unittest来进行断言校验
testFile/case:
——userCase.xlsx:对下面test_api.py接口服务里的接口,设计了三条简单的测试用例,如参数为null,参数不正确等
caselist.txt:配置将要执行testCase目录下的哪些用例文件,前加#代表不进行执行。当项目过于庞大,用例足够多的时候,我们可以通过这个开关,来确定本次执行哪些接口的哪些用例。
config.ini:数据库、邮箱、接口等的配置项,用于方便的调用读取。
getpathInfo.py:获取项目绝对路径
geturlParams.py:获取接口的URL、参数、method等
readConfig.py:读取配置文件的方法,并返回文件中内容
readExcel.py:读取Excel的方法
runAll.py:开始执行接口自动化,项目工程部署完毕后直接运行该文件即可
test_api.py:自己写的提供本地测试的接口服务
test_sql.py:测试数据库连接池的文件,本次项目未用到数据库,可以忽略
二、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_01——测试接口服务
一个简单的接口测试小例子
-
- import json
- from pip._vendor import requests
-
- headers={
- "token": "token",
- "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_2_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/8.0.18(0x1800122c) NetType/WIFI Language/zh_CN",
- "Accept-Encoding": "gzip",
- "Accept-Language": "zh-CN,zh;q=0.9",
- "Content-Type": "application/json",
- "Content-Length": "129",
- }
-
- def login():
- url = "xxxxxx/app/user/login"
- data={
- "pwd": "xxxx",
- "name": "xxxxxx"
- }
-
- luckyUrl = requests.post(url=url, data=json.dumps(data), headers=headers)
- result=luckyUrl.json()
- print(luckyUrl.text)
- # print(luckyUrl.status_code)
- # print(result['status'])
- if result['status']==0:
- print ("登录成功")
- else:
- print("登录失败")
-
- if __name__ == '__main__':
- login()
-
-
三、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_02——配置文件读取
这个配置文件按照作者抄写的,但是后续发送邮件直接写死,没有用到里面的配置,后续再研究
- [DATABASE]
- host =
- username =
- password =
- port =
- database =
-
- [HTTP]
- # 接口的url
- scheme = https
- baseurl = url
- port = 443
- timeout = 1.0
-
- [EMAIL]
- on_off = off
- #在邮件中on_off是设置的一个开关,=on打开,发送邮件,=其他不发送邮件
- mail_host = smtp.qq.com
- mail_user = xxxxxx@qq.com
- mail_pass = xxxxx
- mail_port = 25
- sender = xxxxx@qq.com
- receiver = xxxxx@qq.com
- subject = python
- content = "All interface test has been complited\nplease read the report file about the detile of result in the attachment."
- testuser = qiugongyuan
在HTTP中,协议http,baseURL,端口,超时时间。
在邮件中on_off是设置的一个开关,=on打开,发送邮件,=其他不发送邮件。subject邮件主题,addressee收件人,cc抄送人。
在我们编写readConfig.py文件前,我们先写一个获取项目某路径下某文件绝对路径的一个方法。按第一讲的目录结构创建好getpathInfo.py,打开该文件
- import os
-
-
- def get_Path():
- path = os.path.split(os.path.realpath(__file__))[0]
- return path
-
-
- if __name__ == '__main__': # 执行该文件,测试下是否OK
- print('测试路径是否OK,路径为:', get_Path())
填写如上代码并执行后,查看输出结果,打印出了该项目的绝对路径:
继续往下走,同理,按第一讲目录创建好readConfig.py文件,打开该文件,以后的章节不在累赘
- import os
- import configparser
- import getpathInfo # 引入我们自己的写的获取路径的类
-
- path = getpathInfo.get_Path() # 调用实例化
- config_path = os.path.join(path,
- 'config.ini') # 这句话是在path路径下再加一级
- config = configparser.ConfigParser() # 调用外部的读取配置文件的方法
- config.read(config_path, encoding='utf-8')
-
-
- class ReadConfig():
-
- def get_http(self, name):
- value = config.get('HTTP', name)
- return value
-
- def get_email(self, name):
- value = config.get('EMAIL', name)
- return value
-
- def get_mysql(self, name): # 写好,留以后备用。但是因为我们没有对数据库的操作,所以这个可以屏蔽掉
- value = config.get('DATABASE', name)
- return value
-
-
- if __name__ == '__main__': # 测试一下,我们读取配置文件的方法是否可用
- print('HTTP中的baseurl值为:', ReadConfig().get_http('baseurl'))
- print('EMAIL中的开关on_off值为:', ReadConfig().get_email('on_off'))
执行下readConfig.py,查看数据是否正确
四、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_03——读取Excel中的case
配置文件写好了,然后我们来根据我们的接口设计我们简单的几条用例。首先在前两讲中我们写了一个我们测试的接口服务,针对这个接口服务存在三种情况的校验。正确的用户名和密码,账号密码错误和账号密码为空
我们根据上面的三种情况,将对这个接口的用例写在一个对应的单独文件中,testcase.xlsx
紧接着,我们有了用例设计的Excel了,我们要对这个Excel进行数据的读取操作,继续往下,我们创建readExcel.py文件
- import os
- import getpathInfo # 自己定义的内部类,该类返回项目的绝对路径
- # 调用读Excel的第三方库xlrd
- from xlrd import open_workbook
-
- # 拿到该项目所在的绝对路径
- path = getpathInfo.get_Path()
-
-
-
- class readExcel():
- def get_xls(self, xls_name, sheet_name): # xls_name填写用例的Excel名称 sheet_name该Excel的sheet名称
- cls = []
- # 获取用例文件路径
- xlsPath = os.path.join(path, xls_name)
- file = open_workbook(xlsPath) # 打开用例Excel
- sheet = file.sheet_by_name(sheet_name) # 获得打开Excel的sheet
- # 获取这个sheet内容行数
- nrows = sheet.nrows
- for i in range(nrows): # 根据行数做循环
- if sheet.row_values(i)[0] != u'test_case': # 如果这个Excel的这个sheet的第i行的第一列不等于case_name那么我们把这行的数据添加到cls[]
- cls.append(sheet.row_values(i))
- return cls
-
-
- if __name__ == '__main__': # 我们执行该文件测试一下是否可以正确获取Excel中的值
- print(readExcel().get_xls('testcase.xlsx', 'login'))
- print(readExcel().get_xls('testcase.xlsx', 'login')[0][1])
- print(readExcel().get_xls('testcase.xlsx', 'login')[1][2])
- print(readExcel().get_xls('testcase.xlsx', 'login')[2][3])
-
运行一下
五、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_04——requests请求
配置文件有了,读取配置文件有了,用例有了,读取用例有了,我们的接口服务有了,我们是不是该写对某个接口进行http请求了,这时候我们需要使用pip install requests来安装第三方库,在common下configHttp.py,configHttp.py的内容如下:
- import requests
- import json
-
- headers = {
- "token":"token",
- "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_2_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/8.0.18(0x1800122c) NetType/WIFI Language/zh_CN",
- "Accept-Encoding": "gzip",
- "Accept-Language": "zh-CN,zh;q=0.9",
- "Content-Type": "application/json",
- "Content-Length": "129",
- }
-
-
- class RunMain():
-
- def send_post(self, url, data): # 定义一个方法,传入需要的参数url和data
- # 参数必须按照url、data顺序传入
- result = requests.post(url=url, data=json.dumps(data), headers=headers) # 因为这里要封装post方法,所以这里的url和data值不能写死
- # result = requests.post(url=url, data=data, headers=headers)#后续读取excel,需要用到这个格式传参data
- res = result.json()
- return res
-
- def send_get(self, url, data):
- result = requests.get(url=url, data=data, headers=headers)
- res = result.json()
- return res
-
- def run_main(self, method, url=None, data=None): # 定义一个run_main函数,通过传过来的method来进行不同的get或post请求
- result = None
- if method == 'post':
- result = self.send_post(url, data)
- elif method == 'get':
- result = self.send_get(url, data)
- else:
- print("method值错误!!!,method:%s" % (str(method)))
- return result
-
-
- if __name__ == '__main__': # 通过写死参数,来验证我们写的请求是否正确
- result1 = RunMain().run_main('post','xxxxxx/app/user/login',
- {"pwd": "888888", "name": "xxxx"})
-
- print(result1)
运行一下:
六、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_05——参数动态化
写一个类,动态获取URL
- import readConfig as readConfig
-
- readconfig = readConfig.ReadConfig()
-
-
- class geturlParams(): # 定义一个方法,将从配置文件中读取的进行拼接
- def get_Url(self):
- new_url = readconfig.get_http('scheme') + '://' + readconfig.get_http('baseurl') + '/app/user/login'
-
- return new_url
-
-
- if __name__ == '__main__': # 验证拼接后的正确性
- print(geturlParams().get_Url())
后续跑了一下,发现url在这里写死了,没有参数化,后续test01case.py文件读取excel里的url进行完整url拼接,更改一下:
- import readConfig as readConfig
-
- readconfig = readConfig.ReadConfig()
-
-
- class geturlParams(): # 定义一个方法,将从配置文件中读取的进行拼接
- def get_Url(self):
- new_url = readconfig.get_http('scheme') + '://' + readconfig.get_http('baseurl')
-
- return new_url
-
-
- if __name__ == '__main__': # 验证拼接后的正确性
- print(geturlParams().get_Url())
七、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_06——unittest断言
以上的我们都准备好了,剩下的该写我们的unittest断言测试case了,在testCase下创建test01case.py文件,文件中内容如下:
- import unittest
- from common import configHttp
- import paramunittest
- import geturlParams
- import readExcel
-
- login_xls = readExcel.readExcel().get_xls('testcase.xlsx', 'login')
-
-
- @paramunittest.parametrized(*login_xls)
- class testUserLogin(unittest.TestCase):
- def setParameters(self, case_name, path, data, method):
-
- self.case_name = str(case_name)
- self.path = str(path)
- self.data = str(data)
- self.method = str(method)
-
- def description(self):
-
- self.case_name
-
- def setUp(self):
-
- print("测试项目:" + self.case_name)
- print("测试路径:" + self.path)
-
- def test01case(self):
- self.checkResult()
-
- def tearDown(self):
- print("测试结束,输出log完结\n\n")
-
- def checkResult(self):
-
- url = geturlParams.geturlParams.get_Url(self)
- info = configHttp.RunMain().run_main(self.method, url=url, data=self.data)
- print(info)
-
- if self.case_name == 'login': # 如果case_name是login
- self.assertEqual(info['status'], 0)
- if self.case_name == 'login_error': # 如果case_name是login_error
- self.assertEqual(info['msg'], '密码有误')
- if self.case_name == 'login_null': # 如果case_name是login_null
- self.assertEqual(info['msg'], 'Pwd不能为空,Name不能为空')
这个时候,就需要将configHttp里的send_post()方法里的result更改为
result = requests.post(url=url, data=data, headers=headers)#后续读取excel,需要用到这个格式传参data
运行一下:
优化一:这里没有将url参数化,后续优化了一下,通过get_url方法+拼接excel里的url,获取完整的url:
优化二:如果需要校验返回结果里的Json里面的结果,尝试用了一下jsonpath,参考链接:
在接口自动化测试中,如何利用Pytest + JSONPath 进行接口响应断言_刘春明的博客-CSDN博客
八、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_07——HTMLTestRunner
按我的目录结构,在common下创建HTMLTestRunner.py文件,内容如下:
- # -*- coding: utf-8 -*-
- """
- A TestRunner for use with the Python unit testing framework. It
- generates a HTML report to show the result at a glance.
- The simplest way to use this is to invoke its main method. E.g.
- import unittest
- import HTMLTestRunner
- ... define your tests ...
- if __name__ == '__main__':
- HTMLTestRunner.main()
- For more customization options, instantiates a HTMLTestRunner object.
- HTMLTestRunner is a counterpart to unittest's TextTestRunner. E.g.
- # output to a file
- fp = file('my_report.html', 'wb')
- runner = HTMLTestRunner.HTMLTestRunner(
- stream=fp,
- title='My unit test',
- description='This demonstrates the report output by HTMLTestRunner.'
- )
- # Use an external stylesheet.
- # See the Template_mixin class for more customizable options
- runner.STYLESHEET_TMPL = '<link rel="stylesheet" href="my_stylesheet.css" type="text/css">'
- # run the test
- runner.run(my_test_suite)
- ------------------------------------------------------------------------
- Copyright (c) 2004-2007, Wai Yip Tung
- All rights reserved.
- Redistribution and use in source and binary forms, with or without
- modification, are permitted provided that the following conditions are
- met:
- * Redistributions of source code must retain the above copyright notice,
- this list of conditions and the following disclaimer.
- * Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in the
- documentation and/or other materials provided with the distribution.
- * Neither the name Wai Yip Tung nor the names of its contributors may be
- used to endorse or promote products derived from this software without
- specific prior written permission.
- THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
- IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
- TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
- PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
- OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- """
-
- # URL: http://tungwaiyip.info/software/HTMLTestRunner.html
-
- __author__ = "Wai Yip Tung"
- __version__ = "0.9.1"
-
- """
- Change History
- Version 0.9.1
- * 用Echarts添加执行情况统计图 (灰蓝)
- Version 0.9.0
- * 改成Python 3.x (灰蓝)
- Version 0.8.3
- * 使用 Bootstrap稍加美化 (灰蓝)
- * 改为中文 (灰蓝)
- Version 0.8.2
- * Show output inline instead of popup window (Viorel Lupu).
- Version in 0.8.1
- * Validated XHTML (Wolfgang Borgert).
- * Added description of test classes and test cases.
- Version in 0.8.0
- * Define Template_mixin class for customization.
- * Workaround a IE 6 bug that it does not treat <script> block as CDATA.
- Version in 0.7.1
- * Back port to Python 2.3 (Frank Horowitz).
- * Fix missing scroll bars in detail log (Podi).
- """
-
- # TODO: color stderr
- # TODO: simplify javascript using ,ore than 1 class in the class attribute?
-
- import datetime
- import sys
- import io
- import time
- import unittest
- from xml.sax import saxutils
-
-
- # ------------------------------------------------------------------------
- # The redirectors below are used to capture output during testing. Output
- # sent to sys.stdout and sys.stderr are automatically captured. However
- # in some cases sys.stdout is already cached before HTMLTestRunner is
- # invoked (e.g. calling logging.basicConfig). In order to capture those
- # output, use the redirectors for the cached stream.
- #
- # e.g.
- # >>> logging.basicConfig(stream=HTMLTestRunner.stdout_redirector)
- # >>>
- class OutputRedirector(object):
- """ Wrapper to redirect stdout or stderr """
-
- def __init__(self, fp):
- self.fp = fp
-
- def write(self, s):
- self.fp.write(s)
-
- def writelines(self, lines):
- self.fp.writelines(lines)
-
- def flush(self):
- self.fp.flush()
-
-
- stdout_redirector = OutputRedirector(sys.stdout)
- stderr_redirector = OutputRedirector(sys.stderr)
-
-
- # ----------------------------------------------------------------------
- # Template
-
-
- class Template_mixin(object):
- """
- Define a HTML template for report customerization and generation.
- Overall structure of an HTML report
- HTML
- +------------------------+
- |<html> |
- | <head> |
- | |
- | STYLESHEET |
- | +----------------+ |
- | | | |
- | +----------------+ |
- | |
- | </head> |
- | |
- | <body> |
- | |
- | HEADING |
- | +----------------+ |
- | | | |
- | +----------------+ |
- | |
- | REPORT |
- | +----------------+ |
- | | | |
- | +----------------+ |
- | |
- | ENDING |
- | +----------------+ |
- | | | |
- | +----------------+ |
- | |
- | </body> |
- |</html> |
- +------------------------+
- """
-
- STATUS = {
- 0: u'通过',
- 1: u'失败',
- 2: u'错误',
- }
-
- DEFAULT_TITLE = 'Unit Test Report'
- DEFAULT_DESCRIPTION = ''
-
- # ------------------------------------------------------------------------
- # HTML Template
-
- HTML_TMPL = r"""<?xml version="1.0" encoding="UTF-8"?>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <title>%(title)s</title>
- <meta name="generator" content="%(generator)s"/>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
- <link href="http://cdn.bootcss.com/bootstrap/3.3.0/css/bootstrap.min.css" rel="stylesheet">
- <script src="https://cdn.bootcss.com/echarts/3.8.5/echarts.common.min.js"></script>
- <!-- <script type="text/javascript" src="js/echarts.common.min.js"></script> -->
- %(stylesheet)s
- </head>
- <body>
- <script language="javascript" type="text/javascript"><!--
- output_list = Array();
- /* level - 0:Summary; 1:Failed; 2:All */
- function showCase(level) {
- trs = document.getElementsByTagName("tr");
- for (var i = 0; i < trs.length; i++) {
- tr = trs[i];
- id = tr.id;
- if (id.substr(0,2) == 'ft') {
- if (level < 1) {
- tr.className = 'hiddenRow';
- }
- else {
- tr.className = '';
- }
- }
- if (id.substr(0,2) == 'pt') {
- if (level > 1) {
- tr.className = '';
- }
- else {
- tr.className = 'hiddenRow';
- }
- }
- }
- }
- function showClassDetail(cid, count) {
- var id_list = Array(count);
- var toHide = 1;
- for (var i = 0; i < count; i++) {
- tid0 = 't' + cid.substr(1) + '.' + (i+1);
- tid = 'f' + tid0;
- tr = document.getElementById(tid);
- if (!tr) {
- tid = 'p' + tid0;
- tr = document.getElementById(tid);
- }
- id_list[i] = tid;
- if (tr.className) {
- toHide = 0;
- }
- }
- for (var i = 0; i < count; i++) {
- tid = id_list[i];
- if (toHide) {
- document.getElementById('div_'+tid).style.display = 'none'
- document.getElementById(tid).className = 'hiddenRow';
- }
- else {
- document.getElementById(tid).className = '';
- }
- }
- }
- function showTestDetail(div_id){
- var details_div = document.getElementById(div_id)
- var displayState = details_div.style.display
- // alert(displayState)
- if (displayState != 'block' ) {
- displayState = 'block'
- details_div.style.display = 'block'
- }
- else {
- details_div.style.display = 'none'
- }
- }
- function html_escape(s) {
- s = s.replace(/&/g,'&');
- s = s.replace(/</g,'<');
- s = s.replace(/>/g,'>');
- return s;
- }
- /* obsoleted by detail in <div>
- function showOutput(id, name) {
- var w = window.open("", //url
- name,
- "resizable,scrollbars,status,width=800,height=450");
- d = w.document;
- d.write("<pre>");
- d.write(html_escape(output_list[id]));
- d.write("\n");
- d.write("<a href='javascript:window.close()'>close</a>\n");
- d.write("</pre>\n");
- d.close();
- }
- */
- --></script>
- <div id="div_base">
- %(heading)s
- %(report)s
- %(ending)s
- %(chart_script)s
- </div>
- </body>
- </html>
- """ # variables: (title, generator, stylesheet, heading, report, ending, chart_script)
-
- ECHARTS_SCRIPT = """
- <script type="text/javascript">
- // 基于准备好的dom,初始化echarts实例
- var myChart = echarts.init(document.getElementById('chart'));
- // 指定图表的配置项和数据
- var option = {
- title : {
- text: '测试执行情况',
- x:'center'
- },
- tooltip : {
- trigger: 'item',
- formatter: "{a} <br/>{b} : {c} ({d}%%)"
- },
- color: ['#95b75d', 'grey', '#b64645'],
- legend: {
- orient: 'vertical',
- left: 'left',
- data: ['通过','失败','错误']
- },
- series : [
- {
- name: '测试执行情况',
- type: 'pie',
- radius : '60%%',
- center: ['50%%', '60%%'],
- data:[
- {value:%(Pass)s, name:'通过'},
- {value:%(fail)s, name:'失败'},
- {value:%(error)s, name:'错误'}
- ],
- itemStyle: {
- emphasis: {
- shadowBlur: 10,
- shadowOffsetX: 0,
- shadowColor: 'rgba(0, 0, 0, 0.5)'
- }
- }
- }
- ]
- };
- // 使用刚指定的配置项和数据显示图表。
- myChart.setOption(option);
- </script>
- """ # variables: (Pass, fail, error)
-
- # ------------------------------------------------------------------------
- # Stylesheet
- #
- # alternatively use a <link> for external style sheet, e.g.
- # <link rel="stylesheet" href="$url" type="text/css">
-
- STYLESHEET_TMPL = """
- <style type="text/css" media="screen">
- body { font-family: Microsoft YaHei,Consolas,arial,sans-serif; font-size: 80%; }
- table { font-size: 100%; }
- pre { white-space: pre-wrap;word-wrap: break-word; }
- /* -- heading ---------------------------------------------------------------------- */
- h1 {
- font-size: 16pt;
- color: gray;
- }
- .heading {
- margin-top: 0ex;
- margin-bottom: 1ex;
- }
- .heading .attribute {
- margin-top: 1ex;
- margin-bottom: 0;
- }
- .heading .description {
- margin-top: 2ex;
- margin-bottom: 3ex;
- }
- /* -- css div popup ------------------------------------------------------------------------ */
- a.popup_link {
- }
- a.popup_link:hover {
- color: red;
- }
- .popup_window {
- display: none;
- position: relative;
- left: 0px;
- top: 0px;
- /*border: solid #627173 1px; */
- padding: 10px;
- /*background-color: #E6E6D6; */
- font-family: "Lucida Console", "Courier New", Courier, monospace;
- text-align: left;
- font-size: 8pt;
- /* width: 500px;*/
- }
- }
- /* -- report ------------------------------------------------------------------------ */
- #show_detail_line {
- margin-top: 3ex;
- margin-bottom: 1ex;
- }
- #result_table {
- width: 99%;
- }
- #header_row {
- font-weight: bold;
- color: #303641;
- background-color: #ebebeb;
- }
- #total_row { font-weight: bold; }
- .passClass { background-color: #bdedbc; }
- .failClass { background-color: #ffefa4; }
- .errorClass { background-color: #ffc9c9; }
- .passCase { color: #6c6; }
- .failCase { color: #FF6600; font-weight: bold; }
- .errorCase { color: #c00; font-weight: bold; }
- .hiddenRow { display: none; }
- .testcase { margin-left: 2em; }
- /* -- ending ---------------------------------------------------------------------- */
- #ending {
- }
- #div_base {
- position:absolute;
- top:0%;
- left:5%;
- right:5%;
- width: auto;
- height: auto;
- margin: -15px 0 0 0;
- }
- </style>
- """
-
- # ------------------------------------------------------------------------
- # Heading
- #
-
- HEADING_TMPL = """
- <div class='page-header'>
- <h1>%(title)s</h1>
- %(parameters)s
- </div>
- <div style="float: left;width:50%%;"><p class='description'>%(description)s</p></div>
- <div id="chart" style="width:50%%;height:400px;float:left;"></div>
- """ # variables: (title, parameters, description)
-
- HEADING_ATTRIBUTE_TMPL = """<p class='attribute'><strong>%(name)s:</strong> %(value)s</p>
- """ # variables: (name, value)
-
- # ------------------------------------------------------------------------
- # Report
- #
-
- REPORT_TMPL = u"""
- <div class="btn-group btn-group-sm">
- <button class="btn btn-default" onclick='javascript:showCase(0)'>总结</button>
- <button class="btn btn-default" onclick='javascript:showCase(1)'>失败</button>
- <button class="btn btn-default" onclick='javascript:showCase(2)'>全部</button>
- </div>
- <p></p>
- <table id='result_table' class="table table-bordered">
- <colgroup>
- <col align='left' />
- <col align='right' />
- <col align='right' />
- <col align='right' />
- <col align='right' />
- <col align='right' />
- </colgroup>
- <tr id='header_row'>
- <td>测试套件/测试用例</td>
- <td>总数</td>
- <td>通过</td>
- <td>失败</td>
- <td>错误</td>
- <td>查看</td>
- </tr>
- %(test_list)s
- <tr id='total_row'>
- <td>总计</td>
- <td>%(count)s</td>
- <td>%(Pass)s</td>
- <td>%(fail)s</td>
- <td>%(error)s</td>
- <td> </td>
- </tr>
- </table>
- """ # variables: (test_list, count, Pass, fail, error)
-
- REPORT_CLASS_TMPL = u"""
- <tr class='%(style)s'>
- <td>%(desc)s</td>
- <td>%(count)s</td>
- <td>%(Pass)s</td>
- <td>%(fail)s</td>
- <td>%(error)s</td>
- <td><a href="javascript:showClassDetail('%(cid)s',%(count)s)">详情</a></td>
- </tr>
- """ # variables: (style, desc, count, Pass, fail, error, cid)
-
- REPORT_TEST_WITH_OUTPUT_TMPL = r"""
- <tr id='%(tid)s' class='%(Class)s'>
- <td class='%(style)s'><div class='testcase'>%(desc)s</div></td>
- <td colspan='5' align='center'>
- <!--css div popup start-->
- <a class="popup_link" onfocus='this.blur();' href="javascript:showTestDetail('div_%(tid)s')" >
- %(status)s</a>
- <div id='div_%(tid)s' class="popup_window">
- <pre>%(script)s</pre>
- </div>
- <!--css div popup end-->
- </td>
- </tr>
- """ # variables: (tid, Class, style, desc, status)
-
- REPORT_TEST_NO_OUTPUT_TMPL = r"""
- <tr id='%(tid)s' class='%(Class)s'>
- <td class='%(style)s'><div class='testcase'>%(desc)s</div></td>
- <td colspan='5' align='center'>%(status)s</td>
- </tr>
- """ # variables: (tid, Class, style, desc, status)
-
- REPORT_TEST_OUTPUT_TMPL = r"""%(id)s: %(output)s""" # variables: (id, output)
-
- # ------------------------------------------------------------------------
- # ENDING
- #
-
- ENDING_TMPL = """<div id='ending'> </div>"""
-
-
- # -------------------- The end of the Template class -------------------
-
-
- TestResult = unittest.TestResult
-
-
- class _TestResult(TestResult):
- # note: _TestResult is a pure representation of results.
- # It lacks the output and reporting ability compares to unittest._TextTestResult.
-
- def __init__(self, verbosity=1):
- TestResult.__init__(self)
- self.stdout0 = None
- self.stderr0 = None
- self.success_count = 0
- self.failure_count = 0
- self.error_count = 0
- self.verbosity = verbosity
-
- # result is a list of result in 4 tuple
- # (
- # result code (0: success; 1: fail; 2: error),
- # TestCase object,
- # Test output (byte string),
- # stack trace,
- # )
- self.result = []
- self.subtestlist = []
-
- def startTest(self, test):
- TestResult.startTest(self, test)
- # just one buffer for both stdout and stderr
- self.outputBuffer = io.StringIO()
- stdout_redirector.fp = self.outputBuffer
- stderr_redirector.fp = self.outputBuffer
- self.stdout0 = sys.stdout
- self.stderr0 = sys.stderr
- sys.stdout = stdout_redirector
- sys.stderr = stderr_redirector
-
- def complete_output(self):
- """
- Disconnect output redirection and return buffer.
- Safe to call multiple times.
- """
- if self.stdout0:
- sys.stdout = self.stdout0
- sys.stderr = self.stderr0
- self.stdout0 = None
- self.stderr0 = None
- return self.outputBuffer.getvalue()
-
- def stopTest(self, test):
- # Usually one of addSuccess, addError or addFailure would have been called.
- # But there are some path in unittest that would bypass this.
- # We must disconnect stdout in stopTest(), which is guaranteed to be called.
- self.complete_output()
-
- def addSuccess(self, test):
- if test not in self.subtestlist:
- self.success_count += 1
- TestResult.addSuccess(self, test)
- output = self.complete_output()
- self.result.append((0, test, output, ''))
- if self.verbosity > 1:
- sys.stderr.write('ok ')
- sys.stderr.write(str(test))
- sys.stderr.write('\n')
- else:
- sys.stderr.write('.')
-
- def addError(self, test, err):
- self.error_count += 1
- TestResult.addError(self, test, err)
- _, _exc_str = self.errors[-1]
- output = self.complete_output()
- self.result.append((2, test, output, _exc_str))
- if self.verbosity > 1:
- sys.stderr.write('E ')
- sys.stderr.write(str(test))
- sys.stderr.write('\n')
- else:
- sys.stderr.write('E')
-
- def addFailure(self, test, err):
- self.failure_count += 1
- TestResult.addFailure(self, test, err)
- _, _exc_str = self.failures[-1]
- output = self.complete_output()
- self.result.append((1, test, output, _exc_str))
- if self.verbosity > 1:
- sys.stderr.write('F ')
- sys.stderr.write(str(test))
- sys.stderr.write('\n')
- else:
- sys.stderr.write('F')
-
- def addSubTest(self, test, subtest, err):
- if err is not None:
- if getattr(self, 'failfast', False):
- self.stop()
- if issubclass(err[0], test.failureException):
- self.failure_count += 1
- errors = self.failures
- errors.append((subtest, self._exc_info_to_string(err, subtest)))
- output = self.complete_output()
- self.result.append((1, test, output + '\nSubTestCase Failed:\n' + str(subtest),
- self._exc_info_to_string(err, subtest)))
- if self.verbosity > 1:
- sys.stderr.write('F ')
- sys.stderr.write(str(subtest))
- sys.stderr.write('\n')
- else:
- sys.stderr.write('F')
- else:
- self.error_count += 1
- errors = self.errors
- errors.append((subtest, self._exc_info_to_string(err, subtest)))
- output = self.complete_output()
- self.result.append(
- (2, test, output + '\nSubTestCase Error:\n' + str(subtest), self._exc_info_to_string(err, subtest)))
- if self.verbosity > 1:
- sys.stderr.write('E ')
- sys.stderr.write(str(subtest))
- sys.stderr.write('\n')
- else:
- sys.stderr.write('E')
- self._mirrorOutput = True
- else:
- self.subtestlist.append(subtest)
- self.subtestlist.append(test)
- self.success_count += 1
- output = self.complete_output()
- self.result.append((0, test, output + '\nSubTestCase Pass:\n' + str(subtest), ''))
- if self.verbosity > 1:
- sys.stderr.write('ok ')
- sys.stderr.write(str(subtest))
- sys.stderr.write('\n')
- else:
- sys.stderr.write('.')
-
-
- class HTMLTestRunner(Template_mixin):
-
- def __init__(self, stream=sys.stdout, verbosity=1, title=None, description=None):
- self.stream = stream
- self.verbosity = verbosity
- if title is None:
- self.title = self.DEFAULT_TITLE
- else:
- self.title = title
- if description is None:
- self.description = self.DEFAULT_DESCRIPTION
- else:
- self.description = description
-
- self.startTime = datetime.datetime.now()
-
- def run(self, test):
- "Run the given test case or test suite."
- result = _TestResult(self.verbosity)
- test(result)
- self.stopTime = datetime.datetime.now()
- self.generateReport(test, result)
- print('\nTime Elapsed: %s' % (self.stopTime - self.startTime), file=sys.stderr)
- return result
-
- def sortResult(self, result_list):
- # unittest does not seems to run in any particular order.
- # Here at least we want to group them together by class.
- rmap = {}
- classes = []
- for n, t, o, e in result_list:
- cls = t.__class__
- if cls not in rmap:
- rmap[cls] = []
- classes.append(cls)
- rmap[cls].append((n, t, o, e))
- r = [(cls, rmap[cls]) for cls in classes]
- return r
-
- def getReportAttributes(self, result):
- """
- Return report attributes as a list of (name, value).
- Override this to add custom attributes.
- """
- startTime = str(self.startTime)[:19]
- duration = str(self.stopTime - self.startTime)
- status = []
- if result.success_count: status.append(u'通过 %s' % result.success_count)
- if result.failure_count: status.append(u'失败 %s' % result.failure_count)
- if result.error_count: status.append(u'错误 %s' % result.error_count)
- if status:
- status = ' '.join(status)
- else:
- status = 'none'
- return [
- (u'开始时间', startTime),
- (u'运行时长', duration),
- (u'状态', status),
- ]
-
- def generateReport(self, test, result):
- report_attrs = self.getReportAttributes(result)
- generator = 'HTMLTestRunner %s' % __version__
- stylesheet = self._generate_stylesheet()
- heading = self._generate_heading(report_attrs)
- report = self._generate_report(result)
- ending = self._generate_ending()
- chart = self._generate_chart(result)
- output = self.HTML_TMPL % dict(
- title=saxutils.escape(self.title),
- generator=generator,
- stylesheet=stylesheet,
- heading=heading,
- report=report,
- ending=ending,
- chart_script=chart
- )
- self.stream.write(output.encode('utf8'))
-
- def _generate_stylesheet(self):
- return self.STYLESHEET_TMPL
-
- def _generate_heading(self, report_attrs):
- a_lines = []
- for name, value in report_attrs:
- line = self.HEADING_ATTRIBUTE_TMPL % dict(
- name=saxutils.escape(name),
- value=saxutils.escape(value),
- )
- a_lines.append(line)
- heading = self.HEADING_TMPL % dict(
- title=saxutils.escape(self.title),
- parameters=''.join(a_lines),
- description=saxutils.escape(self.description),
- )
- return heading
-
- def _generate_report(self, result):
- rows = []
- sortedResult = self.sortResult(result.result)
- for cid, (cls, cls_results) in enumerate(sortedResult):
- # subtotal for a class
- np = nf = ne = 0
- for n, t, o, e in cls_results:
- if n == 0:
- np += 1
- elif n == 1:
- nf += 1
- else:
- ne += 1
-
- # format class description
- if cls.__module__ == "__main__":
- name = cls.__name__
- else:
- name = "%s.%s" % (cls.__module__, cls.__name__)
- doc = cls.__doc__ and cls.__doc__.split("\n")[0] or ""
- desc = doc and '%s: %s' % (name, doc) or name
-
- row = self.REPORT_CLASS_TMPL % dict(
- style=ne > 0 and 'errorClass' or nf > 0 and 'failClass' or 'passClass',
- desc=desc,
- count=np + nf + ne,
- Pass=np,
- fail=nf,
- error=ne,
- cid='c%s' % (cid + 1),
- )
- rows.append(row)
-
- for tid, (n, t, o, e) in enumerate(cls_results):
- self._generate_report_test(rows, cid, tid, n, t, o, e)
-
- report = self.REPORT_TMPL % dict(
- test_list=''.join(rows),
- count=str(result.success_count + result.failure_count + result.error_count),
- Pass=str(result.success_count),
- fail=str(result.failure_count),
- error=str(result.error_count),
- )
- return report
-
- def _generate_chart(self, result):
- chart = self.ECHARTS_SCRIPT % dict(
- Pass=str(result.success_count),
- fail=str(result.failure_count),
- error=str(result.error_count),
- )
- return chart
-
- def _generate_report_test(self, rows, cid, tid, n, t, o, e):
- # e.g. 'pt1.1', 'ft1.1', etc
- has_output = bool(o or e)
- tid = (n == 0 and 'p' or 'f') + 't%s.%s' % (cid + 1, tid + 1)
- name = t.id().split('.')[-1]
- doc = t.shortDescription() or ""
- desc = doc and ('%s: %s' % (name, doc)) or name
- tmpl = has_output and self.REPORT_TEST_WITH_OUTPUT_TMPL or self.REPORT_TEST_NO_OUTPUT_TMPL
-
- script = self.REPORT_TEST_OUTPUT_TMPL % dict(
- id=tid,
- output=saxutils.escape(o + e),
- )
-
- row = tmpl % dict(
- tid=tid,
- Class=(n == 0 and 'hiddenRow' or 'none'),
- style=(n == 2 and 'errorCase' or (n == 1 and 'failCase' or 'none')),
- desc=desc,
- script=script,
- status=self.STATUS[n],
- )
- rows.append(row)
- if not has_output:
- return
-
- def _generate_ending(self):
- return self.ENDING_TMPL
-
-
- ##############################################################################
- # Facilities for running tests from the command line
- ##############################################################################
-
- # Note: Reuse unittest.TestProgram to launch test. In the future we may
- # build our own launcher to support more specific command line
- # parameters like test title, CSS, etc.
- class TestProgram(unittest.TestProgram):
- """
- A variation of the unittest.TestProgram. Please refer to the base
- class for command line parameters.
- """
-
- def runTests(self):
- # Pick HTMLTestRunner as the default test runner.
- # base class's testRunner parameter is not useful because it means
- # we have to instantiate HTMLTestRunner before we know self.verbosity.
- if self.testRunner is None:
- self.testRunner = HTMLTestRunner(verbosity=self.verbosity)
- unittest.TestProgram.runTests(self)
- main = TestProgram
- ##############################################################################
- # Executing this module from the command line
- ##############################################################################
- if __name__ == "__main__":
- main(module=None)
将作者的HTMLTestRunner.py拷贝出来
九、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_08——调用生成测试报告
先别急着创建runAll.py文件(所有工作做完,最后我们运行runAll.py文件来执行接口自动化的测试工作并生成测试报告发送报告到相关人邮箱),但是我们在创建此文件前,还缺少点东东。按我的目录结构创建caselist.txt文件,内容如下:
这个文件的作用是,我们通过这个文件来控制,执行哪些模块下的哪些unittest用例文件。如在实际的项目中:user模块下的test01case.py如果本轮无需执行哪些模块的用例的话,就在前面添加#。还缺少一个发送邮件的文件。在common下创建configEmail.py文件,内容如下:
- import smtplib
- from email.mime.text import MIMEText
-
-
- class SendEmail(object):
-
- def send_email(self):
- msg_from = 'zzzz@qq.com' # 发送方邮箱
- passwd = 'xxxxxx' # 填入发送方邮箱的授权码
- msg_to = 'xxxxx@qq.com' # 收件人邮箱
-
- subject = "python邮件测试" # 主题
- f = open("F:\\jiekouceshikj\\result\\report.html", 'rb')
- content = f.read()
- f.close()
- message=content.decode('utf-8')
- msg = MIMEText(message)
- msg['Subject'] = subject
- msg['From'] = msg_from
- msg['To'] = msg_to
- try:
- s = smtplib.SMTP_SSL("smtp.qq.com", 465)
- s.login(msg_from, passwd)
- s.sendmail(msg_from, msg_to, msg.as_string())
- print("发送成功")
- except s.SMTPException as e:
- print("发送失败")
- finally:
- s.quit()
-
-
- if __name__ == '__main__':
- SendEmail().send_email()
没有用作者文中的发送邮件,没有调通,先用这个,这个只能把html里面的内容直接放在邮件里,后续再研究怎么直接添加htm作为附件来发送邮件
研究了一下怎样将html作为附件来发送邮件
- import smtplib
- from email.mime.multipart import MIMEMultipart
- from email.mime.text import MIMEText
-
-
- class SendEmail(object):
-
- def send_email(self):
- msg_from = 'xxxxxx@qq.com' # 发送方邮箱
- passwd = 'xxxxx' # 填入发送方邮箱的授权码
- msg_to = 'xxxxx@qq.com' # 收件人邮箱
-
- subject = "python邮件测试" # 主题
- f = open("F:\\jiekouceshikj\\result\\report.html", 'rb')
- content = f.read()
-
- mail_mul = MIMEMultipart() # 构建一个邮件对象
- mail_text = MIMEText("各位好,附件是本次的测试报告,请查阅!谢谢", "plain", "utf-8") # 构建邮件正文
- mail_mul.attach(mail_text) # 把构建好的邮件正文附加到邮件中
- # 设置附件
- msg = MIMEText(content, 'html', 'utf-8')
- msg['Content-type'] = 'application/octet-stream'
- msg['Content-disposition'] = "attachment; filename ='test.html'"
- mail_mul.attach(msg) # 将附加按添加到邮件中
-
-
-
- msg['Subject'] = subject
- msg['From'] = msg_from
- msg['To'] = msg_to
- try:
- s = smtplib.SMTP_SSL("smtp.qq.com", 465)
- s.login(msg_from, passwd)
- s.sendmail(msg_from, msg_to, msg.as_string())
- print("发送成功")
- except s.SMTPException as e:
- print("发送失败")
- finally:
- s.quit()
-
-
- if __name__ == '__main__':
- SendEmail().send_email()
继续往下走,这下我们该创建我们的runAll.py文件了
- import os
- import common.HTMLTestRunner as HTMLTestRunner
- import getpathInfo
- import unittest
- import readConfig
- from common.configEmail import SendEmail
- import common.log
-
- send_mail = SendEmail()
- path = getpathInfo.get_Path()
- report_path = os.path.join(path, 'result')
- on_off = readConfig.ReadConfig().get_email('on_off')
- log=common.log.logger
-
-
- class AllTest: # 定义一个类AllTest
- def __init__(self): # 初始化一些参数和数据
- global resultPath
- resultPath = os.path.join(report_path, "report.html") # result/report.html
- self.caseListFile = os.path.join(path, "caselist.txt") # 配置执行哪些测试文件的配置文件路径
- self.caseFile = os.path.join(path, "testcase") # 真正的测试断言文件路径
- self.caseList = []
- log.info('resultPath',resultPath)#将resultPath的值输入到日志,方便定位查看问题
- # log.info('caseListFile',self.caseListFile)
- # log.info('caselist',self.caseList)
-
- def set_case_list(self):
-
- fb = open(self.caseListFile)
- for value in fb.readlines():
- data = str(value)
- if data != '' and not data.startswith("#"): # 如果data非空且不以#开头
- self.caseList.append(data.replace("\n", "")) # 读取每行数据会将换行转换为\n,去掉每行数据中的\n
- fb.close()
-
- def set_case_suite(self):
- self.set_case_list() # 通过set_case_list()拿到caselist元素组
- test_suite = unittest.TestSuite()
- suite_module = []
- for case in self.caseList: # 从caselist元素组中循环取出case
- case_name = case.split("/")[-1] # 通过split函数来将aaa/bbb分割字符串,-1取后面,0取前面
- print(case_name + ".py") # 打印出取出来的名称
- # 批量加载用例,第一个参数为用例存放路径,第一个参数为路径文件名
- discover = unittest.defaultTestLoader.discover(self.caseFile, pattern=case_name + '.py', top_level_dir=None)
- suite_module.append(discover) # 将discover存入suite_module元素组
- print('suite_module:' + str(suite_module))
- if len(suite_module) > 0: # 判断suite_module元素组是否存在元素
- for suite in suite_module: # 如果存在,循环取出元素组内容,命名为suite
- for test_name in suite: # 从discover中取出test_name,使用addTest添加到测试集
- test_suite.addTest(test_name)
- else:
- print('else:')
- return None
- return test_suite # 返回测试集
-
- def run(self):
-
- try:
- suit = self.set_case_suite() # 调用set_case_suite获取test_suite
- print('try')
- print(str(suit))
- if suit is not None: # 判断test_suite是否为空
- print('if-suit')
- fp = open(resultPath, 'wb') # 打开result/report.html测试报告文件,如果不存在就创建
- # 调用HTMLTestRunner
- runner = HTMLTestRunner.HTMLTestRunner(stream=fp, title='Test Report', description='Test Description')
- runner.run(suit)
- else:
- print("Have no case to test.")
- except Exception as ex:
- print(str(ex))
-
-
- finally:
- print("*********TEST END*********")
- fp.close()
- # 判断邮件发送的开关
- if on_off == 'on':
- send_mail.send_email()
- else:
- print("邮件发送开关配置关闭,请打开开关后可正常自动发送测试报告")
-
-
- if __name__ == '__main__':
- AllTest().run()
九、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_08——生成log文件
我们修改runAll.py文件,在顶部增加import common.Log,然后增加标红框的代码
让我们再来运行一下runAll.py文件,发现在result下多了一个logs文件,我们打开看一下有没有我们打印的日志
十、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_09——Jenkins构建定时任务自动执行测试
Jenkins的搭建就不赘述,网上很多,现在说一下项目配置
先cd到项目目录下
然后用python的环境执行一下脚本
因为脚本里面有发送邮件的配置,这里Jenkins就不需要配置邮件了。
感谢作者的文档,照着抄写然后结合实际项目更改了一下,运行起来了
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。