HTTPRunner

HttpRunner 是一个基于 Python 的开源接口自动化测试框架，它支持 YAML/JSON 格式编写测试用例，并能够生成详细的测试报告。该框架的设计理念是将测试脚本与测试数据分离，从而提高测试用例的可维护性和复用性 [^3]。 ### 安装 HttpRunner 在开始使用 HttpRunner 之前，需要先安装它。可以通过 pip 命令来安装： ```bash pip install httprunner ``` 安装完成后，可以使用 `hrun --version` 来验证是否安装成功 [^3]。 ### 编写第一个测试用例 HttpRunner 支持多种格式的测试用例文件，如 YAML 或 JSON。下面是一个简单的 YAML 测试用例示例，用于测试登录接口： ```yaml config: name: 登录接口测试 variables: username: admin password: VCfa......gnw== msg: "" teststeps: - name: 获取 token request: url: "${ENV(HOST)}/users/login" method: POST headers: SID: "bf5eadddf8eb496bb7788474f8322c6e" json: username: "$username" password: "$password" validate: - eq: ["body.message", "$msg"] ``` 保存为 `login.yml` 文件后，可以直接通过 `hrun` 命令运行测试： ```bash hrun login.yml ``` ### 参数化测试 HttpRunner 支持参数化测试，这意味着可以在同一个测试用例中多次运行不同的输入组合。以下是如何定义参数化的例子： ```python import pytest from httprunner import Parameters from httprunner import HttpRunner, Config, Step, RunRequest class TestCaseLogin(HttpRunner): @pytest.mark.parametrize( "param", Parameters( { "username-password-msg": [ ["admin", "VCfa......gnw==", None], ["nimda", "VCfa......gnw==", "用户不存在或者已冻结"], ["admin", "123456", "解密失败,请确认传输加密方式"], ] } ), ) def test_start(self, param): super().test_start(param) config = Config("登录") teststeps = [ Step( RunRequest("获取token") .post("${ENV(HOST)}/users/login") .with_headers(**{"SID": "bf5eadddf8eb496bb7788474f8322c6e"}) .with_json({"username": "$username", "password": "$password"}) .validate() .assert_equal("body.message", "$msg") ), ] if __name__ == "__main__": TestCaseLogin().test_start() ``` ### 生成测试报告 运行完测试之后，HttpRunner 会自动生成 HTML 格式的测试报告，帮助你快速查看测试结果。默认情况下，报告会被保存在当前目录下的 `_output` 文件夹中 [^4]。 ### 使用技巧 - **环境变量**：可以使用 `${ENV(key)}` 语法引用环境变量，这对于管理不同环境下的配置非常有用。 - **调试模式**：使用 `--log-level debug` 可以开启调试日志，有助于排查问题。 - **测试报告定制**：如果默认的测试报告不符合需求，还可以自定义模板 [^3]。 ### 注意事项 - 在使用 HttpRunner 时，请确保你的项目结构清晰，便于管理和维护测试用例。 - 对于复杂的业务逻辑，建议将公共部分抽象成组件或函数，以便重用 。