har2pytest
从 HAR 抓包文件和 Swagger 文档生成 Python API 接口文件，并自动生成 pytest + allure 参数化测试用例的 CLI 工具。
安装
pip install har2pytest
验证安装：
har2pytest --help
快速开始
1. 从 HAR 文件生成 API 文件
# 生成 API 文件（同步/异步统一，运行时自动适配）
har2pytest api api_request.har
2. 从 Swagger 文档生成 API 文件
har2pytest swagger https://petstore.swagger.io/v2/api-docs
3. 生成测试用例
# 查询类参数化测试（指定 URL）
har2pytest testcase api_request.har --pattern list_query --url /api/user/list
# 查询类参数化测试（带 task_id 标记）
har2pytest testcase api_request.har --pattern list_query --url /api/user/list --mark test_4291
# 复杂场景流程测试
har2pytest testcase api_request.har --pattern complex_scenario --url /api/user/login
# 批量生成（指定 API 文件目录）
har2pytest testcase --pattern batch --api-files apis/mobile_application
# 批量生成（指定 HAR 文件，自动提取接口并匹配 API 文件）
har2pytest testcase --pattern batch --api-files api_request.har
# 强制覆盖已存在的测试用例文件
har2pytest testcase api_request.har --pattern list_query --url /api/user/list --overwrite
# 异步模式测试用例（生成 async/await 代码，自动切换为 async_client）
har2pytest testcase api_request.har --pattern list_query --url /api/user/list --async --output testcases_async
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 入口
│ ├── client.py # HTTP 客户端 (Client, AsyncClient)
│ ├── config.py # 配置管理 (APIConfig)
│ ├── har_parser.py # HAR 文件解析 (HARParser)
│ ├── har_generator.py # HAR → API 文件生成
│ ├── api_generator.py # API 文件生成 (APIGenerator)
│ ├── swagger_handler.py # Swagger 文档处理 (SwaggerHandler)
│ ├── testcase_generator.py # 测试用例生成 (TestCaseGenerator)
│ ├── url_matcher.py # URL 规范化与匹配 (URLMatcher)
│ ├── utils.py # 工具函数
│ └── logger.py # 日志配置
├── docs/ # 详细文档
├── tests/ # 单元测试
│ └── har2pytest_config_test.json # 测试配置示例
├── pyproject.toml # 项目配置
└── mkdocs.yml # 文档站点配置
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
har2pytest-1.4.1.tar.gz
(90.7 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file har2pytest-1.4.1.tar.gz.
File metadata
- Download URL: har2pytest-1.4.1.tar.gz
- Upload date:
- Size: 90.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0338519c7899a80c0883d7e0af3920f13a92083846fe9fae6e06b68833ff05e5
|
|
| MD5 |
5726922f4003c81fd260c95f8621cdcd
|
|
| BLAKE2b-256 |
e13075ad4cc18a3868ea813d5d6fc78b3ffb31b37b312e1181ea9ffc6c490470
|
Provenance
The following attestation bundles were made for har2pytest-1.4.1.tar.gz:
Publisher:
publish.yml on hewei198711/har2pytest
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
har2pytest-1.4.1.tar.gz -
Subject digest:
0338519c7899a80c0883d7e0af3920f13a92083846fe9fae6e06b68833ff05e5 - Sigstore transparency entry: 2256738833
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@c4a1ce995a465db2bf96e79b75fe68eefae6f712 -
Branch / Tag:
refs/tags/v1.4.1 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c4a1ce995a465db2bf96e79b75fe68eefae6f712 -
Trigger Event:
push
-
Statement type:
File details
Details for the file har2pytest-1.4.1-py3-none-any.whl.
File metadata
- Download URL: har2pytest-1.4.1-py3-none-any.whl
- Upload date:
- Size: 55.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9a8e2c3a29e69482882e41ebc6cf5dc76818a1293bb3ca1c228c877443dfcf91
|
|
| MD5 |
d7775f81eba6a39977f37b0867fda9ee
|
|
| BLAKE2b-256 |
af290f1a1bf5c0ed37d0634b17218d7d887ef849e2f482da4c06cf8b762e6d3c
|
Provenance
The following attestation bundles were made for har2pytest-1.4.1-py3-none-any.whl:
Publisher:
publish.yml on hewei198711/har2pytest
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
har2pytest-1.4.1-py3-none-any.whl -
Subject digest:
9a8e2c3a29e69482882e41ebc6cf5dc76818a1293bb3ca1c228c877443dfcf91 - Sigstore transparency entry: 2256738838
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@c4a1ce995a465db2bf96e79b75fe68eefae6f712 -
Branch / Tag:
refs/tags/v1.4.1 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c4a1ce995a465db2bf96e79b75fe68eefae6f712 -
Trigger Event:
push
-
Statement type:
