har2pytest 1.0.0__tar.gz

har2pytest-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hewei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

har2pytest-1.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

har2pytest-1.0.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: har2pytest
+Version: 1.0.0
+Summary: 从HAR文件，Swagger接口文档自动生成API接口文件和pytest+allure测试用例
+Author-email: hewei <hewei1987@163.com>
+License-Expression: MIT
+Project-URL: homepage, https://github.com/hewei198711/har2pytest
+Project-URL: repository, https://github.com/hewei198711/har2pytest
+Keywords: har,swagger,pytest,allure,api,testcase
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: allure-pytest==2.15.3
+Requires-Dist: allure-python-commons==2.15.3
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# har2pytest
+
+从 HAR 文件和 Swagger 文档生成 Python API 接口文件，并自动生成 pytest + allure 测试用例的工具。
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+验证安装：
+
+```bash
+har2pytest help
+```
+
+## 快速开始
+
+### 1. 从 HAR 文件生成 API 文件
+
+```bash
+har2pytest api api_request.har
+```
+
+### 2. 从 Swagger 文档生成 API 文件
+
+```bash
+har2pytest swagger https://petstore.swagger.io/v2/api-docs
+```
+
+### 3. 生成测试用例
+
+```bash
+# 查询类参数化测试
+har2pytest testcase api_request.har --pattern list_query --url /api/user/list
+
+# 复杂场景流程测试
+har2pytest testcase api_request.har --pattern complex_scenario --url /api/user/login
+
+# 批量生成（无需 HAR 文件）
+har2pytest testcase --pattern batch --api-files apis/mobile_application/_mobile_user_list.py
+```
+
+### 4. 查看 HAR 文件摘要
+
+```bash
+har2pytest summary api_request.har
+```
+
+## 详细文档
+
+| 文档 | 说明 |
+|------|------|
+| [API 文件生成](docs/api_file_generation.md) | 从 HAR / Swagger 生成 API 文件的详细说明 |
+| [HAR 文件解析](docs/har_file_parsing.md) | HAR 解析规则与参数过滤 |
+| [Swagger 文档解析](docs/swagger_document_parsing.md) | Swagger 文档获取与参数提取 |
+| [测试用例生成模式](docs/testcase_generation_modes.md) | list_query / complex_scenario / batch 三种模式详解 |
+
+## 配置
+
+在项目根目录创建 `har2pytest_config.json` 自定义配置。配置项详见 `APIConfig` 类（[config.py](har2pytest/config.py)）。
+
+## 项目结构
+
+```
+har2pytest/
+├── har2pytest/              # 核心代码
+│   ├── __init__.py
+│   ├── __main__.py          # CLI 入口
+│   ├── config.py            # 配置管理 (APIConfig)
+│   ├── har_parser.py        # HAR 文件解析 (HARParser)
+│   ├── har_generator.py     # HAR → API 文件生成 (HARGenerator)
+│   ├── api_generator.py     # API 文件生成 (APIGenerator)
+│   ├── swagger_handler.py   # Swagger 文档处理 (SwaggerHandler)
+│   ├── testcase_generator.py # 测试用例生成 (TestCaseGenerator)
+│   └── utils.py             # 工具函数
+├── docs/                    # 详细文档
+├── tests/                   # 单元测试
+└── har2pytest_config.json.example  # 配置示例
+```

har2pytest-1.0.0/README.md

@@ -0,0 +1,80 @@
+# har2pytest
+
+从 HAR 文件和 Swagger 文档生成 Python API 接口文件，并自动生成 pytest + allure 测试用例的工具。
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+验证安装：
+
+```bash
+har2pytest help
+```
+
+## 快速开始
+
+### 1. 从 HAR 文件生成 API 文件
+
+```bash
+har2pytest api api_request.har
+```
+
+### 2. 从 Swagger 文档生成 API 文件
+
+```bash
+har2pytest swagger https://petstore.swagger.io/v2/api-docs
+```
+
+### 3. 生成测试用例
+
+```bash
+# 查询类参数化测试
+har2pytest testcase api_request.har --pattern list_query --url /api/user/list
+
+# 复杂场景流程测试
+har2pytest testcase api_request.har --pattern complex_scenario --url /api/user/login
+
+# 批量生成（无需 HAR 文件）
+har2pytest testcase --pattern batch --api-files apis/mobile_application/_mobile_user_list.py
+```
+
+### 4. 查看 HAR 文件摘要
+
+```bash
+har2pytest summary api_request.har
+```
+
+## 详细文档
+
+| 文档 | 说明 |
+|------|------|
+| [API 文件生成](docs/api_file_generation.md) | 从 HAR / Swagger 生成 API 文件的详细说明 |
+| [HAR 文件解析](docs/har_file_parsing.md) | HAR 解析规则与参数过滤 |
+| [Swagger 文档解析](docs/swagger_document_parsing.md) | Swagger 文档获取与参数提取 |
+| [测试用例生成模式](docs/testcase_generation_modes.md) | list_query / complex_scenario / batch 三种模式详解 |
+
+## 配置
+
+在项目根目录创建 `har2pytest_config.json` 自定义配置。配置项详见 `APIConfig` 类（[config.py](har2pytest/config.py)）。
+
+## 项目结构
+
+```
+har2pytest/
+├── har2pytest/              # 核心代码
+│   ├── __init__.py
+│   ├── __main__.py          # CLI 入口
+│   ├── config.py            # 配置管理 (APIConfig)
+│   ├── har_parser.py        # HAR 文件解析 (HARParser)
+│   ├── har_generator.py     # HAR → API 文件生成 (HARGenerator)
+│   ├── api_generator.py     # API 文件生成 (APIGenerator)
+│   ├── swagger_handler.py   # Swagger 文档处理 (SwaggerHandler)
+│   ├── testcase_generator.py # 测试用例生成 (TestCaseGenerator)
+│   └── utils.py             # 工具函数
+├── docs/                    # 详细文档
+├── tests/                   # 单元测试
+└── har2pytest_config.json.example  # 配置示例
+```

har2pytest-1.0.0/har2pytest/__init__.py

@@ -0,0 +1,36 @@
+"""
+API工具包 - 用于从HAR文件生成API接口和测试用例
+
+主要功能：
+1. HAR文件解析
+2. API文件生成
+3. 测试用例生成
+4. Swagger文档更新
+"""
+
+from .api_generator import APIGenerator
+from .config import APIConfig
+from .har_parser import HARParser
+from .logger import get_logger, logger
+from .swagger_handler import SwaggerHandler
+from .testcase_generator import TestCaseGenerator
+from .utils import (
+    format_headers_for_python,
+    format_parameter_value,
+    format_params_for_python,
+    parse_api_file,
+)
+
+__all__ = [
+    "APIConfig",
+    "HARParser",
+    "APIGenerator",
+    "TestCaseGenerator",
+    "SwaggerHandler",
+    "get_logger",
+    "logger",
+    "parse_api_file",
+    "format_parameter_value",
+    "format_headers_for_python",
+    "format_params_for_python",
+]

har2pytest-1.0.0/har2pytest/__main__.py

@@ -0,0 +1,294 @@
+"""
+har2pytest 命令行入口
+"""
+
+import argparse
+import asyncio
+
+from .api_generator import APIGenerator
+from .config import APIConfig
+from .har_generator import generate_api_files_from_har
+from .har_parser import HARParser
+from .logger import logger
+from .swagger_handler import SwaggerHandler
+from .testcase_generator import TestCaseGenerator
+
+
+def main():
+    """
+    主函数 - 支持多种命令行操作模式
+    """
+    # 初始化配置（通过 get_config 触发，会自动缓存）
+    APIConfig.get_config("BASE_URLS")
+
+    # 创建主解析器
+    parser = argparse.ArgumentParser(
+        prog="har2pytest",
+        description="har2pytest - HAR文件转pytest测试用例工具",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""示例用法:
+  # 从HAR文件生成API接口文件
+  har2pytest api api_request.har --output apis
+
+  # 从Swagger文档生成API接口文件
+  har2pytest swagger https://petstore.swagger.io/v2/api-docs
+
+  # 查看HAR文件摘要
+  har2pytest summary api_request.har
+
+  # 生成参数化测试用例
+  har2pytest testcase api_request.har --pattern list_query --mark test_4291
+
+  # 生成复杂场景测试用例
+  har2pytest testcase api_request.har --pattern complex_scenario --url /api/user/login --mark test_4295
+
+  # 批量生成测试用例
+  har2pytest testcase --pattern batch --api-files apis/mall_mobile_application --mark test_4295
+""",
+    )
+
+    # 创建子命令解析器
+    subparsers = parser.add_subparsers(dest="command", help="可用命令")
+
+    # api 子命令
+    api_parser = subparsers.add_parser("api", help="从HAR文件生成API接口文件", description="从HAR文件生成API接口文件")
+    api_parser.add_argument("har_file", nargs="?", default="api_request.har", help="HAR文件路径")
+    api_parser.add_argument("--output", "-o", default=APIConfig.DEFAULT_API_DIR(), help="输出目录")
+    api_parser.add_argument("--overwrite", "-f", action="store_true", help="强制覆盖现有文件")
+
+    # summary 子命令
+    sum_parser = subparsers.add_parser(
+        "summary", help="显示HAR文件的API请求摘要", description="显示HAR文件的API请求摘要"
+    )
+    sum_parser.add_argument("har_file", help="HAR文件路径")
+
+    # testcase 子命令
+    tc_parser = subparsers.add_parser(
+        "testcase",
+        help="生成测试用例",
+        description="从HAR文件生成pytest测试用例",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""示例用法:
+  # 生成查询类参数化测试用例（不传mark）
+  har2pytest testcase api_request.har --pattern list_query
+
+  # 生成查询类参数化测试用例（传mark）
+  har2pytest testcase api_request.har --pattern list_query --mark test_4291
+
+  # 生成复杂场景测试用例（不传mark）
+  har2pytest testcase api_request.har --pattern complex_scenario --url /api/user/login
+
+  # 生成复杂场景测试用例（传mark）
+  har2pytest testcase api_request.har --pattern complex_scenario --url /api/user/login --mark test_4295
+""",
+    )
+    tc_parser.add_argument("har_file", nargs="?", default=None, help="HAR文件路径（batch模式不需要）")
+    tc_parser.add_argument(
+        "--pattern",
+        default="list_query",
+        choices=["list_query", "complex_scenario", "batch"],
+        help="测试用例模式: list_query(查询类参数化)、complex_scenario(复杂场景) 或 batch(批量生成)",
+    )
+    tc_parser.add_argument("--mark", "-m", help="测试标记（如 test_4291）")
+    tc_parser.add_argument("--url", "-u", help="目标接口URL（可选，指定后只生成该接口的测试用例）")
+    tc_parser.add_argument("--output", "-o", default="testcases", help="输出目录")
+    tc_parser.add_argument("--api-dir", default="apis", help="API文件目录")
+    tc_parser.add_argument("--api-files", help="指定API文件集合（batch模式使用，多个文件用逗号分隔）")
+
+    # swagger 子命令
+    swagger_parser = subparsers.add_parser(
+        "swagger",
+        help="从Swagger文档生成API接口文件",
+        description="从Swagger文档生成API接口文件",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""示例用法:
+  # 从Swagger文档生成所有API文件
+  har2pytest swagger https://petstore.swagger.io/v2/api-docs
+
+  # 从Swagger文档生成API文件，指定输出目录
+  har2pytest swagger https://petstore.swagger.io/v2/api-docs --output apis
+
+  # 从Swagger文档生成API文件，强制覆盖
+  har2pytest swagger https://petstore.swagger.io/v2/api-docs --overwrite
+
+  # 从Swagger文档生成指定路径的API文件
+  har2pytest swagger https://petstore.swagger.io/v2/api-docs --path /pet/{petId}
+""",
+    )
+    swagger_parser.add_argument("swagger_url", help="Swagger文档URL")
+    swagger_parser.add_argument("--output", "-o", default=APIConfig.DEFAULT_API_DIR(), help="输出目录")
+    swagger_parser.add_argument("--overwrite", "-f", action="store_true", help="强制覆盖现有文件")
+    swagger_parser.add_argument("--path", "-p", help="只生成指定的API路径（如 /pet/{petId}）")
+
+    # 解析参数
+    args = parser.parse_args()
+
+    # 如果没有指定命令，默认使用 api 命令
+    if args.command is None:
+        args.command = "api"
+
+    # 执行对应的命令
+    if args.command == "api":
+        asyncio.run(handle_api(args))
+    elif args.command == "summary":
+        handle_summary(args)
+    elif args.command == "testcase":
+        asyncio.run(handle_testcase(args))
+    elif args.command == "swagger":
+        asyncio.run(handle_swagger(args))
+    elif args.command == "help":
+        parser.print_help()
+    else:
+        logger.error(f"未知命令: {args.command}")
+        parser.print_help()
+
+
+async def handle_api(args):
+    """处理 api 命令"""
+    har_file = args.har_file
+    output_dir = args.output
+    force_overwrite = args.overwrite
+
+    logger.info(f"从HAR文件生成API接口文件: {har_file}")
+    logger.info(f"输出目录: {output_dir}")
+    logger.info(f"强制覆盖: {force_overwrite}")
+    logger.info("-" * 50)
+
+    api_generator = APIGenerator(output_dir)
+    generated_files = await generate_api_files_from_har(
+        har_file, force_overwrite=force_overwrite, api_generator=api_generator
+    )
+
+    logger.info("-" * 50)
+    logger.info(f"共生成 {len(generated_files)} 个API接口文件")
+
+    if generated_files:
+        api_generator.generate_index_file(generated_files)
+
+
+def handle_summary(args):
+    """处理 summary 命令"""
+    har_file = args.har_file
+
+    parser = HARParser()
+    parser.print_api_summary(har_file)
+
+
+async def handle_swagger(args):
+    """处理 swagger 命令"""
+    swagger_url = args.swagger_url
+    output_dir = args.output
+    force_overwrite = args.overwrite
+    specific_path = args.path
+
+    logger.info(f"从Swagger文档生成API接口文件: {swagger_url}")
+    logger.info(f"输出目录: {output_dir}")
+    logger.info(f"强制覆盖: {force_overwrite}")
+    if specific_path:
+        logger.info(f"只生成指定路径: {specific_path}")
+    logger.info("-" * 50)
+
+    api_generator = APIGenerator(output_dir)
+    swagger_handler = SwaggerHandler(api_generator=api_generator)
+    generated_files = await swagger_handler.generate_apis_from_swagger(swagger_url, force_overwrite, specific_path)
+
+    logger.info("-" * 50)
+    logger.info(f"共生成 {len(generated_files)} 个API接口文件")
+
+    if generated_files:
+        api_generator.generate_index_file(generated_files)
+
+
+async def handle_testcase(args):
+    """处理 testcase 命令"""
+    har_file = args.har_file
+    pattern = args.pattern
+    task_id = args.mark
+    target_url = args.url
+    output_dir = args.output
+    api_dir = args.api_dir
+
+    if pattern == "list_query":
+        # 验证必填参数
+        if not har_file:
+            logger.error("错误: list_query 模式必须指定 HAR 文件")
+            logger.error("使用示例: har2pytest testcase api.har --pattern list_query --url /api/user/list")
+            return
+        if not target_url:
+            logger.error("错误: list_query 模式必须指定 --url 参数")
+            logger.error("使用示例: har2pytest testcase api.har --pattern list_query --url /api/user/list")
+            return
+
+        logger.info(f"生成查询类参数化测试用例: {har_file}")
+        logger.info(f"任务ID: {task_id}")
+        logger.info(f"目标接口: {target_url}")
+        logger.info("-" * 50)
+
+        generator = TestCaseGenerator(api_dir=api_dir, output_dir=output_dir)
+        test_files = generator.generate_parametrized_list_testcases(har_file, task_id, target_url)
+
+        logger.info("-" * 50)
+        if test_files:
+            logger.info(f"成功生成 {len(test_files)} 个测试用例文件:")
+            for test_file in test_files:
+                logger.info(f"  - {test_file}")
+        else:
+            logger.info("生成测试用例文件失败")
+
+    elif pattern == "complex_scenario":
+        # 验证必填参数
+        if not har_file:
+            logger.error("错误: complex_scenario 模式必须指定 HAR 文件")
+            logger.error("使用示例: har2pytest testcase api.har --pattern complex_scenario --url /api/user/login")
+            return
+        if not target_url:
+            logger.error("错误: complex_scenario 模式必须指定 --url 参数")
+            logger.error("使用示例: har2pytest testcase api.har --pattern complex_scenario --url /api/user/login")
+            return
+
+        logger.info(f"生成复杂场景测试用例: {har_file}")
+        logger.info(f"任务ID: {task_id}")
+        logger.info(f"目标接口: {target_url}")
+        logger.info("-" * 50)
+
+        generator = TestCaseGenerator(api_dir=api_dir, output_dir=output_dir)
+        test_file = generator.generate_scenario_testcase(har_file, target_url, task_id)
+
+        logger.info("-" * 50)
+        if test_file:
+            logger.info(f"成功生成测试用例文件: {test_file.replace('\\', '/')}")
+        else:
+            logger.info("生成测试用例文件失败")
+
+    elif pattern == "batch":
+        # batch 模式：批量生成测试用例（直接从API文件读取参数）
+        api_files_arg = args.api_files
+        if not api_files_arg:
+            logger.error("错误: batch 模式必须指定 --api-files 参数")
+            logger.error("使用示例: har2pytest testcase --pattern batch --api-files apis/mall_mgmt_application/_mgmt_prmt_luckyActivity_luckyActivityList.py")
+            return
+
+        # 解析 API 文件列表（支持逗号分隔）
+        api_files_list = [f.strip() for f in api_files_arg.split(",")]
+
+        logger.info("批量生成测试用例（从API文件读取参数）")
+        logger.info(f"API文件数量: {len(api_files_list)}")
+        logger.info(f"任务ID: {task_id}")
+        logger.info("-" * 50)
+
+        generator = TestCaseGenerator(api_dir=api_dir, output_dir=output_dir)
+        result = await generator.generate_batch_testcases(api_files_list, task_id)
+
+        logger.info("-" * 50)
+        logger.info(f"总API文件数: {result['total']}")
+        logger.info(f"跳过（已存在）: {result['skipped']}")
+        logger.info(f"成功生成: {result['generated']}")
+        logger.info(f"失败: {result['failed']}")
+        if result["generated_files"]:
+            logger.info("生成的文件:")
+            for f in result["generated_files"]:
+                logger.info(f"  - {f.replace('\\', '/')}")
+
+
+if __name__ == "__main__":
+    main()