har2pytest

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

安装

pip install har2pytest

验证安装：

har2pytest --help

快速开始

1. 从 HAR 文件生成 API 文件

# 同步模式（默认，使用 requests）
har2pytest api api_request.har

# 异步模式（使用 aiohttp + async/await）
har2pytest api api_request.har --async

2. 从 Swagger 文档生成 API 文件

# 同步模式
har2pytest swagger https://petstore.swagger.io/v2/api-docs

# 异步模式
har2pytest swagger https://petstore.swagger.io/v2/api-docs --async

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 测试代码，适用于所有模式）
har2pytest testcase api_request.har --pattern list_query --url /api/user/list --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               # 文档站点配置

Project links

Data verified by PyPI on Jul 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.5.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for hewei from gravatar.com hewei

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: hewei

GitHub Statistics

Data verified by PyPI on Jul 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Tags

har swagger pytest allure api testcase

Classifiers

Report project as malware

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.3.1.tar.gz (88.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

har2pytest-1.3.1-py3-none-any.whl (53.5 kB view details)

Uploaded Python 3

File details

Details for the file har2pytest-1.3.1.tar.gz.

File metadata

  • Download URL: har2pytest-1.3.1.tar.gz
  • Upload date:
  • Size: 88.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for har2pytest-1.3.1.tar.gz
Algorithm Hash digest
SHA256 63f448a9bc20260954a91455cdd65f660a8b1f25cd477ba351138c86906ab088
MD5 6487c3f12f52b411c9c3a29c2f3a20bf
BLAKE2b-256 f722b274f3fcf8ed76518b466b1d4b462e2cfc02f65ce3e729b0fc0e020ebe98

See more details on using hashes here.

Provenance

The following attestation bundles were made for har2pytest-1.3.1.tar.gz:

Publisher: publish.yml on hewei198711/har2pytest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file har2pytest-1.3.1-py3-none-any.whl.

File metadata

  • Download URL: har2pytest-1.3.1-py3-none-any.whl
  • Upload date:
  • Size: 53.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for har2pytest-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c3654cf4f00aff1111c89c284d8fd660f6957b7d7f73bc896d00a2b4c452b497
MD5 b933d74af842c6758d2051ba0ff06fb6
BLAKE2b-256 3981abd7f4a5ef8a6f81c30a2b0592076583492d17090f2762463ef69cae9219

See more details on using hashes here.

Provenance

The following attestation bundles were made for har2pytest-1.3.1-py3-none-any.whl:

Publisher: publish.yml on hewei198711/har2pytest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page