df-test-framework 4.2.1__tar.gz → 4.2.2__tar.gz

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/CHANGELOG.md

@@ -5,6 +5,15 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [4.2.2] - 2026-04-15
+
+### 🔧 修复
+
+- **枚举类迁移至 `StrEnum`** (`core/types`, `infrastructure/config`, `capabilities`): 依赖升级后，将所有 `class Foo(str, Enum)` 统一改为 `class Foo(StrEnum)`，符合 Python 3.11+ 规范（UP042）
+- **脚手架模板 `{{}}` 残留** (`cli/templates/project`): 修复 `conftest.py`、`full_conftest.py`、`ui_conftest.py`、`async_example_api.py` 中 Jinja2 转义符残留导致生成文件包含 `{{}}` 错误字典字面量，实际应为 `{}`
+
+---
+
 ## [4.2.1] - 2026-04-15
 
 ### ✨ 新增功能

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/CLAUDE.md

@@ -8,8 +8,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **DF Test Framework** - 现代化 Python 测试自动化框架
 
-- **版本**: v4.2.0
-- **更新时间**: 2026-04-02
+- **版本**: v4.2.2
+- **更新时间**: 2026-04-15
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy
 - **架构**: 五层架构 + 横切关注点（能力层驱动设计）

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: df-test-framework
-Version: 4.2.1
+Version: 4.2.2
 Summary: 基于交互模式的现代化测试自动化框架，支持多种测试场景
 Project-URL: Homepage, https://github.com/yourorg/df-test-framework
 Project-URL: Repository, https://github.com/yourorg/df-test-framework
@@ -40,7 +40,7 @@ Requires-Dist: pymysql>=1.1.0
 Requires-Dist: pypinyin>=0.53.0
 Requires-Dist: pytest-asyncio>=1.3.0
 Requires-Dist: pytest-timeout>=2.2.0
-Requires-Dist: pytest>=9.0.1
+Requires-Dist: pytest==9.0.3
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: pyyaml>=6.0.0
 Requires-Dist: questionary>=2.0.0

df_test_framework-4.2.2/docs/releases/v4.2.2.md

@@ -0,0 +1,54 @@
+# v4.2.2 发布说明
+
+**发布日期**: 2026-04-15
+**类型**: Bug Fix
+
+---
+
+## 修复
+
+### 1. 枚举类迁移至 `StrEnum`
+
+**影响文件**:
+- `src/df_test_framework/core/types.py` — 10 个枚举类
+- `src/df_test_framework/infrastructure/config/middleware_schema.py` — 4 个枚举类
+- `src/df_test_framework/infrastructure/config/schema.py` — `SanitizeStrategy`
+- `src/df_test_framework/infrastructure/tracing/exporters.py` — `ExporterType`
+- `src/df_test_framework/capabilities/clients/graphql/query_builder.py` — `OperationType`
+- `src/df_test_framework/capabilities/databases/repositories/query_spec.py` — `Operator`
+- `src/df_test_framework/capabilities/drivers/web/playwright/browser.py` — `BrowserType`
+- `src/df_test_framework/capabilities/drivers/web/playwright/locator.py` — `LocatorType`
+
+依赖升级后，ruff UP042 规则要求将 `class Foo(str, Enum)` 改为 `class Foo(StrEnum)`。`StrEnum` 是 Python 3.11 引入的官方等价写法，行为完全兼容。
+
+```python
+# 修复前
+from enum import Enum
+class HttpMethod(str, Enum):
+    GET = "GET"
+
+# 修复后
+from enum import StrEnum
+class HttpMethod(StrEnum):
+    GET = "GET"
+```
+
+### 2. 脚手架模板 `{{}}` 残留 bug
+
+**影响文件**:
+- `src/df_test_framework/cli/templates/project/conftest.py`
+- `src/df_test_framework/cli/templates/project/full_conftest.py`
+- `src/df_test_framework/cli/templates/project/ui_conftest.py`
+- `src/df_test_framework/cli/templates/project/async_example_api.py`
+
+模板渲染改用 `str.replace()` 后，原 Jinja2 转义写法 `{{}}` 未清理，导致 `df-test init` 生成的项目文件中出现错误的字典字面量：
+
+```python
+# 生成文件中的 bug（脚手架输出）
+config.get("test", {{}})   # TypeError: unhashable type，被 except 吞掉
+
+# 修复后
+config.get("test", {})     # 正确的空 dict 默认值
+```
+
+受影响的是通过 `df-test init` 新建的项目，已有项目不受影响。建议使用旧版脚手架生成的项目手动检查 `tests/conftest.py` 中的 `_get_apis_package` / `_get_actions_package` 函数。

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "df-test-framework"
-version = "4.2.1"
+version = "4.2.2"
 description = "基于交互模式的现代化测试自动化框架，支持多种测试场景"
 authors = [{name = "DF QA Team", email = "qa@example.com"}]
 readme = "README_PYPI.md"
@@ -21,7 +21,7 @@ classifiers = [
 
 dependencies = [
     # 核心测试依赖
-    "pytest>=9.0.1",
+    "pytest==9.0.3",
     "pytest-timeout>=2.2.0",
     "pytest-asyncio>=1.3.0", # 异步测试支持
     "allure-pytest>=2.13.0",
@@ -42,8 +42,8 @@ dependencies = [
     "pymysql>=1.1.0",
     "redis>=5.0.0",
     # 工具库
-    "structlog>=25.4.0",  # 现代化结构化日志 (v3.38.5: 升级支持 Python 3.14)
-    "freezegun>=1.5.0",   # 时间 Mock (v3.38.4, time_mock fixture)
+    "structlog>=25.4.0", # 现代化结构化日志 (v3.38.5: 升级支持 Python 3.14)
+    "freezegun>=1.5.0", # 时间 Mock (v3.38.4, time_mock fixture)
     "openpyxl>=3.1.0",
     "faker>=38.2.0",
     "pluggy>=1.5.0",
@@ -51,11 +51,11 @@ dependencies = [
     "prance[osv]>=23.6.0", # OpenAPI/Swagger 解析器
     "pyyaml>=6.0.0", # YAML 支持（OpenAPI 规范）
     "jsonpath-ng>=1.7.0",
-    "pypinyin>=0.53.0",  # 中文转拼音，用于 CLI 代码生成器处理中文 tag
+    "pypinyin>=0.53.0", # 中文转拼音，用于 CLI 代码生成器处理中文 tag
     # 安全依赖版本约束 (CVE 修复)
-    "requests>=2.32.4",  # CVE-2024-47081
-    "urllib3>=2.6.0",    # CVE-2025-50182, CVE-2025-50181, CVE-2025-66418, CVE-2025-66471
-    "filelock>=3.20.1",  # CVE-2025-68146
+    "requests>=2.32.4", # CVE-2024-47081
+    "urllib3>=2.6.0", # CVE-2025-50182, CVE-2025-50181, CVE-2025-66418, CVE-2025-66471
+    "filelock>=3.20.1", # CVE-2025-68146
 ]
 
 [project.urls]

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/__init__.py

@@ -1,8 +1,12 @@
 """
-DF 测试自动化框架 v4.2.1
+DF 测试自动化框架 v4.2.2
 
 企业级测试平台架构升级，基于五层架构 + 事件驱动 + 可观测性。
 
+v4.2.2 核心特性 - 依赖升级 + 脚手架模板修复:
+- 🔧 升级依赖后枚举类统一改用 `StrEnum`（原 `str, Enum` 写法）
+- 🐛 修复脚手架模板中 `{{}}` 残留导致生成文件含错误字典字面量
+
 v4.2.1 核心特性 - 递归子包扫描修复:
 - 🔧 `load_api_fixtures` / `load_actions_fixtures` / `load_service_fixtures` 使用 `walk_packages` 递归扫描子包
 

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/capabilities/clients/graphql/query_builder.py

@@ -5,11 +5,11 @@
 
 from __future__ import annotations
 
-from enum import Enum
+from enum import StrEnum
 from typing import Any
 
 
-class OperationType(str, Enum):
+class OperationType(StrEnum):
     """操作类型"""
 
     QUERY = "query"

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/capabilities/databases/repositories/query_spec.py

@@ -19,11 +19,11 @@ v1.4.0 新增 - 提供灵活的查询条件构建能力
 
 from abc import ABC, abstractmethod
 from dataclasses import dataclass
-from enum import Enum
+from enum import StrEnum
 from typing import Any
 
 
-class Operator(str, Enum):
+class Operator(StrEnum):
     """SQL操作符"""
 
     EQ = "="

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/capabilities/drivers/web/playwright/browser.py

@@ -13,7 +13,7 @@ v4.0.0: 异步优先，同步兼容
 - AsyncBrowserManager：异步版本（推荐，性能提升 2-3 倍）
 """
 
-from enum import Enum
+from enum import StrEnum
 from typing import Any
 
 try:
@@ -38,7 +38,7 @@ except ImportError:
         raise ImportError("Playwright未安装")
 
 
-class BrowserType(str, Enum):
+class BrowserType(StrEnum):
     """浏览器类型枚举"""
 
     CHROMIUM = "chromium"

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/capabilities/drivers/web/playwright/locator.py

@@ -4,7 +4,7 @@
 基于 Playwright 实现
 """
 
-from enum import Enum
+from enum import StrEnum
 from typing import Any
 
 try:
@@ -17,7 +17,7 @@ except ImportError:
     Locator = Any
 
 
-class LocatorType(str, Enum):
+class LocatorType(StrEnum):
     """定位器类型枚举"""
 
     CSS = "css"

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/cli/templates/project/async_example_api.py

@@ -181,8 +181,8 @@ class AsyncExampleAPI(AsyncBaseAPI):
         Returns:
             True 表示已存在，False 表示不存在
         """
-        response = await self.get("/examples/check-email", params={{"email": email}})
-        return response.get("data", {{}}).get("exists", False)
+        response = await self.get("/examples/check-email", params={"email": email})
+        return response.get("data", {}).get("exists", False)
 
     # ========== 并发示例 ==========
 

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/cli/templates/project/conftest.py

@@ -85,7 +85,7 @@ def _get_apis_package() -> str:
     try:
         from df_test_framework.infrastructure.config import get_config
         config = get_config()
-        return config.get("test", {{}}).get("apis_package") or default_package
+        return config.get("test", {}).get("apis_package") or default_package
     except Exception:
         return default_package
 

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/cli/templates/project/full_conftest.py

@@ -99,7 +99,7 @@ def _get_apis_package() -> str:
     try:
         from df_test_framework.infrastructure.config import get_config
         config = get_config()
-        return config.get("test", {{}}).get("apis_package") or default_package
+        return config.get("test", {}).get("apis_package") or default_package
     except Exception:
         return default_package
 
@@ -110,7 +110,7 @@ def _get_actions_package() -> str:
     try:
         from df_test_framework.infrastructure.config import get_config
         config = get_config()
-        return config.get("test", {{}}).get("actions_package") or default_package
+        return config.get("test", {}).get("actions_package") or default_package
     except Exception:
         return default_package
 

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/cli/templates/project/ui_conftest.py

@@ -93,7 +93,7 @@ def _get_actions_package() -> str:
     try:
         from df_test_framework.infrastructure.config import get_config
         config = get_config()
-        return config.get("test", {{}}).get("actions_package") or default_package
+        return config.get("test", {}).get("actions_package") or default_package
     except Exception:
         return default_package
 

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/core/types.py

@@ -6,13 +6,13 @@ v3.29.0: 合并 utils/types.py (DecimalAsFloat, DecimalAsCurrency)
 """
 
 from decimal import Decimal
-from enum import Enum
+from enum import Enum, StrEnum
 from typing import Annotated, Any, TypeVar
 
 from pydantic import PlainSerializer
 
 
-class Environment(str, Enum):
+class Environment(StrEnum):
     """环境枚举"""
 
     LOCAL = "local"
@@ -32,7 +32,7 @@ class Environment(str, Enum):
         raise ValueError(f"Unknown environment: {value}")
 
 
-class LogLevel(str, Enum):
+class LogLevel(StrEnum):
     """日志级别"""
 
     DEBUG = "DEBUG"
@@ -42,7 +42,7 @@ class LogLevel(str, Enum):
     CRITICAL = "CRITICAL"
 
 
-class HttpMethod(str, Enum):
+class HttpMethod(StrEnum):
     """HTTP 方法"""
 
     GET = "GET"
@@ -54,7 +54,7 @@ class HttpMethod(str, Enum):
     OPTIONS = "OPTIONS"
 
 
-class DatabaseDialect(str, Enum):
+class DatabaseDialect(StrEnum):
     """数据库方言"""
 
     MYSQL = "mysql"
@@ -64,7 +64,7 @@ class DatabaseDialect(str, Enum):
     MSSQL = "mssql"
 
 
-class MessageQueueType(str, Enum):
+class MessageQueueType(StrEnum):
     """消息队列类型"""
 
     KAFKA = "kafka"
@@ -72,7 +72,7 @@ class MessageQueueType(str, Enum):
     ROCKETMQ = "rocketmq"
 
 
-class StorageType(str, Enum):
+class StorageType(StrEnum):
     """存储类型"""
 
     S3 = "s3"
@@ -82,7 +82,7 @@ class StorageType(str, Enum):
 
 
 # HTTP状态码分组
-class HttpStatusGroup(str, Enum):
+class HttpStatusGroup(StrEnum):
     """HTTP状态码分组"""
 
     INFORMATIONAL = "1xx"  # 信息响应
@@ -125,7 +125,7 @@ class HttpStatus(int, Enum):
 
 
 # 数据库操作类型
-class DatabaseOperation(str, Enum):
+class DatabaseOperation(StrEnum):
     """数据库操作类型"""
 
     SELECT = "SELECT"
@@ -135,7 +135,7 @@ class DatabaseOperation(str, Enum):
 
 
 # 测试优先级
-class Priority(str, Enum):
+class Priority(StrEnum):
     """测试用例优先级
 
     v3.35.5: 从 TestPriority 重命名为 Priority，避免 pytest 收集警告
@@ -148,7 +148,7 @@ class Priority(str, Enum):
 
 
 # 测试类型
-class CaseType(str, Enum):
+class CaseType(StrEnum):
     """测试类型
 
     v3.35.5: 从 TestType 重命名为 CaseType，避免 pytest 收集警告

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/infrastructure/config/middleware_schema.py

@@ -9,13 +9,13 @@ v3.16.0: 新的中间件配置系统，取代旧的 InterceptorConfig
 """
 
 import json
-from enum import Enum
+from enum import StrEnum
 from typing import Annotated, Any
 
 from pydantic import BaseModel, Discriminator, Field, Tag, field_validator
 
 
-class MiddlewareType(str, Enum):
+class MiddlewareType(StrEnum):
     """中间件类型枚举
 
     v3.17.2: 只保留已实现的中间件类型，移除未实现的类型
@@ -85,7 +85,7 @@ class MiddlewareConfig(BaseModel):
 # ============================================================
 
 
-class SignatureAlgorithm(str, Enum):
+class SignatureAlgorithm(StrEnum):
     """签名算法"""
 
     MD5 = "md5"
@@ -118,7 +118,7 @@ class SignatureMiddlewareConfig(MiddlewareConfig):
     exclude_keys: list[str] = Field(default_factory=list, description="签名时排除的参数 key")
 
 
-class TokenSource(str, Enum):
+class TokenSource(StrEnum):
     """Token 来源"""
 
     LOGIN = "login"  # 动态登录获取
@@ -228,7 +228,7 @@ class BearerTokenMiddlewareConfig(MiddlewareConfig):
         raise ValueError(f"credentials must be dict or JSON string, got {type(value).__name__}")
 
 
-class RetryStrategy(str, Enum):
+class RetryStrategy(StrEnum):
     """重试策略"""
 
     FIXED = "fixed"  # 固定间隔

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/infrastructure/config/schema.py

@@ -8,7 +8,7 @@ from __future__ import annotations
 
 import os
 import re
-from enum import Enum
+from enum import StrEnum
 from typing import Any, Literal
 
 from pydantic import BaseModel, Field, SecretStr, field_validator, model_validator
@@ -583,7 +583,7 @@ class LoggingConfig(BaseModel):
     )
 
 
-class SanitizeStrategy(str, Enum):
+class SanitizeStrategy(StrEnum):
     """脱敏策略枚举
 
     v3.40.0 新增：统一脱敏服务支持多种脱敏策略。

{df_test_framework-4.2.1 → df_test_framework-4.2.2}/src/df_test_framework/infrastructure/tracing/exporters.py

@@ -7,11 +7,11 @@ v3.10.0 新增 - P2.1 OpenTelemetry分布式追踪
 
 from __future__ import annotations
 
-from enum import Enum
+from enum import StrEnum
 from typing import Any
 
 
-class ExporterType(str, Enum):
+class ExporterType(StrEnum):
     """导出器类型
 
     支持的追踪数据导出后端