“接口自动化测试是指通过编写代码或使用工具,模拟用户发送请求,验证接口是否符合设计规范和功能需求的过程。”
如何用 python +ddt+excel 实现接口自动化测试
接口自动化测试可以提高测试效率和质量,节省测试成本和时间,保证测试覆盖率和可维护性。
让勇哥带你入门如何用 python +ddt+excel 实现接口自动化测试,请瞧如下内容:
一、准备工作
1. 安装 python 环境
python 是一种简洁、优雅、易学的编程语言,它有丰富的第三方库和社区支持,非常适合用来进行接口自动化测试。安装 python 的3.0以上的版本),并配置好环境变量,以便在命令行中使用 python 命令。
2. 安装相关库
为了进行接口自动化测试,我们需要安装以下几个库:
- requests:用来发送 HTTP 请求,支持各种方法、参数、头部、身份验证等。
- xlrd:用来读取 excel 文件中的数据,支持 xls 和 xlsx 格式。
- openpyxl:用来写入 excel 文件中的数据,支持 xlsx 格式。
- ddt:用来实现数据驱动测试,可以从 excel 文件中读取多组数据,并生成多个测试用例。
- unittest:用来编写和执行测试用例,支持断言、前置后置条件、测试套件等。
- HTMLTestRunner_api:用来生成 HTML 格式的测试报告,支持图表、日志、截图等。
我们可以使用 pip 命令来安装这些库,例如:
pip install requests
二、设计测试
1. 编写 excel 文件
我们需要在 excel 文件中填写接口的相关信息,包括:
- 接口名称
- 请求地址
- 请求方法
- 请求参数
- 预期结果
例如:
编辑
添加图片注释,不超过 140 字(可选)
我们可以将这个 excel 文件保存为 test_data.xlsx,并放在项目的 test_datas 目录下。
2. 封装 excel 操作
为了方便地读取和写入 excel 文件中的数据,我们需要封装一些 excel 操作的函数,例如:
- 打开表单
- 获取表头
- 获取所有数据
- 写入数据
我们可以将这些函数定义在一个类中,并保存为 excel_handler.py,并放在项目的 Lib 目录下。具体代码如下:
from openpyxl import load_workbookfrom openpyxl.worksheet.worksheet import Worksheetclass ExcelHandler(): '''操作Excel''' def __init__(self, file): '''初始化函数''' self.file = file def open_sheet(self, sheet_name) -> Worksheet: '''打开表单''' wb = load_workbook(self.file) sheet = wb[sheet_name] return sheet def read_rows(self,sheet_name): '''读取除表头外所有数据(除第一行外的所有数据)''' sheet = self.open_sheet(sheet_name) rows = list(sheet.rows)[1:] data = [] for row in rows: row_data = [] for cell in row: row_data.append(cell.value) data.append(row_data) return data
def read_key_value(self,sheet_name): '''获取所有数据,将表头与内容结合整....'''
... return data
3. 封装 requests 请求
为了方便地发送 HTTP 请求,我们需要封装一些 requests 请求的函数,例如:
- 初始化 session
- 发送请求
- 关闭 session
我们可以将这些函数定义在一个类中,并保存为 requests_handler.py,并放在项目的 Lib 目录下。具体代码如下:
import requests
class HTTPHandler:
# 初始化
def __init__(self):
self.session = requests.Session()
# 定义一个方法,接收访问http请求的方式
def visit(self, url, method, params=None, data=None, json=None, **kwargs):
res = self.session.request(method, url, params=params, data=data, json=json, **kwargs)
try:
return res.json()
except ValueError:
print('return not json')
# 关闭session会话
def close_session(self):
self.session.close()
三、执行测试
1. 编写测试用例
我们需要使用 unittest 和 ddt 来编写和执行测试用例,具体步骤如下:
- 导入相关库和模块
- 定义一个测试类,继承 unittest.TestCase
- 定义一个类方法,用来初始化 session 和读取 excel 文件中的数据
- 使用 @ddt.data 装饰器,传入 excel 文件中的数据
- 定义一个测试方法,用来发送请求,并断言响应结果是否符合预期
我们可以将这些代码保存为 test_api.py,并放在项目的 test_cases 目录下。具体代码如下:
from Lib.excel_handler import ExcelHandler
from Lib.requests_handler import HTTPHandler
import requests
import ddt
import unittest
data = ExcelHandler('test_datas/test_data.xlsx').read_key_value('Sheet1')
@ddt.ddt
class TestAPI(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.s = HTTPHandler()
@ddt.data(*data)
def test_api(self,params):
print('params:%s' % params)
case_name = params.get('接口名称')
url = params.get('请求地址')
args = eval(params.get('请求参数')) if isinstance(params.get('请求参数'), str) else params.get('请求参数')
method = params.get('请求方法')
expct_res1 = params.get('预期结果')
# 发起请求,获取返回数据
result = self.s.visit(url, method, params=args)
# 分析返回数据
response_data = result['name']
# 断言响应结果是否符合预期
self.assertEqual(expct_res1, response_data)
@classmethod
def tearDownClass(cls):
cls.s.close_session()
2. 生成测试报告
我们需要使用 HTMLTestRunner_api 来生成 HTML 格式的测试报告,具体步骤如下:
- 导入相关库和模块
- 定义一个测试套件,添加测试用例
- 定义一个测试报告的文件名和路径
- 定义一个测试运行器,传入测试报告的文件对象和相关参数
- 使用测试运行器来运行测试套件
我们可以将这些代码保存为 run.py,并放在项目的根目录下。具体代码如下:
import unittest
from HTMLTestRunner_api import HTMLTestRunner
from test_cases.test_api import TestAPI
# 定义一个测试套件
suite = unittest.TestSuite()
# 添加测试用例
suite.addTest(unittest.makeSuite(TestAPI))
# 定义一个测试报告的文件名和路径
report_file = 'reports/test_report.html'
# 定义一个测试运行器,传入测试报告的文件对象和相关参数
with open(report_file, 'wb') as f:
runner = HTMLTestRunner(f, title='接口自动化测试报告', description='用例执行情况')
# 使用测试运行器来运行测试套件
runner.run(suite)
四、查看结果
运行 run.py 文件后,我们可以在 reports 目录下看到生成的 test_report.html 文件,打开它,我们可以看到以下内容:
我们可以看到,共有 11 个测试用例,通过 6 个,失败 5 个。我们还可以看到每个测试用例的详细信息,包括用例名称、请求地址、请求参数、预期结果、实际结果等。我们还可以看到一些图表、日志、截图等。
这样,我们就完成了用 python +ddt+excel 实现接口自动化测试的过程。
题外话,勇哥打算把新建的技术交流群,打造成一个活跃的高质量技术群。工作中遇到的技术问题,都可以在里面咨询大家,还有工作内推的机会。有兴趣的小伙伴,欢迎加我。
关注公众号:测试玩家勇哥
,测试干货及时送达
勇哥,10年落魄测试老司机,技术栈偏python,目前在一家超大型房产公司担任自动化测试主管,日常工作比较繁杂,主要负责自动化测试,性能测试、软件质量管理及人员管理。工作之余专注于为粉丝进行简历修改、面试辅导、模拟面试、资料分享、一对一自动化测试教学辅导等副业发展。目前已服务十多位小伙伴,取得高薪offer。