大家好,我是刚哥。
趁着元旦假期最后一天,有着大把时间,奔着把tep做大做强的目标,好好学习了一波。在开始正文之前,先回答可能会问到的两个问题。第一个问题是为什么要集成HttpRunner?因为我最近在思考如何给tep做分层设计,参考了我司现有的接口自动化平台,它的设计是每个用例有很多测试步骤,可以针对用例设置预设变量,然后在测试步骤中引用。正当我准备自己开发类似功能时,想到了HttpRunner,我记得HttpRunner第3版是建议直接编写pytest代码而非以前的ymal或json文件了。大有所获,HttpRunner正是以这种方式编写的代码,而且和pytest有很好的结合,很符合tep要集成的第三方包的希望。第二个问题是为什么要集成Flask?刚开始只是我用来调试代码的,等到把Mock写完以后,想到可能大家也需要调试代码,就把它做到tep里面了,并且附带了测试用例的示例代码,安装完以后就能一键运行,开箱即用,美滋滋。归根结底,都是为了把tep做大做强。
tep0.9.3正式发布
要体验HttpRunner和Flask,需要先安装或升级到tep0.9.3。
安装:
pip install tep
升级:
pip install -U tep
或者指定版本:
pip install tep==0.9.3
安装tep时会顺带安装HttpRunner和Flask,安装完以后就可以执行命令初始化项目:
tep startproject demo093
输出:
D:\\PycharmProjects>tep startproject demo0932022-01-03 16:07:31.929 | INFO | tep.scaffold:create_scaffold:53 - Create new project: demo093Project root dir: D:\\PycharmProjects\\demo093Created folder: demo093Created folder: demo093\\fixturesCreated folder: demo093\\testsCreated folder: demo093\\filesCreated folder: demo093\\reportsCreated folder: demo093\\utilsCreated file: demo093\\.gitignoreCreated file: demo093\\conf.yamlCreated file: demo093\\conftest.pyCreated file: demo093\\pytest.iniCreated file: demo093\\fixtures\\__init__.pyCreated file: demo093\\fixtures\\fixture_admin.pyCreated file: demo093\\fixtures\\fixture_env_vars.pyCreated file: demo093\\fixtures\\fixture_login.pyCreated file: demo093\\fixtures\\fixture_your_name.pyCreated file: demo093\\tests\\__init__.pyCreated file: demo093\\tests\\test_login.pyCreated file: demo093\\tests\\test_post.pyCreated file: demo093\\tests\\test_mysql.pyCreated file: demo093\\tests\\test_request.pyCreated file: demo093\\tests\\test_login_pay.pyCreated file: demo093\\tests\\test_login_pay_httprunner.pyCreated file: demo093\\utils\\__init__.pyCreated file: demo093\\utils\\flask_mock_api.py
- 修改了
fixture_env_vars.py
里面的domain为http://127.0.0.1:5000,这是Flask启动后的默认地址。
- 修改了
fixture_login.py
里面的登录url和username,跟Flask的Mock对应。
- 新增了
utils\\flask_mock_api.py
,直接启动Mock服务。
- 新增了
tests\\test_login_pay.py
,用例数据一体开发模式,登录到下单流程的示例代码,可以一键运行成功。
- 新增了
tests\\test_login_pay_httprunner.py
,HttpRunner开发模式,登录到下单流程的示例代码,可以一键运行成功。
新版README.md
之前tep的README是全英文的,这次我也决定不装了,改成中文 ,丰富了内容,大家可以对tep有个全新和全面的了解啦。以下是全文:
tep
tep
是Try Easy Pytest的首字母缩写,是一款基于pytest测试框架的测试工具,集成了各种实用的第三方包和优秀的自动化测试设计思想,帮你快速实现自动化项目落地。
安装
支持Python3.6以上,推荐Python3.8以上。
标准安装:
$ pip install tep
国内镜像:
$ pip --default-timeout=600 install -i 计算机网络/ tep
检查安装成功:
$ tep -V # 或者 tep --version0.2.3
快速创建项目
tep提供了脚手架,预置了项目结构和代码,打开cmd,使用
startproject
命令快速创建项目:
tep startproject project_name
并且提供了
-venv
参数,在项目初始化时,可以同时创建一个虚拟环境(推荐):
tep startproject project_name -venv
输出测试报告
tep提供了
--tep-reports
参数来生成allure测试报告:
pytest --tep-reports
报告文件存放在根目录的
reports/
中。
Mock服务
tep自带了一个Flask应用(
utils/flask_mock_api.py
),提供了登录到下单流程的5个接口,启动后即可一键运行示例中的测试用例。
三种开发模式
tep兼容三种开发模式:用例数据一体(适合新手)、用例数据分离(适合老手)、HttpRunner(新老皆宜)。
①用例数据一体,示例代码如下所示:
import jmespathfrom tep.client import requestdef test(env_vars, login):# 搜索商品response = request("get",url=env_vars.domain + "/searchSku",headers={"token": login.token},params={"skuName": "电子书"})sku_id = jmespath.search("skuId", response.json())sku_price = jmespath.search("price", response.json())assert response.status_code < 400# 添加购物车sku_num = 3response = request("post",url=env_vars.domain + "/addCart",headers={"token": login.token},json={"skuId": sku_id, "skuNum": sku_num})total_price = jmespath.search("totalPrice", response.json())assert response.status_code < 400# 下单response = request("post",url=env_vars.domain + "/order",headers={"token": login.token},json={"skuId": sku_id, "price": sku_price, "skuNum": sku_num, "totalPrice": total_price})order_id = jmespath.search("orderId", response.json())assert response.status_code < 400# 支付response = request("post",url=env_vars.domain + "/pay",headers={"token": login.token},json={"orderId": order_id, "payAmount": "6.9"})assert response.status_code < 400assert response.json()["success"] == "true"
更多内容请参考《如何使用teprunner测试平台编写从登录到下单的大流程接口自动化用例》
②用例数据分离
开发中,敬请期待…③HttpRunner,示例代码如下所示:
from httprunner import HttpRunner, Config, Step, RunRequestclass TestLoginPay(HttpRunner):config = (Config("登录到下单流程").variables(**{"skuNum": "3"}).base_url("http://127.0.0.1:5000"))teststeps = [Step(RunRequest("登录").post("/login").with_headers(**{"Content-Type": "application/json"}).with_json({"username": "dongfanger", "password": "123456"}).extract().with_jmespath("body.token", "token").validate().assert_equal("status_code", 200)),Step(RunRequest("搜索商品").get("searchSku?skuName=电子书").with_headers(**{"token": "$token"}).extract().with_jmespath("body.skuId", "skuId").with_jmespath("body.price", "skuPrice").validate().assert_equal("status_code", 200)),Step(RunRequest("添加购物车").post("/addCart").with_headers(**{"Content-Type": "application/json","token": "$token"}).with_json({"skuId": "$skuId", "skuNum": "$skuNum"}).extract().with_jmespath("body.totalPrice", "totalPrice").validate().assert_equal("status_code", 200)),Step(RunRequest("下单").post("/order").with_headers(**{"Content-Type": "application/json","token": "$token"}).with_json({"skuId": "$skuId", "price": "$skuPrice", "skuNum": "$skuNum", "totalPrice": "$totalPrice"}).extract().with_jmespath("body.orderId", "orderId").validate().assert_equal("status_code", 200)),Step(RunRequest("支付").post("/pay").with_headers(**{"Content-Type": "application/json","token": "$token"}).with_json({"orderId": "$orderId", "payAmount": "6.9"}).validate().assert_equal("status_code", 200).assert_equal("body.success", "true")),]
用户手册
https://dongfanger.gitee.io/blog/chapters/tep.html
联系我
https://dongfanger.gitee.io/blog/more.html