HttpRunner_简单入门

Posted 2023-04-29

参考技术A HttpRunner 是一款面向 HTTP(S) 协议的通用测试框架，只需编写维护一份 YAML/JSON 脚本，即可实现自动化测试、性能测试、线上监控、持续集成等多种测试需求。

官方文档 （内容比较乱）

按照本文档，能够快速构建出可以执行大部分接口测试用例的httprunner脚本

文档： 测试用例结构和hook机制

从头开始写yaml很麻烦， HttpRunner 提供了命令工具，能够把fiddler导出的har文件，转换成yaml文件，可以在这个基础上进行自己想要的修改，就可以当成 testcase 来使用

Charles Proxy 也支持导出har格式的文件，看官网： https://cn.httprunner.org/prepare/record/

PS.如果是最简单的执行一个testcase，有这个就可以执行了，但是本文档会说使用到testcase/tsetsuite/参数化parameters（更详细的csv文件/hook函数待续）

请求方式 ： POST
路径 ： http://xxx/audience/add
请求参数（部分）：

上面的例子中，所使用的文件层面上，最小单位是 testcase ，我们也可以把 testcase 中的每个测试步骤，提取出来，放到 teststep 中

如果想要更具体深入去了解（比如说更多的参数化数据、读取csv文件、调用hook函数、压测等），可看：
1. 测试用例结构和hook机制
2. 参数化数据驱动
3. 环境变量
4. 性能测试
5. 开发拓展

建议：多使用，当不会的时候，去看官方文档（虽说很乱），再不行就百度谷歌。得多用才能更熟练

HttpRunner 接口自动化简单实践

1、安装

1.1 命令行pip直接安装就好

1.2 验证安装

命令行输入hrun -V，返回项目版本信息则表明安装成功

2、新建测试项目

这里我用直接通过框架的脚手架工具命令生成目录结构

如：hrun --startproject Api_Test

这样我们就在当前目前目录下建立了一个测试项目Api_Test：

3、一个测试用例demo

用例文件描述、detalk文件描述、测试执行方法描述、测试报告描述（内容、log、参数响应等等）
3.1）在Api_Test estcases目录下新建一个yml用例文件

3.2）编写用例
我们在新建的yml文件中编写用例信息,如上图：

• config全局配置项，用于配置此文件中所有用例的公共参数
• 一个test表示一条具体用例
• 在debugtalk.py文件配置所有yml文件公用的参数，如：测试服务域名

3.3）用例执行
命令行下，通过hrun执行指定用例文件。如下图所示：用例执行通过，并在当前目录生成测试报告目录及html测试报告

3.4）测试报告
我们在测试报告目录下查看html测试报告

• 测试报告summary模块中会详细展示测试的执行时间、耗时、用例总数及成功的数量等信息
• 测试报告detail模块会展示测试用例的详细执行信息
  点开log我们可以看到具体的传参及响应等信息：