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.0.tar.gz
(90.0 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.0.tar.gz.
File metadata
- Download URL: har2pytest-1.4.0.tar.gz
- Upload date:
- Size: 90.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cd6428696fe330a9c877bd210f3f2276b85128aa49f26a72c46d4b03fb57dea9
|
|
| MD5 |
117b222ad63e9ed01ba62cd117084da0
|
|
| BLAKE2b-256 |
d8b808326a4e16a38ba5d5f04fe376c78825971798bbcd2f57ab9ff12fedc299
|
Provenance
The following attestation bundles were made for har2pytest-1.4.0.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.0.tar.gz -
Subject digest:
cd6428696fe330a9c877bd210f3f2276b85128aa49f26a72c46d4b03fb57dea9 - Sigstore transparency entry: 2256738837
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@2da320ab78914d7079953aae69829f55e87f06bd -
Branch / Tag:
refs/tags/v1.4.0 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2da320ab78914d7079953aae69829f55e87f06bd -
Trigger Event:
push
-
Statement type:
File details
Details for the file har2pytest-1.4.0-py3-none-any.whl.
File metadata
- Download URL: har2pytest-1.4.0-py3-none-any.whl
- Upload date:
- Size: 54.4 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 |
b8d72dbb5bd545ce136834dd6ac3ff676f2fabd32831be9eacdabd8c4955ebb9
|
|
| MD5 |
e1a3e1ba4ec21ae5651139e88ef2296f
|
|
| BLAKE2b-256 |
cdb6f8d32fbf71b2bf59c986af1c437965974b1942c970d6ab42f8ff45bc1c18
|
Provenance
The following attestation bundles were made for har2pytest-1.4.0-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.0-py3-none-any.whl -
Subject digest:
b8d72dbb5bd545ce136834dd6ac3ff676f2fabd32831be9eacdabd8c4955ebb9 - Sigstore transparency entry: 2256738843
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@2da320ab78914d7079953aae69829f55e87f06bd -
Branch / Tag:
refs/tags/v1.4.0 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2da320ab78914d7079953aae69829f55e87f06bd -
Trigger Event:
push
-
Statement type:
