HTTPRunne

HTTPRunner是一种单元测试工具，由于教学的需求，我学习了它，但是我觉得它比Python的Requests类相差太远。作为一个比较流行的工具在这里进行介绍。

 

1，原理

HttpRunner 是一款开源的 API 测试工具，兼容 HTTP(S)、HTTP2、WebSocket、RPC 等多种网络协议，支持接口测试、性能测试、数字体验监测等多种测试类型。它操作简便，功能全面，拥有丰富的插件系统和卓越的扩展性。

 

 

功能特点：

1. 全面支持网络协议：不仅完整支持 HTTP(S)/1.1 和 HTTP/2，还能灵活扩展至 WebSocket、TCP、RPC 等多种协议。

2. 多样化的测试用例格式：支持 YAML、JSON、go test、pytest 等多种格式，且可轻松实现格式之间的转换。

3. 双重执行引擎：集成了 golang 和 python 两种执行引擎，既保证了go 的高效性能，也享受了 pytest 丰富的生态系统。

4. 便捷的用例生成方式：支持通过 HAR、Postman、Swagger、curl 等工具生成测试用例，同时提供基于链式调用的编写方法，简化测试用例的编写过程。    

5. 应对复杂测试场景：借助 variables、extract、validate、hooks 等机制，轻松构建复杂的测试场景。

6. 插件化扩展：内置了丰富的函数库，并支持使用 go、python、java 等主流编程语言编写自定义函数，轻松扩展更多功能。

7. 高效的性能测试：无需额外设置即可进行压力测试，单机轻松支持超过1万 VUM，配合分布式负载能力，可实现大规模压力测试。

8. 网络性能监测：在进行场景化接口测试的同时，还能额外监测网络链路的性能指标，如 DNS 解析、TCP 连接、SSL 握手、网络传输等。

9. 一键快速部署：通过二进制命令行工具分发，无需依赖特定环境，一条命令即可在 macOS、Linux、Windows 上迅速完成安装部署。

官方网址：https://httprunner.com/

2，安装

1）使用pip安装

pip install httprunner

2）安装hrp命令

GitHub上下载安装包：https://github.com/httprunner/httprunner/releases

选择合适的安装包

 

3）下载完成后，进行解压，加入全局变量中

 

3 使用

1）在工作目录中，终端执行命令，创建ebusiness项目

 hrp startproject ebusiness  

 

目录结构：

• har 录制的文件目录

• results 报告目录

• testcases 测试用例目录

• .env 环境配置文件

• .gitignore 传git仓库时忽略文件

• debugtalk.py 辅助函数功能文件

• proj.json 记录创建项目的信息

2）修改.env 环境配置文件

 base_url=http://192.168.31.57:8000/ 

base_url为测试所需要的根目录

3）在testcases目录中建立测试用例test_ebusiness.yml。（在testcases目录下有多个示例用例，您可以删除）

#表示下面为配置段
config:
    #测试主标题
name: 测试电子商务模块
#定义全局变量
variables:
   #基础的URL
       base_url:  "http://127.0.0.1:8000"
                     
#表示下面为测试用例段
teststeps:
-
    #定义此用例名称
    name: 登录首页
    #请求参数
    request:
    #请求方法
        method: GET
        #URL地址
        url: $base_url
    #提取响应的数据并存储到变量中
    extract:  
     #获取名为csrftoken的cookier参数
         - csrftoken: cookies.csrftoken 
     validate:
     #验证返回码是200
         - eq: ["status_code", 200]
-
    #定义此用例名称
    name: 登录验证
    #定义变量     
    variables:
    #定义用户名
        username: "cindy"
        #定义密码，密码经过SHA256散列
        password: "8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92"
    #请求参数
    request:
        #请求方法
        method: POST
        #URL地址
         url: $base_url/login_action/
         #定义cookies参数
         with_cookies:
           csrftoken: $csrftoken
         #定义头
         headers:
            X-CSRFToken: "$csrftoken" 
         #定义请求参数
         data:  
            username: $ username      
            password: $ password  
            csrfmiddlewaretoken: "$csrftoken"
     validate:
          validate:
          #验证返回码是200
          - eq: ["status_code", 200]
          - eq: [url, $base_url/goods_view/]
          - eq: [encoding, utf-8] 
          - eq: [reason, OK]

 

HttpRunner 的测试用例由两个核心部分构成：

配置（config）：这是测试用例的共享配置环节，涵盖了诸如用例名称、基础 URL、参数化数据源以及是否启用 SSL 验证等设置。

 

测试步骤（teststeps）：这部分是一系列有序的操作步骤，其设计理念借鉴了 go interface，能够灵活支持各种协议和测试类型的扩展，甚至包括用户界面（UI）自动化测试。每个 step 都是一个 HTTP 请求，描述信息仅包含了 HTTP 请求和结果校验的核心要素。

变量的定义在step或config的variables中。

运行成功，产生pytest格式的python文件。

# NOTE: Generated By HttpRunner v4.3.5
# FROM: .\testcases\test_ebusiness.yml
from httprunner import HttpRunner, Config, Step, RunRequest
class TestCaseTestEbusiness(HttpRunner):
    config = Config("测试电子商务模块").variables(**{"base_url": "http://127.0.0.1:8000"})    
    teststeps = [
        Step(
            RunRequest("登录首页")
            .get("$base_url")
            .extract()
            .with_jmespath("cookies.csrftoken", "csrftoken")
            .validate()
            .assert_equal("status_code", 200)
        ),
        Step(
            RunRequest("登录成功，进入商品页面")
            .with_variables(
                **{
                    "username": "cindy",
                    "password": "8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92",
                }
            )
            .post("$base_url/login_action/")
            .with_headers(**{"X-CSRFToken": "$csrftoken"})
            .with_data(    
                {
                    "username": "$username",
                    "password": "$password",
                    "csrfmiddlewaretoken": "$csrftoken",
                }
            )
            .validate()
            .assert_equal("status_code", 200)
            .assert_equal("url", "$base_url/goods_view/")
            .assert_equal("encoding", "utf-8")
            .assert_equal("reason", "OK")
        ),
    ]
if __name__ == "__main__":
TestCaseTestEbusiness().test_start()

可以通过pytest来运行这个测试用例

另：网上说可以通过

 hrp run testcases/test_demo.yml --gen-html-report 

 

运行，并且产生测试报告

hrp boom testcases/test_demo.yml --spawn-count 10 --spawn-rate 2

 

运行性能测试

我没有实现，据说要连接到google上    

Httprunner测试用例可以用yam来写，也可以用json来写。