har2pytest
从 HAR 抓包文件和 Swagger 文档生成 Python API 接口文件，并自动生成 pytest + allure 参数化测试用例的 CLI 工具。
安装
pip install har2pytest
验证安装：
har2pytest --help
快速开始
1. 从 HAR 文件生成 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
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 文件生成
│ ├── 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.2.0.tar.gz
(78.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.2.0.tar.gz.
File metadata
- Download URL: har2pytest-1.2.0.tar.gz
- Upload date:
- Size: 78.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5fbeb6339780aa340b5b635381b7a337c5a3bfff3504d13f52cc420557bc128c
|
|
| MD5 |
93f8a45490c5cb1603be37a1e19a07f6
|
|
| BLAKE2b-256 |
6f0bfe7e8d57b66c917f4dfea5fd8b0b24b8c825cc068d44daad34c3c90b4647
|
Provenance
The following attestation bundles were made for har2pytest-1.2.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.2.0.tar.gz -
Subject digest:
5fbeb6339780aa340b5b635381b7a337c5a3bfff3504d13f52cc420557bc128c - Sigstore transparency entry: 2029619213
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@b3685f5c28d404c69d79c3b64febd66c24ee5927 -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@b3685f5c28d404c69d79c3b64febd66c24ee5927 -
Trigger Event:
push
-
Statement type:
File details
Details for the file har2pytest-1.2.0-py3-none-any.whl.
File metadata
- Download URL: har2pytest-1.2.0-py3-none-any.whl
- Upload date:
- Size: 48.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d0d8cb83edc72233d5fa5a2c0525e84b0d355f873a9a9d01d1f16505ec59b42f
|
|
| MD5 |
431a354a1055d770147ae9eb64bcaa62
|
|
| BLAKE2b-256 |
1f4166d4ba8cbf7c130d58a639166b8c7a410aba1337fa2d182593921b77eb30
|
Provenance
The following attestation bundles were made for har2pytest-1.2.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.2.0-py3-none-any.whl -
Subject digest:
d0d8cb83edc72233d5fa5a2c0525e84b0d355f873a9a9d01d1f16505ec59b42f - Sigstore transparency entry: 2029619400
- Sigstore integration time:
-
Permalink:
hewei198711/har2pytest@b3685f5c28d404c69d79c3b64febd66c24ee5927 -
Branch / Tag:
refs/tags/v1.2.0 - Owner: https://github.com/hewei198711
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@b3685f5c28d404c69d79c3b64febd66c24ee5927 -
Trigger Event:
push
-
Statement type:
