测试用例分层

每个测试用例都有1个或多个测试步骤（List[step]），每个测试步骤对应一个API请求或其他用例的引用。

软件测试用例包括_白盒测试用例-LMLPHP

从上图分析，我们可以看到testsuite中包含了3个测试用例，testcase1中有4个请求和一个步骤teststep12，其中步骤teststep12依赖testcase2，testcase2中的步骤teststep22又依赖于testcase3。举例说明：模仿上面的用例，我们也写3个用例

testcase1：以最便宜的价格购买一瓶可口可乐（testcase1中的其中一个步骤需要调用testcase2）
testcase2：查询价格最低的250ml可口可乐，并进入首页（testcase2中的其中一个步骤需要调用testcase3）
testcase3：登录用户user1成功

注意

为了简单，在HttpRunner v2.x中的API概念已经被取消了。你可以将API定义为只有一个请求步骤的测试用例。

测试用例的分层思想：

测试用例（testcase）应该是完整且独立的，每条测试用例应该是都可以独立运行的（重要）
测试用例是测试步骤（teststep）的有序集合
测试用例集（testsuite）是测试用例的无序集合，集合中的测试用例应该都是相互独立，不存在先后依赖关系的，可以无序执行

RunRequest

    teststeps = [
        Step(
            RunRequest("get with params")
            .with_variables(
                **{"foo1": "bar11", "foo2": "bar21", "sum_v": "${sum_two(1, 2)}"}
            )
            .get("/get")
            .with_params(**{"foo1": "$foo1", "foo2": "$foo2", "sum_v": "$sum_v"})
            .with_headers(**{"User-Agent": "HttpRunner/${get_httprunner_version()}"})
            .extract()
            .with_jmespath("body.args.foo2", "foo3")
            .validate()
            .assert_equal("status_code", 200)
            .assert_equal("body.args.foo1", "bar11")
            .assert_equal("body.args.sum_v", "3")
            .assert_equal("body.args.foo2", "bar21")
        ),

从上述代码可知，teststeps中的RunRequest用于发送API请求和对响应结果进行提取和断言下面详细介绍里面各个方法的作用

RunRequest(name)

RunRequest的参数名用于指定teststep名称，它将显示在执行日志和测试报告中。 RunRequest("get with params")这个步骤的名称就是get with params

.with_variables

设置测试步骤的变量。每个测试步骤的变量都是独立的，如果想在多个测试步骤中共享变量，需要在config variables中定义。注意：如果config variables和.with_variables里有重名的变量，那么当你引用这个变量的时候，Step变量会覆盖config变量。

.method(url)

设置http请求方法，比如get、post、put、patch、delete等等，后面再跟上路径注意：如果base_url在config中设置了，url只能是相对路径部分。

# 用get方法访问路径为/getTime（相对路径）
.get("/getTime")

# 用post方法访问路径id=3（绝对路径）
.post("http://www.baidu.com/getTime")

.with_params

设置url的query，以键值对的形式，相当于requests.request 中的params。

.with_params(**{"foo1": "$foo1", "foo2": "$foo2", "sum_v": "$sum_v"})

.with_headers

设置请求的headers，相当于requests.request 中的headers。

.with_headers(**{"User-Agent": "HttpRunner/${get_httprunner_version()}"})

.with_cookies

设置Http请求cookies，相当于requests.request 中的cookies。

.with_data

设置Http的请求Body，相当于requests.request 中的data。

.with_data("foo1=$foo1&foo2=$foo2&foo3=$foo3")

.with_json

设置Http请求json格式的Body，相当于requests.request 中的json。

.with_json({"foo1": "foo1", "foo2": "foo2", "foo3": "foo3"})

.extract

利用jmespath提取Json Response body内容，

.with_jmespath(jmes_path: Text, var_name: Text)

jmespath: 目标元素的jmespath表达式，可以参考https://www.cnblogs.com/jiakecong/category/1929704.html
var_name: 存储提取值的变量名，可以被后面的测试步骤引用。

.validate

断言，我们测试最终就是要验证接口返回是否符合预期。格式：

assert_XXX(jmespath: Text, expected_value: ANy, message: Text="")

jmespath: jmespath表达式，可以参考https://www.cnblogs.com/jiakecong/category/1929704.html
expected_value: 指定期望值或变量，也可以调用方法
message(optional): 用于描述断言失败原因

下图展示HttpRunner内置断言：