har2pytest 1.0.0

从HAR文件，Swagger接口文档自动生成API接口文件和pytest+allure测试用例

har2pytest

从 HAR 文件和 Swagger 文档生成 Python API 接口文件，并自动生成 pytest + allure 测试用例的工具。

安装

pip install -e .

验证安装：

har2pytest help

快速开始

1. 从 HAR 文件生成 API 文件

har2pytest api api_request.har

2. 从 Swagger 文档生成 API 文件

har2pytest swagger https://petstore.swagger.io/v2/api-docs

3. 生成测试用例

# 查询类参数化测试
har2pytest testcase api_request.har --pattern list_query --url /api/user/list

# 复杂场景流程测试
har2pytest testcase api_request.har --pattern complex_scenario --url /api/user/login

# 批量生成（无需 HAR 文件）
har2pytest testcase --pattern batch --api-files apis/mobile_application/_mobile_user_list.py

4. 查看 HAR 文件摘要

har2pytest summary api_request.har

详细文档

文档	说明
API 文件生成	从 HAR / Swagger 生成 API 文件的详细说明
HAR 文件解析	HAR 解析规则与参数过滤
Swagger 文档解析	Swagger 文档获取与参数提取
测试用例生成模式	list_query / complex_scenario / batch 三种模式详解

配置

在项目根目录创建 har2pytest_config.json 自定义配置。配置项详见 APIConfig 类（config.py）。

项目结构

har2pytest/
├── har2pytest/              # 核心代码
│   ├── __init__.py
│   ├── __main__.py          # CLI 入口
│   ├── config.py            # 配置管理 (APIConfig)
│   ├── har_parser.py        # HAR 文件解析 (HARParser)
│   ├── har_generator.py     # HAR → API 文件生成 (HARGenerator)
│   ├── api_generator.py     # API 文件生成 (APIGenerator)
│   ├── swagger_handler.py   # Swagger 文档处理 (SwaggerHandler)
│   ├── testcase_generator.py # 测试用例生成 (TestCaseGenerator)
│   └── utils.py             # 工具函数
├── docs/                    # 详细文档
├── tests/                   # 单元测试
└── har2pytest_config.json.example  # 配置示例