前言
当我们测试流程类的接口,需反复去调用同一个接口,就会想到复用API,在代码里面可以写成函数去调用。 那么在yaml 文件中,我们可以把单个API写到一个yaml 文件,测试用例去调用导入API。
pip 安装插件
代码语言:javascript复制pip install pytest-yaml-yoyo
用例分层功能在 v1.0.5 版本上实现
用例分层
我这里只分2层:API 层 和 Test case 用例层
- API 层: 描述接口request请求,可以带上validate 基本的校验
- Test case 用例层: 用例层多个步骤按顺序引用API
API 层示例
API 层只做接口的描述,一般放到项目根目录api目录下
api/login.yaml 示例
代码语言:javascript复制name: post
request:
method: POST
url: http://httpbin.org/post
json:
username: ${username}
password: "123456"
validate:
- eq: [status_code, 200]
如果有需要用到变量,比如登录用户名在不同用例中会用到不同的账号,那么可以使用变量 ${username}
需注意的是,API 层不支持单独运行,因为它只是用例的一个部分,不能当成用例去执行,用例执行需使用 test_*.yml
命名
TestCase 层
用例层通过api 关键字导入需要的API,导入的路径是相对路径,需根据项目的根目录去导入。 如果执行过程中代码无法识别哪个是项目根目录,最好在项目的根目录下放一个pytest.ini 文件,pytest会以pytest.ini 文件所在的目录为项目根目录。 比如我的项目结构是这样的
代码语言:javascript复制├─api
└─ login.yml
├─testcase
└─ test_login.yml
└─conftest.py
└─pytest.ini
那么不管用例文件test_*.yml
在哪个目录,都是以项目根目录去导入API 的yaml文件
config:
name: login case
base_url: http://124.70.221.221:8201
variables:
username: "test123"
password: "123456"
teststeps:
-
name: step login1
api: api/login.yml
extract:
url: body.url
validate:
- eq: [status_code, 200]
- eq: [ok, true]
-
name: step login2
api: api/login.yml
运行用例也是在项目根目录去执行 pytest 运行
代码语言:javascript复制pytest testcase
关于变量
API 层可以引用变量,引用变量的值都是从用例目录的variables 加载的变量,目前只支持config 设置用例全局变量
代码语言:javascript复制config:
name: login case
base_url: http://124.70.221.221:8201
variables:
username: "test123"
password: "123456"
我们可以理解为API是用例的一个步骤,是用例的一部分,导入过去相当于复制request 请求到用例步骤里面。
关于校验
在API 层可以写一些基础的校验,比如校验状态码,我们一般不在API层写业务逻辑校验。 比如登录的用例,期望结果可以是登录成功,也可以是登录失败,那么业务逻辑的校验,应该在用例层去校验
代码语言:javascript复制-
name: step login1
api: api/login.yml
extract:
url: body.url
validate:
- eq: [status_code, 200]
- eq: [ok, true]
如果API 层和用例层都有validate 校验,最后会合并到一起校验。