您的位置:首页 > 理论基础 > 计算机网络

tep集成HttpRunner与Flask实现开箱即用

2022-01-03 19:24 921 查看

大家好,我是刚哥。

趁着元旦假期最后一天,有着大把时间,奔着把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: demo093
Project root dir: D:\PycharmProjects\demo093

Created folder: demo093
Created folder: demo093\fixtures
Created folder: demo093\tests
Created folder: demo093\files
Created folder: demo093\reports
Created folder: demo093\utils
Created file: demo093\.gitignore
Created file: demo093\conf.yaml
Created file: demo093\conftest.py
Created file: demo093\pytest.ini
Created file: demo093\fixtures\__init__.py
Created file: demo093\fixtures\fixture_admin.py
Created file: demo093\fixtures\fixture_env_vars.py
Created file: demo093\fixtures\fixture_login.py
Created file: demo093\fixtures\fixture_your_name.py
Created file: demo093\tests\__init__.py
Created file: demo093\tests\test_login.py
Created file: demo093\tests\test_post.py
Created file: demo093\tests\test_mysql.py
Created file: demo093\tests\test_request.py
Created file: demo093\tests\test_login_pay.py
Created file: demo093\tests\test_login_pay_httprunner.py
Created file: demo093\utils\__init__.py
Created 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 https://pypi.tuna.tsinghua.edu.cn/simple tep

检查安装成功:

$ tep -V  # 或者 tep --version
0.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 jmespath
from tep.client import request

def 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 = 3
response = 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 < 400
assert response.json()["success"] == "true"

更多内容请参考《如何使用teprunner测试平台编写从登录到下单的大流程接口自动化用例》

②用例数据分离

开发中,敬请期待... ③HttpRunner,示例代码如下所示:

from httprunner import HttpRunner, Config, Step, RunRequest

class 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

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: