httprunner进行接口测试-参数化

Posted 2022-01-27 summerxye

1，用例格式

通常一个脚本文件里面有如下模块：

- config

- test

- test

即：全局配置、用例、用例

config模块里面定义的是整个文本测试集的变量，即全局变量

test模块里面定义的是具体接口请求，下面看个具体例子

 

2，举个例子

以某快递查询接口为例，新建一个yaml文件，命名为test_post_api.yaml

- config:
    name: test kuaidi100 api
    request:
        base_url: http://www.kuaidi100.com
            
- test:
    name: test kuaidi100 one
    request:
        url: /query
        method: GET
        params:
            type: huitongkuaidi
            postid: 350757858666

yaml格式类似与json，可以看成是优雅的json。yaml中，跟python一样，也是空格缩进表示同一层级，不过没有python那么严格，只要缩进空格数一样就是同一级，“-”python读取出来是list，“#”用来注释，更多语法可以去官网学习。

config模块

name  本用例集名称

request  请求全局变量，包括base_url（公共host）、headers等

base_url  全局公共host，也可以不定义，用例中写全url即可

以上全局配置，除了name，其他都是非必要的，根据需要添加。

test模块

name  本条测试用例的名字

request  请求体

url  请求的路径，由于全局变量已经定义好host，这里就直接填写后面的路由即可

method  请求方式

params  请求参数

示例是某快递查询接口，脚本初步写好，接下来开始测试吧，怎么测试脚本？

打开cmd，进入到该文件目录，执行命令hrun test_post_api.yaml回车即可。

 

成功，cool，可以看到一条用例测试通过，而且还在脚本所在目录生成了report文件夹，生成的测试报告就放在里面，报告名字为测试时间戳。报告长这样，还是蛮清爽的。

点击log，可以查看详细日志

3，断言

虽然运行成功，但我们无法判断请求的结果与我们的预期是否一致。这个时候就需要断言。httprunner中断言很简单，通过在用例里面增加validate参数实现，如下：

那么怎么知道如何定义被断言的数据呢？即上图中的content.message等。

浏览器执行该接口，其返回值是字典（如下，这些字典数据存在content变量里面），可以直接通过content后面接“.key”获取value值，再判断与我们给出的值是否相等，以此判断用例是否通过。如：content.message断言值设置为“ok”，如果其对应的value等于“ok”，就表示通过。

"message":"ok","nu":"350757858666","ischeck":"1","condition":"F00","com":"huitongkuaidi","status":"200"......

加好想要的断言后，再次执行用例，打开报告查看日志，可以看到，日志里面清楚的记录了所以的断言结果。

 

4，参数传递

在做接口测试时，经常需要将上一个接口返回的结果，传入到下一个接口中当着参数，httprunner中使用extration参数来进行参数的传递。由于演示接口只有一个，切接口返回值里面有运单号，就直接拷贝了上面的用例作为接受参数的用例。故可以将第一个用例返回值中的运单号提取出来，传入第二个用例当做参数，只需在前面加$就可以引用该参数，look

- config:
    name: test kuaidi100 api
    # parameters:
        # - user_id: [1001, 1002, 1003, 1004]
    request:
        base_url: http://www.kuaidi100.com
            
- test:
    name: test kuaidi100 one
    request:
        url: /query
        method: GET
        params:
            type: huitongkuaidi
            postid: 350757858666
    validate:
        - eq: [status_code, 200]
        - eq: [content.message, "ok"]
        - eq: [content.com, "huitongkuaidi"]
        - eq: [content.nu, "350757858666"]        
    extract:
        - postid: content.nu
        
- test:
    name: test kuaidi100 two
    request:
        url: /query
        method: GET
        params:
            type: huitongkuaidi
            postid: $postid
    validate:
        - eq: [status_code, 200]
        - eq: [content.message, "ok"]
        - eq: [content.com, "huitongkuaidi"]
        - eq: [content.nu, "350757858666"]     

执行测试，通过，cool：

 

5，脚本运行方式

上面也提到了，单个脚本可以使用：hrun ***.yaml

当要同时运行多个脚本文件的时候，后面接多个文件：hrun a.yaml b.yaml c.yaml

当然，也可以直接指定文件夹，运行文件下所以脚本：hrun ***\\test\\

6，参数化

诚然，无论在日常接口测试，还是性能测试，都对数据有要求，特别是性能测试，需要大量数据，这个时候就需要对传递的参数进行参数化了。

httprunner中支持的参数化方法有：csv文本、自定义函数

6.1、使用csv文本进行参数化

在脚本同级目录下新建csv文件，打开存入需要的数据，保存

 

引用： 增加一个parameters参数，通过调用$P(***.csv)方法来读取csv文本中的数据，也是使用$+变量名引用参数。

值得注意的是，通常来说，一个CSV文件中会放多列数值，那么这个时候，各列参数通过“-”连接来读取参数，如：要传postid1、name两列参数，这样写就可以postid1-name: $P(postid.csv)

 

 来来来，测试下，“Ran 4 tests in 2.076s”，good。因为csv中有4个参数，用例也运行了4遍，查看log，4个参数都是csv里面的，而且是顺序的。

 

6.2、使用自定义函数进行参数化

还是在脚本下，新建debugtalk.py文件，注意，这个文件名字就不能随便取啦，固定的。

 

 与csv引用类似，脚本中使用$get_postids(5)来引用函数，5表示想要获取的参数个数，执行结果如下：

 

至此，httprunner接口测试框架的主要功能、或者说接口测试需要用到的大部分功能、场景，大概说了一遍。这样做接口测试是不是感觉非常的简单、优雅呢？

注意，由于这个框架集成了locusts性能测试工具，故还可以非常方便的进行性能测试，与接口测试类似，执行如下命令：locusts -f test_post_api.yaml，浏览器打开http://localhost:8089即可进行性能测试。

最后，这是一份非常简单的入门教程，也还算比较全。其中有些细节，官网也没有给出，写的时候还是整了蛮久的。其他更多功能、细节，还是请参考官方中文教程网站：http://cn.httprunner.org/ 源码挪步：https://github.com/httprunner/httprunner