使用教程:一步步教你安装与配置httprunner自动化框架

12 下载量 52 浏览量 更新于2024-08-30 收藏 358KB PDF 举报
"httprunner自动化框架入门教程" 本文将引导您逐步了解如何使用HttpRunner,一个轻量级的HTTP自动化测试框架,适用于接口测试。HttpRunner基于Python,易于上手,适合初学者进行接口测试工作。 ### 安装HttpRunner 安装HttpRunner需要先确保您的环境已安装Python,并且`pip`包管理器可用。查找Python的`Scripts`目录,例如`C:\Python\Python36\Scripts`。然后,打开命令行工具,如CMD,通过`cd`命令切换至`Scripts`目录。接着,输入以下命令来安装HttpRunner: ``` pip install httprunner ``` 安装完成后,验证安装是否成功,输入`hrun -V`,如果显示版本号,则表示安装成功。 ### 创建HttpRunner项目 使用以下命令创建一个新的HttpRunner项目,将`项目名称`替换为您实际的项目名: ``` hrun --startproject 项目名称 ``` 项目将在指定的Python环境下的`Scripts`目录下生成。建议避免在项目文件夹中使用中文名称,以防止可能出现的编码问题。 ### 接口测试准备 定义测试的API地址,例如:`https://gaokao.afanti100.com/university.html`。在项目的`api`文件夹内创建一个新的YAML文件,用于编写测试脚本。可以复制现有的`demo`文件并重命名为所需的名字。 ### 编写测试脚本 打开创建的YAML文件,如`linjiaxiaozhu.yml`,使用代码编辑器以避免格式错误。脚本的基本结构包括`config`、`test`和`validate`部分。 ```yaml config: name: 院校查询的接口集 request: base_url: https://gaokao.afanti100.com test: name: 查询中山大学 request: url: /api/v1/universities/ method: GET params: keyword: 中山大学 page: 1 validate: - eq: [status_code, 200] - eq: [content.meta.msg, "success"] ``` - `config`部分是全局配置,`name`字段用于描述整个测试集。 - `request`部分定义了HTTP请求的细节,包括基础URL、请求URL、方法(GET、POST等)、参数等。 - `test`部分包含了具体的测试用例,`name`字段表示用例名称,`request`字段下是请求设置,`params`用于传递查询参数。 - `validate`部分是断言,用于验证响应的状态码(`status_code`)和返回消息(`content.meta.msg`)是否符合预期。 ### 执行测试用例 在命令行中,定位到项目根目录,输入以下命令来执行测试脚本: ``` hrun C:\Python\Python36\Scripts\"linjiaxiaozhu.yml" ``` 执行命令后,HttpRunner将运行测试用例,并输出详细的测试报告,包括每个步骤的执行情况、响应结果以及断言验证。 总结,HttpRunner是一个强大的接口自动化测试工具,其简洁的YAML语法使得编写和维护测试用例变得轻松。通过以上步骤,您可以快速地搭建起一个HttpRunner项目,并开始进行接口测试。随着对框架的深入理解,可以利用其丰富的功能,如数据驱动、自定义断言等,进一步提升测试效率和质量。