介绍
HttpRunner 是一款面向 HTTP(S) 协议的通用测试框架，只需编写维护一份 YAML/JSON 脚本，即可实现自动化测试、性能测试、线上监控、持续集成等多种测试需求。
此文档适用于全新发布的 HttpRunner 2.x 版本
核心特性
继承 Requests 的全部特性，轻松实现 HTTP(S) 的各种测试需求
采用 YAML/JSON 的形式描述测试场景，保障测试用例描述的统一性和可维护性
借助辅助函数（debugtalk.py），在测试脚本中轻松实现复杂的动态计算逻辑
支持完善的测试用例分层机制，充分实现测试用例的复用
测试前后支持完善的 hook 机制
响应结果支持丰富的校验机制
基于 HAR 实现接口录制和用例生成功能（har2case）
结合 Locust 框架，无需额外的工作即可实现分布式性能测试
执行方式采用 CLI 调用，可与 Jenkins 等持续集成工具完美结合
测试结果统计报告简洁清晰，附带详尽统计信息和日志记录
极强的可扩展性，轻松实现二次开发和 Web 平台化
运行环境
HttpRunner 是一个基于 Python 开发的测试框架，可以运行在 macOS、Linux、Windows 系统平台上。
Python 版本：HttpRunner 支持 Python 3.4 及以上的所有版本，并使用 Travis-CI 进行了持续集成测试，测试覆盖的版本包括 2.7/3.4/3.5/3.6/3.7。虽然 HttpRunner 暂时保留了对 Python 2.7 的兼容支持，但强烈建议使用 Python 3.4 及以上版本。
操作系统：推荐使用 macOS/Linux
安装方式
HttpRunner 的稳定版本托管在 PyPI 上，可以使用 pip 进行安装。
$ pip install httprunner
如果你需要使用最新的开发版本，那么可以采用项目的 GitHub 仓库地址进行安装：
$ pip install git+https://github.com/HttpRunner/HttpRunner.git@master
版本升级
假如你之前已经安装过了 HttpRunner，现在需要升级到最新版本，那么你可以使用-U参数。该参数对以上三种安装方式均生效。
$ pip install -U HttpRunner$ pip install -U git+https://github.com/HttpRunner/HttpRunner.git@master
安装校验
在 HttpRunner 安装成功后，系统中会新增如下 5 个命令：
httprunner: 核心命令
ate: 曾经用过的命令（当时框架名称为 ApiTestEngine），功能与 httprunner 完全相同
hrun: httprunner 的缩写，功能与 httprunner 完全相同
har2case: 辅助工具，可将标准通用的 HAR 格式（HTTP Archive）转换为YAML/JSON格式的测试用例
httprunner、hrun、ate 三个命令完全等价，功能特性完全相同，个人推荐使用hrun命令。
运行如下命令，若正常显示版本号，则说明 HttpRunner 安装成功。
$ hrun -V2.0.2$ har2case -V0.2.0
测试准备
抓包分析
在开始测试之前，我们需要先了解接口的请求和响应细节，而最佳的方式就是采用 Charles Proxy 或者 Fiddler 这类网络抓包工具进行抓包分析。
获取 HAR 数据包
在转换生成测试用例之前，需要先将抓取得到的数据包导出为 HAR 格式的文件。在Charles Proxy中的操作方式为，选中需要转换的接口（可多选或全选），点击右键，在悬浮的菜单目录中点击【Export...】，格式选择HTTP Archive(.har)后保存即可；假设我们保存的文件名称为 demo.har。
fiddler的操作方式，选择HttpArchive
转换生成测试用例，然后，在命令行终端中运行 har2case 命令，即可将 demo.har 转换为 HttpRunner 的测试用例文件。
使用 har2case 转换脚本时默认转换为 JSON 格式。
加上 -2y/--to-yml 参数后转换为 YAML 格式。
两种格式完全等价，YAML 格式更简洁，JSON 格式支持的工具更丰富，大家可根据个人喜好进行选择
运行测试
HttpRunner 在命令行中启动测试时，通过指定参数，可实现丰富的测试特性控制。
$ hrun -h
usage: hrun [-h] [-V] [--log-level LOG_LEVEL] [--log-file LOG_FILE] [--dot-env-path DOT_ENV_PATH] [--report-template REPORT_TEMPLATE] [--report-dir REPORT_DIR] [--failfast] [--save-tests] [--startproject STARTPROJECT] [--validate [VALIDATE [VALIDATE ...]]] [--prettify [PRETTIFY [PRETTIFY ...]]] [testcase_paths [testcase_paths ...]]One-stop solution for HTTP(S) testing.positional arguments: testcase_paths testcase file pathoptional arguments: -h, --help show this help message and exit -V, --version show version --log-level LOG_LEVEL Specify logging level, default is INFO. --log-file LOG_FILE Write logs to specified file path. --dot-env-path DOT_ENV_PATH Specify .env file path, which is useful for keeping sensitive data. --report-template REPORT_TEMPLATE specify report template path. --report-dir REPORT_DIR specify report save directory. --failfast Stop the test run on the first error or failure. --save-tests Save loaded tests and parsed tests to JSON file. --startproject STARTPROJECT Specify new project name. --validate [VALIDATE [VALIDATE ...]] Validate JSON testcase format. --prettify [PRETTIFY [PRETTIFY ...]] Prettify JSON testcase format.
指定测试用例路径
使用 HttpRunner 指定测试用例路径时，支持多种方式。
使用 hrun 命令外加单个测试用例文件的路径，运行单个测试用例，并生成一个测试报告文件：
$ hrun filepath/testcase.yaml
将多个测试用例文件放置到文件夹中，指定文件夹路径可将文件夹下所有测试用例作为测试用例集进行运行，并生成一个测试报告文件：
$ hrun testcases_folder_path
failfast
默认情况下，HttpRunner 会运行指定用例集中的所有测试用例，并统计测试结果。
对于某些依赖于执行顺序的测试用例，例如需要先登录成功才能执行后续接口请求的场景，当前面的测试用例执行失败后，后续的测试用例也都必将失败，因此没有继续执行的必要了。
若希望测试用例在运行过程中，遇到失败时不再继续运行后续用例，则可通过在命令中添加--failfast实现。
$ hrun filepath/testcase.yml --failfast
日志级别¶
默认情况下，HttpRunner 运行时的日志级别为INFO，只会包含最基本的信息，包括用例名称、请求的URL和Method、响应结果的状态码、耗时和内容大小。
若需要查看到更详尽的信息，例如请求的参数和响应的详细内容，可以将日志级别设置为DEBUG，即在命令中添加--log-level debug
保存详细过程数据
为了方便定位问题，运行测试时可指定 --save-tests 参数，即可将运行过程的中间数据保存为日志文件
$ hrun filepath/testcase.yml --save-tests
测试报告
使用 HttpRunner 执行完自动化测试后，会在当前路径的 reports 目录下生成一份 HTML 格式的测试报告。
默认情况
默认情况下，生成的测试报告文件会位于项目根目录的 reports 文件夹中，文件名称为测试开始的时间戳
默认报告样式
在 HttpRunner 中自带了一个 Jinja2 格式的报告模版，默认情况下，生成的报告样式均基于该模版（httprunner/templates/default_report_template.html）。
测试报告形式如下：
在 Summary 中，会罗列本次测试的整体信息，包括测试开始时间、总运行时长、运行的Python版本和系统环境、运行结果统计数据
Vaildators写在yaml或者json中
性能测试
HttpRunner 通过复用 Locust，可以在无需对 YAML/JSON 进行任何修改的情况下，直接运行性能测试....
