df-test-framework 4.3.0__tar.gz → 4.3.1__tar.gz

{df_test_framework-4.3.0 → df_test_framework-4.3.1}/CHANGELOG.md

@@ -5,6 +5,14 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [4.3.1] - 2026-04-16
+
+### 🔧 改进
+
+- **HTTP 方法 `@overload` 类型重载** (`BaseAPI` / `AsyncBaseAPI`): `get/post/put/delete/patch` 新增两组 `@overload`，当 `model=type[T]` 时推断返回 `T`，当 `model=None` 时推断返回 `dict[str, Any]`，消除调用处的手动类型转换
+
+---
+
 ## [4.3.0] - 2026-04-16
 
 ### ✨ 新增功能

{df_test_framework-4.3.0 → df_test_framework-4.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: df-test-framework
-Version: 4.3.0
+Version: 4.3.1
 Summary: 基于交互模式的现代化测试自动化框架，支持多种测试场景
 Project-URL: Homepage, https://github.com/yourorg/df-test-framework
 Project-URL: Repository, https://github.com/yourorg/df-test-framework

df_test_framework-4.3.1/docs/releases/v4.3.1.md

@@ -0,0 +1,49 @@
+# v4.3.1 发布说明
+
+**发布日期**: 2026-04-16
+**类型**: 补丁版本（Patch Release）
+**主题**: HTTP 方法 @overload 类型重载
+
+---
+
+## 概述
+
+v4.3.1 为 `BaseAPI` 和 `AsyncBaseAPI` 的所有 HTTP 方法（`get / post / put / delete / patch`）补充了 `@overload` 类型重载，提升 IDE 类型推断精度，无任何运行时行为变更。
+
+**向后兼容**：纯类型签名改进，无 API 变更。
+
+---
+
+## 改进内容
+
+### `@overload` 类型重载 - `BaseAPI` / `AsyncBaseAPI`
+
+**影响文件**:
+- `src/df_test_framework/capabilities/clients/http/rest/httpx/base_api.py`
+- `src/df_test_framework/capabilities/clients/http/rest/httpx/async_base_api.py`
+
+为每个 HTTP 方法新增两组 `@overload`：
+
+| 调用签名 | 返回类型 |
+|---------|---------|
+| `model: type[T]` | `T` |
+| `model: None`（默认） | `dict[str, Any]` |
+
+**效果**：调用方无需手动强制类型转换，IDE/mypy 可直接推断出正确类型。
+
+```python
+# 之前：返回类型为 T | dict[str, Any]，需要手动 cast
+user = api.get("/users/1", model=UserModel)  # 类型: UserModel | dict
+
+# 之后：精准推断
+user = api.get("/users/1", model=UserModel)  # 类型: UserModel
+data = api.get("/users/1")                   # 类型: dict[str, Any]
+```
+
+涵盖方法：`get`、`post`、`put`、`delete`、`patch`（同步 + 异步各 5 个，共 10 个方法）。
+
+---
+
+## 升级指引
+
+直接升级，无需修改任何代码。

{df_test_framework-4.3.0 → df_test_framework-4.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "df-test-framework"
-version = "4.3.0"
+version = "4.3.1"
 description = "基于交互模式的现代化测试自动化框架，支持多种测试场景"
 authors = [{name = "DF QA Team", email = "qa@example.com"}]
 readme = "README_PYPI.md"

{df_test_framework-4.3.0 → df_test_framework-4.3.1}/src/df_test_framework/__init__.py

@@ -1,8 +1,12 @@
 """
-DF 测试自动化框架 v4.2.2
+DF 测试自动化框架 v4.3.1
 
 企业级测试平台架构升级，基于五层架构 + 事件驱动 + 可观测性。
 
+v4.3.1 核心特性 - HTTP 方法 @overload 类型重载:
+- 🔧 `BaseAPI` / `AsyncBaseAPI` 的 get/post/put/delete/patch 方法新增 `@overload`
+- ✅ IDE 精准类型推断：`model=SomeModel` → 返回 `SomeModel`，`model=None` → 返回 `dict[str, Any]`
+
 v4.2.2 核心特性 - 依赖升级 + 脚手架模板修复:
 - 🔧 升级依赖后枚举类统一改用 `StrEnum`（原 `str, Enum` 写法）
 - 🐛 修复脚手架模板中 `{{}}` 残留导致生成文件含错误字典字面量
@@ -156,7 +160,7 @@ v3.18.1 特性:
 - 🔄 Unit of Work 模式支持（v3.7）
 """
 
-__version__ = "4.3.0"
+__version__ = "4.3.1"
 __author__ = "DF QA Team"
 
 # ==============================================================================

{df_test_framework-4.3.0 → df_test_framework-4.3.1}/src/df_test_framework/capabilities/clients/http/rest/httpx/async_base_api.py

@@ -13,7 +13,7 @@ v4.0.0 新增:
 - 响应解析、业务错误检查逻辑保持一致
 """
 
-from typing import Any, TypeVar
+from typing import Any, TypeVar, overload
 
 from pydantic import BaseModel, ValidationError
 
@@ -233,6 +233,26 @@ class AsyncBaseAPI:
             endpoint = "/" + endpoint
         return endpoint
 
+    @overload
+    async def get(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    async def get(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     async def get(
         self,
         endpoint: str,
@@ -297,6 +317,28 @@ class AsyncBaseAPI:
         response = await self.http_client.get(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    async def post(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    async def post(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     async def post(
         self,
         endpoint: str,
@@ -357,6 +399,28 @@ class AsyncBaseAPI:
         response = await self.http_client.post(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    async def put(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    async def put(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     async def put(
         self,
         endpoint: str,
@@ -410,6 +474,26 @@ class AsyncBaseAPI:
         response = await self.http_client.put(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    async def delete(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    async def delete(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     async def delete(
         self,
         endpoint: str,
@@ -448,6 +532,28 @@ class AsyncBaseAPI:
         response = await self.http_client.delete(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    async def patch(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    async def patch(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     async def patch(
         self,
         endpoint: str,

{df_test_framework-4.3.0 → df_test_framework-4.3.1}/src/df_test_framework/capabilities/clients/http/rest/httpx/base_api.py

@@ -17,7 +17,7 @@ v3.20.0 新增:
 详见: docs/INTERCEPTOR_ARCHITECTURE.md
 """
 
-from typing import Any, TypeVar
+from typing import Any, TypeVar, overload
 
 from pydantic import BaseModel, ValidationError
 
@@ -243,6 +243,26 @@ class BaseAPI:
             endpoint = "/" + endpoint
         return endpoint
 
+    @overload
+    def get(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    def get(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     def get(
         self,
         endpoint: str,
@@ -299,6 +319,28 @@ class BaseAPI:
         response = self.http_client.get(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    def post(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    def post(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     def post(
         self,
         endpoint: str,
@@ -356,6 +398,28 @@ class BaseAPI:
         response = self.http_client.post(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    def put(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    def put(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     def put(
         self,
         endpoint: str,
@@ -403,6 +467,26 @@ class BaseAPI:
         response = self.http_client.put(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    def delete(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    def delete(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     def delete(
         self,
         endpoint: str,
@@ -434,6 +518,28 @@ class BaseAPI:
         response = self.http_client.delete(url, **kwargs)
         return self._parse_response(response, model)
 
+    @overload
+    def patch(
+        self,
+        endpoint: str,
+        model: type[T],
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> T: ...
+
+    @overload
+    def patch(
+        self,
+        endpoint: str,
+        model: None = ...,
+        skip_auth: bool = ...,
+        token: str | None = ...,
+        files: FilesTypes | None = ...,
+        **kwargs: Any,
+    ) -> dict[str, Any]: ...
+
     def patch(
         self,
         endpoint: str,

{df_test_framework-4.3.0 → df_test_framework-4.3.1}/uv.lock

@@ -549,7 +549,7 @@ wheels = [
 
 [[package]]
 name = "df-test-framework"
-version = "4.3.0"
+version = "4.3.1"
 source = { editable = "." }
 dependencies = [
     { name = "allure-pytest" },