robot framework + python实现http接口自动化测试框架
https://www.jianshu.com/p/6d1e8cb90e7d
前言
下周即将展开一个http接口测试的需求,刚刚完成的java类接口测试工作中,由于之前犯懒,没有提前搭建好自动化回归测试框架,以至于后期rd每修改一个bug,经常导致之前没有问题的case又产生了bug,所以需要一遍遍回归case,过程一直手工去执行,苦不堪言。所以,对于即将开始的http接口测试需求,立马花了两天时间搭建了一个http接口自动化测试框架用于测试后期回归测试,实在是被大量的重复手工执行搞怕了。
基础框架选择
最方便的方法就是用python直接写代码,代码和测试数据分离,测试数据放在excel中保存。这种实现最快捷方便,但也有些缺点:
(1)用例管理不太方便,不直观;
(2)HTMLTestRunner输出报告做的比较烂。
相较而言,robot framework具有用例管理清晰,输出报告美观的特点。但robot的缺点就是编码起来不如python直接写代码方便。所以,为了快速搭建http接口自动化框架用于回归测试,我直接用python写了一个框架。为了后续长远考虑,便于用例管理,测试报告美观,且集成到测试平台工具化以及推广给rd和其他qa同学使用,又用robot搭建了一套框架。本文就详细说明该搭建过程。
搭建思路
框架采用robot和python实现,因为robot中的复杂逻辑实现起来比较繁琐,故选择用python实现,然后以外部库的形式导入robot中使用。测试用例数据保存在excel中。
使用过robot的人了解,robot中测试维度划分为测试套件(Test Suite)和测试用例(Test Case),一个Suite为一组Case的集合,每个Case对应为我们手工执行测试时的Case。
假设测试一个路径为/areaplug/showCityName的http接口,常规方法是在robot中新建一个showCityName的Suite,其下包含测试该http接口的用例集,如下图所示:
![](http://upload-images.jianshu.io/upload_images/7391909-644e4e2481d4ebb1.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/176)
![](http://upload-images.jianshu.io/upload_images/7391909-7ba2216c50177b4c.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/255)
![](http://upload-images.jianshu.io/upload_images/7391909-2996e45fe3f6c86f.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/700)
搭建
测试数据
测试数据保存在excel中,每一个sheet页对应一个测试场景,即一个http接口。该sheet也保存有测试该接口的所有测试用例数据以及接口路径和请求方法,如下图所示(这里仅仅是一个demo,实际回归测试时,会有大量的用例和数据):
![](http://upload-images.jianshu.io/upload_images/7391909-96dd369b039d23ea.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/700)
测试框架
整个工程目录如下:
E:\LLF_58TESTSUITES\JZ_WEBINTERGRATION\ROBOT_CODE
│ execPybot.bat
│
├─pycode
│ │ Common_Excel.py
│ │ Common_Excel.pyc
│ │ Common_Exec.py
│ │ Common_Exec.pyc
│ │ testHTTP.py
│ │ __init__.py
│ │
│ ├─.idea
│ │ │ misc.xml
│ │ │ modules.xml
│ │ │ pycode.iml
│ │ │ workspace.xml
│ │ │
│ │ └─inspectionProfiles
│ └─__pycache__
│ Common_Excel.cpython-36.pyc
│ Common_Exec.cpython-36.pyc
│ __init__.cpython-36.pyc
│
├─report
│ │ log.html
│ │ output.xml
│ │ report.html
│ │
│ └─TestCaseReport
│ ├─result_calendar
│ │ log_20180130195712.html
│ │ output_20180130195712.xml
│ │ report_20180130195712.html
│ │
│ ├─result_getScheduleFlags
│ │ log_20180130195710.html
│ │ output_20180130195710.xml
│ │ report_20180130195710.html
│ │
│ └─result_showCityName
│ log_20180130195707.html
│ output_20180130195707.xml
│ report_20180130195707.html
│
├─rfcode
│ │ batch_Request.txt
│ │ http_Request.txt
│ │ __init__.robot
│ │
│ ├─关键字
│ │ 关键字index.txt
│ │ 自定义关键字.txt
│ │
│ └─配置信息
│ config.txt
│ configIndex.txt
│ RequestHeaders.txt
│
└─testData
testData.xlsx
工程有4部分构成:
- pycode
由于robot中复杂逻辑的实现比较繁琐,所以将一些复杂逻辑直接用python代码实现,然后以外部库的形式导入robot中调用。共有2个文件:
Common_Excel.py
主要负责对测试数据excel文件的读取操作。
# coding: utf-8
import xlrd
def getTestData(testDataFile, testScene, host, caseNo):
'''
从excel中获取测试数据
:param testDataFile: 测试数据文件
:param testScene: 测试场景
:param host: 服务器主机
:param caseNo: 用例No
:param method: 请求方法
:return: url,用例No,用例名称,请求参数,预期返回码,预期响应内容
'''
caseNo = int(caseNo)
data = xlrd.open_workbook(testDataFile)
table = data.sheet_by_name(testScene)
cols = table.ncols
resource_path = table.cell(0, 1).value # 文件路径
url = "http://" + host + resource_path # 访问的url
method = table.cell(1, 1).value # 请求方法
dict_params = {}
for i in range(cols):
dict_params[table.cell(2, i).value] = table.cell(caseNo+2, i).value
caseNo = dict_params.pop("caseNo")
caseName = dict_params.pop("caseName")
expectCode = dict_params.pop("expect_code")
expectCotent = dict_params.pop("expect_content")
testName = "TestCase" + caseNo + "_" + caseName
return method, url, caseNo, testName, dict_params, expectCode, expectCotent
def getTestCaseNum(testDataFile, testScene):
'''
获取testScene测试场景中的测试用例数
:param testDataFile: 测试数据文件
:param testScene: 测试场景
:return: 测试用例数
'''
data = xlrd.open_workbook(testDataFile)
table = data.sheet_by_name(testScene)
rows = table.nrows
return rows-3
def getTestHttpMethod(testDataFile, testScene):
'''
获取testScene测试场景的请求方法
:param testDataFile: 测试数据文件
:param testScene: 测试场景
:return: 请求方法
'''
data = xlrd.open_workbook(testDataFile)
table = data.sheet_by_name(testScene)
method = table.cell(1, 1).value # 请求方法
return method
Common_Exec.py
主要负责根据测试数据批量构造pybot命令来调用robot执行测试。
# coding: utf-8
import requests
import os
import time
def batch_Call(robot_testSuite, robot_testCase, testScene, caseNum, testCaseReportPath, execTime):
'''
批量执行testScene测试场景下的用例
:param robot_testSuite: robot testSuite路径
:param robot_testCase: robot testCase路径
:param testScene: 测试场景
:param caseNum: 用例数
:param testCaseReportPath: 业务用例测试报告路径
:param execTime: 执行时间
:return:
'''
try:
for caseNo in range(caseNum):
testCase = ""
caseNo = caseNo + 1
testName = "testcase" + "_" + str(caseNo)
output_dir = "-d " + testCaseReportPath + "/result_{0}".format(testScene) # 输出目录
output_xml = "-o output_{0}_{1}.xml".format(testName, execTime)
output_log = "-l log_{0}_{1}.html".format(testName, execTime)
output_report = "-r report_{0}_{1}.html".format(testName, execTime)
variable = "-v caseNo:" + str(caseNo) + " -v testScene:" + testScene
testCase = "--test " + robot_testCase
pybot_cmd = "pybot " + output_dir + " " + output_xml + " " + output_log + " " + output_report + " " + variable + " " + " " + testCase + " " + robot_testSuite
os.system(pybot_cmd) # 执行pybot命令
return "done"
except Exception as e:
return "Error: " + str(e)
def send_HttpRequest(url, data=None, headers=None, method=None):
'''
发送http请求
:param url: 请求的url
:param data: 请求数据
:param headers: 请求头
:param method: 请求方法
:return: 响应码,响应内容
'''
if method == "get":
response = requests.get(url, data, headers=headers)
if method == "post":
response = requests.post(url, data, headers=headers)
code = str(response.status_code)
content = response.content.decode("utf-8") # 转码
return code, content
def cleanLogs(testScene, testCaseReportPath):
'''
删除硬盘中合并前的测试报告
:param testScene: 测试场景
:param testCaseReportPath: 业务用例测试报告路径
:return:
'''
testCaseReportPath = testCaseReportPath + "/result_{0}".format(testScene)
report_files = testCaseReportPath + "/report_testcase*"
xml_files = testCaseReportPath + "/output_testcase*"
log_files = testCaseReportPath + "/log_testcase*"
cmd = "del " + report_files + " " + xml_files + " " + log_files # windows
cmd = cmd.replace("/", "\\")
print(cmd)
os.system(cmd)
def getCurtime():
'''
获取当前时间
:return: 当前时间
'''
return time.strftime("%Y%m%d%H%M%S", time.localtime(time.time()))
def mergeReport(testScene, testCaseReportPath, execTime):
'''
# 合并报告
:param testScene: 测试场景
:param testCaseReportPath: 业务用例测试报告路径
:param execTime: 执行时间
:return:
'''
try:
output_dir = "-d " + testCaseReportPath + "/result_{0}".format(testScene) # 输出目录
output_xml = "-o output_{0}.xml".format(execTime)
output_log = "-l log_{0}.html".format(execTime)
output_report = "-r report_{0}.html".format(execTime)
# 被合并的报告
merge_report = testCaseReportPath + "/result_{0}".format(testScene) + "/output_testcase_*.xml"
name = "--name " + testScene
rebot_cmd = r"rebot " + output_dir + " " + output_xml + " " + output_log + " " + output_report + " " + name + " " + merge_report
os.system(rebot_cmd) # 执行rebot命令
return "done"
except Exception as e:
return "Error: " + str(e)
-
report
该目录用于存放测试报告。其中report目录下的robot测试报告为测试Suite的测试报告,而TestCaseReport下会根据不同的测试场景生成对应该场景名称的测试报告文件夹,其下会包含该测试场景下所有用例的合并报告(即excel中的每一条case会生成一个报告,最后会将这些cases的报告合并为一个报告,作为该测试场景即该http接口的测试报告)。 -
rfcode
该目录下为robot的代码。
batch_Request.txt
batch_Request下包含要测试的各http接口对应的测试场景(即robot的测试用例)。在各测试场景中会设置${testScene}变量,通过该变量去excel文件中对应的sheet页获取相应的测试数据。
*** Settings ***
Library ../pycode/Common_Exec.py
Resource 关键字/关键字index.txt
Resource 配置信息/configIndex.txt
Library ../pycode/Common_Excel.py
*** Test Cases ***
test_showCityName
[Documentation] /areaplug/showCityName
# 测试场景
${testScene} Set Variable showCityName
# 请求方法
${method} getTestHttpMethod ${testDataFile} ${testScene}
执行测试 ${testScene} ${method}
test_getScheduleFlags
[Documentation] /ManageSchedule/getScheduleFlags
# 测试场景
${testScene} Set Variable getScheduleFlags
# 请求方法
${method} getTestHttpMethod ${testDataFile} ${testScene}
执行测试 ${testScene} ${method}
test_calendar
# 测试场景
${testScene} Set Variable calendar
# 请求方法
${method} getTestHttpMethod ${testDataFile} ${testScene}
执行测试 ${testScene} ${method}
http_Request.txt
在各测试场景中会根据excel中的测试用例记录数目去批量调用http_Request下的sendHttpRequest执行http接口测试。在sendHttpRequest中会根据caseNo去excel中查询相应测试数据,并发送对应的http请求到相应http接口中。收到响应后,与excel中的预期响应码和响应内容做比对。
*** Settings ***
Library ../pycode/Common_Exec.py
Library ../pycode/Common_Excel.py
Resource 关键字/关键字index.txt
*** Test Cases ***
sendHttpRequest
# 获取测试用例数据
${method} ${url} ${caseNo} ${testName} ${dict_params} ${expectCode} ${expectCotent}
... getTestData ${testDataFile} ${testScene} ${Host} ${caseNo}
# 设置用例说明
Set Test Documentation ${testName}
# 请求头
${headers} 获取请求头
#根据method发送对应的http请求
${actualCode} ${actualContent} send_HttpRequest ${url} ${dict_params} ${headers} ${method}
# 响应码比对
Should Be Equal ${actualCode} ${expectCode}
# 响应内容比对
Should Be Equal ${actualContent} ${expectCotent}
关键字
关键字模块主要是对一些复用逻辑的封装。
*** Settings ***
Resource ../配置信息/configIndex.txt
Library ../../pycode/Common_Excel.py
Library ../../pycode/Common_Exec.py
*** Keywords ***
获取请求头
${dict_headers} Create Dictionary Host=${Host} User-Agent=${User-Agent} Accept=${Accept} Accept-Language=${Accept-Language} Accept-Encoding=${Accept-Encoding}
... Cookie=${Cookie} Connection=${Connection} Cache-Control=${Cache-Control}
Return From Keyword ${dict_headers}
执行测试
[Arguments] ${testScene} ${method} # 测试场景|请求方法
# 获取用例数目
${case_num} getTestCaseNum ${testDataFile} ${testScene}
# 获取当前时间
${execTime} getCurtime
#批量执行testScene测试场景下的用例
${status} batch_Call ${httpTestSuite} ${httpRequestTestCase} ${testScene} ${case_num} ${testCaseReportPath}
... ${execTime}
log ${status}
# 合并报告
${status} mergeReport ${testScene} ${testCaseReportPath} ${execTime}
log ${status}
# 清理合并前的报告
cleanLogs ${testScene} ${testCaseReportPath}
配置信息
配置信息中存储配置信息以及通讯头的信息。通讯头中有cookie,保存有登录信息,通讯头的部分涉及隐私,故这部分数据不放出来了。
config.txt
*** Settings ***
*** Variables ***
${testDataFile} E:/llf_58TestSuites/jz_webIntergration/robot_code/testData/testData.xlsx # 测试数据
${httpRequestTestCase} sendHttpRequest # http请求用例模板
${httpTestSuite} E:/llf_58TestSuites/jz_webIntergration/robot_code/rfcode/http_Request.txt # http请求测试套件
${testCaseReportPath} E:/llf_58TestSuites/jz_webIntergration/robot_code/report/TestCaseReport # 业务用例测试报告路径
RequestHeaders.txt
*** Settings ***
Documentation 请求头信息
*** Variables ***
${Host} ******* # 服务器主机
${User-Agent} Mozilla/5.0 (Windows NT 6.1; WOW64; rv:56.0) Gecko/20100101 Firefox/56.0 # 浏览器代理
${Accept} text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
${Accept-Language} en-US,en;q=0.5
${Accept-Encoding} gzip, deflate
${Cookie} ************
${Connection} keep-alive
${Cache-Control} max-age=0
${Upgrade-Insecure-Requests} ***
- testData
该目录下存放测试数据excel文件。
执行测试
pybot -d E:/llf_58TestSuites/jz_webIntergration/robot_code/report -o output.xml -l log.html -r report.html E:\llf_58TestSuites\jz_webIntergration\robot_code\rfcode\batch_Request.txt
![](http://upload-images.jianshu.io/upload_images/7391909-c703a8d6e079aa1b.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/665)
可见,showCityName测试场景已根据excel中的用例条数批量执行了测试。
![](http://upload-images.jianshu.io/upload_images/7391909-302e7b31da80f526.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/700)
进入showCityName目录,打开最新生成的该场景测试报告:
![](http://upload-images.jianshu.io/upload_images/7391909-dd80a74e7e4212ee.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/700)
![](http://upload-images.jianshu.io/upload_images/7391909-cf95cec15f99f371.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/700)
![](http://upload-images.jianshu.io/upload_images/7391909-7a67e31ef9d982da.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/700)
总结
经过了上一个项目吃过的亏,这次在http接口测试需求前,提前把自动化框架搭好了,便于测试后期的回归测试。其实http接口自动化测试框架可以很方便的搭建,之所以这么费劲用robot去实现,也是为了后续用例管理以及集成到平台实现工具化的考虑结果。希望这篇文章可以对其他同学有所帮助。
作者:Ivanli1990
链接:https://www.jianshu.com/p/6d1e8cb90e7d
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。