以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之间