以login_test.py登录接口为例：

from httprunner import HttpRunner, Config, Step, RunRequest
class TestCaseLogin(HttpRunner):
    config = Config('hrun3_demo').base_url('http://xxx:80').export(*['vars_name'])

    teststeps = [
        Step(
            RunRequest('login')
            .post('/xxx/login.html')
            .with_headers(**{'X-Requested-With': 'XMLHttpRequest'})
            .with_data({'accounts':'ss','pwd':'123456'})
        .extract()
            .with_jmespath('body.msg','value_msg')
        .validate()
            .assert_equal('body.msg','登录成功')
            .assert_equal('body.code',0)
        )
    ]

if __name__ == '__main__':
    TestCaseLogin().test_start()

模块引用

每个 case 文件必须要有的
from httprunner import HttpRunner, Config, Step, RunRequest

父类HttpRunner

每个 testcase都是HttpRunner的子类,在类名后面必须写HttpRunner
class TestCaseLogin(HttpRunner):

类属性

每个 testcase必须要有两个类属性config teststeps

一.config

配置测试用例级别的设置
config = Config('hrun3_demo')

.name（必填）
指定测试用例名称。这将显示在执行日志和测试报告中。

.base_url（可选）
指定SUT的通用架构和主机部分，例如https://postman-echo.com。如果base_url指定，则teststep中的url只能设置相对路径部分。如果要在不同的SUT环境之间切换，这将特别有用。

.variables（可选）
指定测试用例的公共变量。每个测试步骤都可以引用未在步骤变量中设置的配置变量。换句话说，步骤变量比配置变量具有更高的优先级。

.verify （可选）
指定是否验证服务器的TLS证书。如果我们想记录测试用例执行的HTTP流量，这将特别有用，因为如果没有设置verify或将其设置为True，则会发生SSLError。

SSLError（SSLCertVerificationError（1，'[SSL：CERTIFICATE_VERIFY_FAILED]证书验证失败：证书链中的自签名证书（_ssl.c：1076）'）

.export （可选）
指定导出的测试用例会话变量。将每个测试用例视为一个黑盒，config variables是输入部分，而config export是输出部分。特别是，当一个测试用例在另一个测试用例的步骤中被引用，并且将被提取一些会话变量以在后续测试步骤中使用时，则提取的会话变量应在配置export部分中进行配置。将测试用例的某些变量指定为全局变量。（PS：不配置export在另一个引用类中进行该累的变量调用时，直接export也是可以的，最好还是配置一下）

二. teststeps

teststeps 下有两种情况RunRequest和RunTestCase

teststeps = [
        Step(
            RunTestCase('引用登录 login_test')
            .call(TestCaseLogin)
            .export(*['value_msg'])
        ),
        Step(
            RunRequest('加入购物车')
            .post('/xxxt/save.html')
            .with_headers(**{'X-Requested-With': 'XMLHttpRequest'})
            .with_data({'goods_id': '5', 'stock': "1"})
        .extract()
            .with_jmespath('body','value_msg')
        .validate()
            .assert_equal('body.msg','加入成功')
            .assert_equal('body.code',0)
        )

1.RunRequest

RunRequest 在一个步骤中用于向API发出请求，并对响应进行一些提取或验证。

.name
RunRequest 的参数用于指定测试步骤名称，该名称将显示在执行日志和测试报告中。

.with_variables
指定测试步骤变量。每个步骤的变量都是独立的，因此，如果要在多个步骤中共享变量，则应在配置变量中定义变量。此外，步骤变量将覆盖配置变量中具有相同名称的变量。（PS:注意参数传递的格式使用**{}，使用关键字参数解包的方式进行参数传递给with_variables），参数引用使用"$变量名"，如果是函数引用使用"${函数名()}"

method（url）
指定HTTP方法和SUT的URL。这些对应于method和url参数requests.request。
如果base_url在config中设置，则url只能设置相对路径部分。如果在Config中设置了baseurl，method中只能设置相对路径，可选参数为get/post/put/delete/等。
如.post('http:xxx/login.html')

.with_params
指定请求网址的查询字符串。这对应于的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：文本，期望值：任何，消息：文本=“”）

2.RunTestCase（名称）

RunTestCase 在一个步骤中用于引用另一个测试用例调用。

teststeps = [
        Step(
            RunTestCase('关联 login_test')
            .call(TestCaseLogin)# 引用TestCaseLogin
            .export(*['value_msg'])
        )
        Step(
      )]

.name
RunTestCase 的参数用于指定测试步骤名称，该名称将显示在执行日志和测试报告中。

.with_variables
指定测试步骤变量。每个步骤的变量都是独立的，因此，如果要在多个步骤中共享变量，则应在配置变量中定义变量。此外，步骤变量将覆盖配置变量中具有相同名称的变量。

.call
指定引用的测试用例类。你在引用另一个测试用例的step中的参数时，需要先指定引用的测试用例类

.export
指定会话变量名称以从引用的测试用例中导出。导出的变量可以通过后续测试步骤step进行引用。导出的是step中的jmespath提取的变量，export之后，这个变量是全局变量，但是不能再confg中进行设置，因为测试类的引用是在step中进行的，而类的初始化是先初始化config，然后初始化teststeps，所以参数的传递在step之间

httprunner3 case结构及关键字详解