一、简介
HttpRunner 是一款面向 HTTP(S) 协议的通用测试框架，只需编写维护一份YAML/JSON脚本，即可实现自动化测试、性能测试、线上监控、持续集成等多种测试需求。
核心特性：
- 继承 Requests 的全部特性，轻松实现 HTTP(S) 的各种测试需求
- 测试用例与代码分离，采用
YAML/JSON的形式描述测试场景，保障测试用例具备可维护性 - 测试用例支持分层机制，充分实现测试用例的复用
- 测试用例支持参数化和数据驱动机制
- 使用 skip 机制实现对测试用例的分组执行控制
- 支持热加载机制，在文本测试用例中轻松实现复杂的动态计算逻辑
- 基于 HAR 实现接口录制和用例生成功能（har2case）
- 结合 Locust 框架，无需额外的工作即可实现分布式性能测试
- 执行方式采用 CLI 调用，可与 Jenkins 等持续集成工具完美结合
- 测试结果统计报告简洁清晰，附带详尽统计信息和日志记录
- 具有可扩展性，便于扩展实现 Web 平台化（HttpRunnerManager）
二、安装
1. 首次安装：pip install httprunner
2. 升级到最新：pip install -U HttpRunner
三、命令
- hrun：核心命令
- locusts：基于Locust实现性能测试
- har2case：辅助工具，将har格式地文档转换为yml/json格式的测试用例
四、用例简述
- 测试用例集：单个测试用例或多个测试用例的集合，表现形式为一个json文件
- 测试用例：单次http请求和响应过程，表现形式为json文件中的一个test
- config：全局配置项，作用于整个测试用例集，一个测试用例集中只有一个config
- test：作用于单个测试用例，包含单个请求、响应、校验过程，作用域仅限于单个接口，一个测试用例集中可以有多个test
- 如果一个变量在config中定义了，在test中没有定义，则test会继承该变量
- 如果一个变量在config和test中都定义了，则test会使用自己定义的变量值
- 各个test的空间相互独立，互不影响
五、结果校验器
1. 结果校验器功能：主要辅助测试人员执行测试用例时判断系统的功能是否正常。对于每一个test，可以指定0个或多个校验项，放置在validate中。在自动化测试执行的时候，会在发起HTTP请求、解析结果响应之后，逐个检查各个校验项，若存在任意校验项不通过的情况，则该test将终止并被标记为失败。
例：
- test:
name: get token
request:
url: https://ape-api.yuanfudao.ws/win/login
method: GET
extract:
- token: content.token
validate:
- {"check": "status_code", "comparator": "eq", "expect": 200}
- {"check": "content.token", "comparator": "len_eq", "expect": 16}2. 如上例所示，每一个校验项均为一个json结构，里面包含check、expect、comparator三个属性字段。其中，check对应着要检查的字段，expect对应着检查字段预期的值，这两项是必须指定的；comparator字段对应着比较方法，若不指定，则默认采用eq，即检查字段与预期值相等。
3. 其他检查方法：
HttpRunner除了eq，还内置了大量的检查方法。例如，我们可以通过gt、ge、lt、le等比较数值大小，通过len_eq、len_gt、len_lt等比较长度是否相等（列表、字典、字符串均适用），通过contains、contained_by来判断包含关系，通过startswith、endswith判断字符串的开头结尾，甚至通过regex_match来判断是否满足正则匹配等。
详细的比较方式还有许多，需要时可查看comparator表格。
六、运行
1. Charles抓包，导出.har格式文件
2. 转换格式：
har2case xxx.har xxx.json
3. 运行：
4. 查看报告：
5. 其他：
- 日志级别：需要查看到更详尽的信息，例如请求的参数和响应的详细内容，可以将日志级别设置为
DEBUG，即在命令中添加--log-level debug。 -
failfast：若希望测试用例集在运行过程中，遇到失败时不再继续运行后续用例，则可通过在命令中添加
--failfast实现。 - 指定报告名称：如需指定生成报告的名称，可以使用
--html-report-name参数。（会在reports目录下生成相应名称的文件夹，里面包含相同名称的报告）