一、前言
前面讲了怎么搭建框架环境，怎么运行，以及直接就讲到了怎么生成allure测试报告，说白了就是阐述了一个大的框架，但具体运用到工作中时，测试用例怎么编写呢？且看下面的唠叨，哈哈哈。
二、用例分层
- 测试用例（testcase）应该是完整且独立的，每条测试用例应该是都可以独立运行的
- 测试用例是测试步骤（teststep）的有序集合
- 测试用例集（testsuite）是测试用例的无序集合，集合中的测试用例应该都是相互独立，不存在先后依赖关系的；如果确实存在先后依赖关系，那就需要在测试用例中完成依赖的处理
三、测试用例结构
每个测试用例都是 的子类HttpRunner，并且必须具有两个类属性：config和teststeps。
- config：配置测试用例级别的设置，包括
base_url、verify、variables、export。 - teststeps：teststep(
List[Step])列表，每一步对应一个API请求或者另一个testcase引用调用。此外，variables/extract/validate/hooks机制支持，可制作十分复杂的测试方案。
# NOTE: Generated By HttpRunner v3.1.5
# FROM: harlogin.har
from httprunner import HttpRunner, Config, Step, RunRequest, RunTestCase
class TestCaseLogin(HttpRunner):
config = Config("登录")
.verify(False)
.base_url("https://XXX.com")
.variables(
**{"username":"李白","psw":"123456"}
)
.export(*["userId","userNo","userName"])
teststeps = [
Step(
RunRequest("登录接口")
.post("/auth/login_by_password")
.with_headers(
**{
"accept": "application/json, text/plain, */*",
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
"current-user-id": "",
"content-type": "application/json;charset=UTF-8",
"accept-language": "zh-CN,zh;q=0.9",
}
)
.with_json(
{
"employeeName": "$username",
"loginType": "PASSWORD",
"password": "$psw",
"currentUserId": "",
"workerId": "",
"currentUserName": "",
"currentUserCode": "",
}
)
.extract()
.with_jmespath("body.data.userId","userId")
.with_jmespath("body.data.userNo","userNo")
.with_jmespath("body.data.userName","userName")
.validate()
.assert_equal("status_code", 200)
.assert_equal("body.successful", True)
.assert_equal("body.code", "200")
.assert_equal("body.message", "请求成功")
),
]
if __name__ == "__main__":
TestCaseLogin().test_start()
1、config
每个测试用例应该有一个config部分，您可以在其中配置测试用例级别设置。
- 姓名（必填）：指定测试用例名称。这将显示在执行日志和测试报告中。
- base_url（可选）：指定 SUT 的通用架构和主机部分，例如
https://postman-echo.com. 如果base_url指定，则 teststep 中的 url 只能设置相对路径部分。如果您想在不同的 SUT 环境之间切换，这尤其有用。 - 变量（可选）：指定测试用例的公共变量。每个测试步骤都可以引用未在步骤变量中设置的配置变量。换句话说，步骤变量比配置变量具有更高的优先级。
- 验证（可选）：指定是否验证服务器的 TLS 证书。如果我们想记录测试用例执行的 HTTP 流量，这尤其有用，因为如果 verify 未设置或设置为 True，则会发生 SSLError。SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] 证书验证失败：证书链中的自签名证书 (_ssl.c:1076)'))
- 导出（可选）：指定测试用例的导出会话变量。将每个测试用例视为一个黑盒，config
variables是输入部分，configexport是输出部分。特别是，当一个测试用例在另一个测试用例的步骤中被引用，并且会提取一些会话变量以供后续测试步骤使用时，则应在配置export部分配置提取的会话变量。
2、teststeps
每个测试用例应该有一个或多个有序的测试步骤 ( List[Step])，每个步骤对应一个 API 请求或另一个测试用例引用调用。
RunRequest(name)
RunRequest 用于向 API 发出请求并对响应进行一些提取或验证的步骤。
nameRunRequest的参数用于指定测试步骤名称，该名称将显示在执行日志和测试报告中。
.with_variables
指定测试步骤变量。每个步骤的变量都是独立的，因此如果要在多个步骤中共享变量，则应在配置变量中定义变量。此外，步骤变量将覆盖配置变量中具有相同名称的变量。
.method(url)
指定 HTTP 方法和 SUT 的 url。这些对应于method和 的url参数requests.request。
如果base_url在config中设置，url只能设置相对路径部分。
.with_params
为请求 url 指定查询字符串。这对应于 的params参数requests.request。
.with_headers
为请求指定 HTTP 标头。这对应于 的headers参数requests.request。
.with_cookies
指定 HTTP 请求 cookie。这对应于 的cookies参数requests.request。
.with_data
指定 HTTP 请求正文。这对应于 的data参数requests.request。
.with_json
在 json 中指定 HTTP 请求正文。这对应于 的json参数requests.request。
extract
.WITH_JMESPATH
使用jmespath提取 JSON 响应正文。
with_jmespath（jmes_path：文本，var_name：文本）
- jmes_path：jmespath 表达式，更多细节参考JMESPath 教程
- var_name：存储提取值的变量名，可供后续测试步骤引用
validate
.ASSERT_XXX
使用jmespath提取 JSON 响应正文并使用预期值进行验证。
assert_XXX(jmes_path: Text, expected_value: Any, message: Text = "")
- jmes_path：jmespath 表达式，更多细节参考JMESPath 教程
- 预期值：这里也可以使用指定的预期值、变量或函数引用
- 消息（可选）：用于指示断言错误原因
RunTestCase(name)
RunTestCase 在一个步骤中用于引用另一个测试用例调用。
nameRunTestCase的参数用于指定测试步骤名称，该名称将显示在执行日志和测试报告中。
.with_variables
与 RunRequest 的.with_variables.
.call
指定引用的测试用例类。
.export
指定要从引用的测试用例导出的会话变量名称。导出的变量可以被后续的测试步骤引用
