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.2.tar.gz
(90.8 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.2.tar.gz.
File metadata
- Download URL: har2pytest-1.4.2.tar.gz
- Upload date:
- Size: 90.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4f3e8d7989719017b46b0f2fce2255c4c1b988d4eca2b1496a7490acc4d1d258
|
|
| MD5 |
9b6edbe88391257fccae84f777b70fa3
|
|
| BLAKE2b-256 |
f4ec9316743ff49b65b82bb097965906086facbc45fcd859f3aca5c0bb38ed14
|
Provenance
The following attestation bundles were made for har2pytest-1.4.2.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.2.tar.gz -
Subject digest:
4f3e8d7989719017b46b0f2fce2255c4c1b988d4eca2b1496a7490acc4d1d258 - Sigstore transparency entry: 2269657733
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@4232152580cc151901582a0de7f7bc431ba94e03 -
Branch / Tag:
refs/tags/v1.4.2 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@4232152580cc151901582a0de7f7bc431ba94e03 -
Trigger Event:
push
-
Statement type:
File details
Details for the file har2pytest-1.4.2-py3-none-any.whl.
File metadata
- Download URL: har2pytest-1.4.2-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 |
347206c41da80f228816345bbd4333229d1fc6dbc08197fd19deb58077739ca8
|
|
| MD5 |
d9e6298bd6683b4bf20d4470fc5eb7c2
|
|
| BLAKE2b-256 |
2aef70b89651e46e244c2c6709bcd11995a520e1f3c7d4f018c437ea0e9308c8
|
Provenance
The following attestation bundles were made for har2pytest-1.4.2-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.2-py3-none-any.whl -
Subject digest:
347206c41da80f228816345bbd4333229d1fc6dbc08197fd19deb58077739ca8 - Sigstore transparency entry: 2269658118
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@4232152580cc151901582a0de7f7bc431ba94e03 -
Branch / Tag:
refs/tags/v1.4.2 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@4232152580cc151901582a0de7f7bc431ba94e03 -
Trigger Event:
push
-
Statement type:
