df-test-framework 4.9.0__tar.gz → 4.9.1__tar.gz

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/AGENTS.md

@@ -8,7 +8,7 @@ This file provides guidance to Codex (Codex.ai/code) when working with code in t
 
 **DF Test Framework** - 现代化 Python 测试自动化框架
 
-- **版本**: v4.9.0
+- **版本**: v4.9.1
 - **更新时间**: 2026-08-11
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/CHANGELOG.md

@@ -7,6 +7,42 @@
 
 ## [Unreleased]
 
+## [4.9.1] - 2026-08-18
+
+### ⚠️ 破坏性变更
+
+naming 模块 v4.8.1 才引入、消费方全部已知且本轮同步适配，按 v4.9.0 先例未升 MAJOR。
+
+- **`Lifecycle` 纯语义化**：枚举值改为 `"case"` / `"managed"`，`BASELINE` 成员
+  更名 `MANAGED`。前缀是项目/协议层的语法，机制层不携带。按语义比较
+  （`is Lifecycle.CASE`）的用法零改动。
+- **`NamingRegistry.make()` 删除 `suffix`**：它追加在 `{uid}` 之后，破坏
+  "uid 是最后一槽"的可解析性。序号、能力名改走 `label=`。
+- **`NamingRule` 字段序调整、`match` 可选**：`match` 移到 `max_length` 之后，
+  默认从 template 推导；关键字传参不受影响，显式传入继续作为覆盖生效。
+- **`self_check()` 不再硬编码 `AUTO_BASE` 探针**：受管数据保护由调用方注入
+  `protected_names`，协议层 `NamingStandard.self_check()` 按池枚举自动生成探针。
+- **`NamingRegistry` 构造期结构校验**：重 key、joins_via 悬空、模式无锚点、
+  方言敏感字符 import 即拒绝。
+
+### ✨ 新增
+
+- **命名协议层 `naming_standard`**：`NamingStandard` / `StandardRule` /
+  `ParsedName`。统一语法为单一产生式
+  `<PREFIX>_[<POOL>_]<DOMAIN>[_<LABEL>]_<ID>`，覆盖普通测试 / 基准 / 性能
+  全部场景；项目只声明业务事实（域码、池、字段规则），语法由框架持有并执行。
+  提供 make / fresh / pool_name / pool_prefix / digits / parse / self_check。
+- **`readable_uid()` / `fresh_uid()`**：可读 uid `<MMDD>T<HHMM>_<hex8>`，
+  格式单点定义；readable_uid 从 test_id 尾部锚定，生成端↔解析端契约有测试钉住。
+- **`label_policy`**：标签策略收进 `NamingRegistry` 构造参数，注册表是唯一闸门。
+- **`like_escape()`**：注册表模式 → 显式 ESCAPE 风格，清理脚本共用。
+- **`naming_guards`**：AST 源码守卫（禁 f-string 手拼请求字段、禁 test_id 前缀）
+  做成可复用断言。
+- **`NamingRule.static_prefix`**、**`NamingRegistry.items()`**、
+  **`{tag}` / `{uid}` 模板占位符**、**`scoped_label_in_text` 规则开关**。
+
+详见 [docs/releases/v4.9.1.md](docs/releases/v4.9.1.md)。
+
 ## [4.9.0] - 2026-08-11
 
 ### ⚠️ 破坏性变更

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/CLAUDE.md

@@ -8,7 +8,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **DF Test Framework** - 现代化 Python 测试自动化框架
 
-- **版本**: v4.9.0
+- **版本**: v4.9.1
 - **更新时间**: 2026-08-11
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: df-test-framework
-Version: 4.9.0
+Version: 4.9.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.9.0 → df_test_framework-4.9.1}/README.md

@@ -1,6 +1,6 @@
 # DF Test Framework
 
-> **版本**: v4.9.0
+> **版本**: v4.9.1
 > **更新时间**: 2026-08-11
 > 简单、强大、可扩展的现代化 Python 测试自动化框架
 

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/docs/ESSENTIAL_DOCS.md

@@ -2,7 +2,7 @@
 
 > **目标读者**: 测试开发人员、框架使用者、新团队成员
 > **更新日期**: 2026-08-11
-> **框架版本**: v4.9.0
+> **框架版本**: v4.9.1
 
 ---
 

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/docs/README.md

@@ -1,6 +1,6 @@
 # DF Test Framework 文档中心
 
-> 版本：v4.9.0 · 最近更新：2026-08-11
+> 版本：v4.9.1 · 最近更新：2026-08-18
 > 现代化 Python 测试自动化框架的官方知识库。
 
 ---

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/docs/releases/README.md

@@ -1,6 +1,6 @@
 # Release Notes 发布说明索引
 
-> 当前版本：**v4.9.0** · 最近更新：2026-08-11
+> 当前版本：**v4.9.1** · 最近更新：2026-08-18
 
 完整变更摘要见 [CHANGELOG.md](../../CHANGELOG.md)。
 
@@ -10,7 +10,8 @@
 
 | 版本 | 发布日期 | 核心特性 |
 |------|----------|----------|
-| **[v4.9.0](v4.9.0.md)** ⭐ 当前 | 2026-08-11 | 轮询等待与观察窗口断言、cleanup 作用域扩展、命名认领契约落地、SM2 短私钥修复 |
+| **[v4.9.1](v4.9.1.md)** ⭐ 当前 | 2026-08-18 | 命名协议层：单一产生式覆盖普通/基准/性能数据，Lifecycle 纯语义化，AST 守卫与 uid/转义工具下沉 |
+| [v4.9.0](v4.9.0.md) | 2026-08-11 | 轮询等待与观察窗口断言、cleanup 作用域扩展、命名认领契约落地、SM2 短私钥修复 |
 
 ## v4.8.x
 

df_test_framework-4.9.1/docs/releases/v4.9.1.md

@@ -0,0 +1,150 @@
+# v4.9.1 - 命名协议层：一条产生式覆盖全部测试数据场景
+
+**发布日期**: 2026-08-18
+
+## 概述
+
+本版本把测试数据命名从「机制 + 各项目自定语法」升级为「机制 + 框架统一协议」。
+
+出发点是 master_test 命名重建时暴露的两层问题：
+
+- **项目内**：同一语义三种写法（`AUTO_CASE_` / `AUTOCASE` / `ac`），外加 20 多种
+  散落的手拼前缀，兜底清理认领不到，用例崩溃即永久残留；
+- **项目间**：每个项目自己发明语法（master_test 一套、techconnect 一套、
+  yx-mixue 一套）——「每个项目自己发明语法」正是「每个测试自己拼 f-string」
+  在项目间的翻版。**可执行的标准优于文档标准**：一份规范文档约束不了任何项目，
+  一个 `NamingStandard` 实例可以。
+
+分层定型为三级：
+
+```
+naming.py            机制层：注册表 / uid / 守卫 / LIKE 转义（零项目语法）
+naming_standard.py   协议层：统一语法（本版本新增）
+<项目>/data_naming   项目层：纯业务声明（域码、池、字段规则、豁免表）
+```
+
+---
+
+## 协议语法：一条产生式
+
+```
+name ::= <PREFIX> _ [<POOL> _] <DOMAIN> [_ <LABEL>] _ <ID>
+```
+
+```
+AUTO_GOOD_RECYCLE_0817T1051_4d6b9025    普通测试：POOL 省略，ID=uid
+AUTO_BASE_GOOD_ORDER_SUCCESS            基准数据：POOL=BASE，ID=key
+AUTO_PERF_CARD_STRESS_001               性能数据：POOL=PERF，ID=key（带序号）
+```
+
+- **POOL 省略即普通测试数据** —— default namespace 手法（同 URL 省略 `:443`、
+  k8s 省略 `default`）。池词表与域码表构造期校验不相交，第二槽解析可判定；
+  加第 N 种生命周期 = 项目池枚举加一行。
+- **ID 是最后一槽（协议没有 suffix），有两个取值器** —— 这不是语法分裂，
+  是资源性质的忠实映射（cattle vs pets）：普通测试数据无限多、用完即清，
+  只能机器编号（uid，18 字符含时间）；池数据要被 seed / 巡检 / 用例按名字
+  **稳定回查**，机器随机名每次重建就变、所有引用全断，必须人工命名（key）。
+- **LABEL 单一槽位**：字段限定词、能力名 / 序号（`label=`）、场景标签
+  （`scoped`）全落这里，策略统一归一并拦截保留词冲突 —— 策略在注册表内部，
+  直接调 `registry.make` 也绕不开。
+
+项目接入是纯声明：
+
+```python
+class Domain(StrEnum):
+    SUP = "SUP"
+
+class Pool(StrEnum):
+    BASE = "BASE"
+
+STANDARD = NamingStandard(
+    pools=Pool,
+    rules=[StandardRule("supplier_name", "supplier", "SUPPLIER_NAME", Domain.SUP, 100)],
+    pool_columns={Domain.SUP: "supplier_name"},
+)
+
+STANDARD.make("supplier_name", test_id)                # 用例级
+STANDARD.make("supplier_name", test_id, label="003")   # 序号进 LABEL 槽
+STANDARD.fresh("euser_order_no", "as_refund")          # 每次调用唯一（订单号）
+STANDARD.pool_name(Pool.BASE, Domain.SUP, "MAIN")      # 池类
+STANDARD.parse(name)                                   # 残留排查：名字 → 结构
+STANDARD.self_check(sample_test_id)                    # 自动注入每个池的探针
+```
+
+---
+
+## ⚠️ 破坏性变更
+
+naming 模块 v4.8.1 才引入、消费方全部已知且本轮同步适配，按 v4.9.0 先例
+未升 MAJOR，单列如下。
+
+### 1. `Lifecycle` 纯语义化
+
+枚举值从 `"AUTO_CASE"` / `"AUTO_BASE"` 改为 `"case"` / `"managed"`，
+`BASELINE` 成员更名 `MANAGED`。前缀是项目/协议层的语法，机制层携带它
+就是两处定义 —— 项目侧曾靠单测钉住「枚举值 == 协议拼出的前缀」。
+
+**迁移**：按语义比较的用法（`rule.lifecycle is Lifecycle.CASE`）零改动；
+引用 `Lifecycle.BASELINE` 改为 `Lifecycle.MANAGED`；依赖枚举**值**当前缀的
+改为从协议层取 `STANDARD.pool_prefix(pool)`。
+
+### 2. `NamingRegistry.make()` 删除 `suffix` 参数
+
+`suffix` 追加在 `{uid}` 之后，破坏「uid 是最后一槽」的可解析性。
+序号、能力名改走 `label=`（进 LABEL 槽）：
+
+```python
+# 旧：AUTO_CARD_<uid>_003          # 新：AUTO_CARD_003_<uid>
+registry.make("card_no", tid, suffix="003")
+registry.make("card_no", tid, label="003")
+```
+
+### 3. `NamingRule` 字段顺序调整，`match` 可选
+
+`match` 移到 `max_length` 之后且默认从 template 推导（`derive_match`）——
+手写 match 是可以独立漂移的第二份定义。**关键字传参的调用方不受影响**；
+显式传入的 match 继续作为覆盖生效。
+
+### 4. `self_check()` 不再硬编码 `AUTO_BASE` 探针
+
+机制层硬编码某个池前缀是项目语法泄漏。受管数据保护改由调用方注入
+`protected_names`；协议层 `NamingStandard.self_check()` 按池枚举自动
+生成探针 —— 加池自动纳入守卫，不再手抄样本。
+
+### 5. `NamingRegistry` 构造期结构校验
+
+重 key、joins_via 悬空、模式无锚点、方言敏感字符在 `__init__` 即拒绝
+（import 即失败，测试可跳、import 躲不掉）。此前这些要等 `self_check`。
+
+---
+
+## ✨ 新增
+
+- **`NamingStandard` / `StandardRule` / `ParsedName`**（`naming_standard.py`）：
+  协议层，见上文。
+- **`readable_uid()` / `fresh_uid()`**：可读 uid `<MMDD>T<HHMM>_<hex8>`，
+  格式只有 `_format_uid` 一处定义。`readable_uid` 从 test_id 尾部锚定时间戳
+  （旧的"找第一段 14 位数字"在前缀以数字结尾时错位一位）；`fresh_uid` 每次
+  调用唯一，供订单号等「一条用例多个编号」场景。生成端 ↔ 解析端的格式契约
+  由测试钉住。
+- **`label_policy`**：标签策略（归一化、保留词拦截）作为 `NamingRegistry`
+  构造参数收进注册表 —— 注册表是唯一闸门，策略住在包装函数里的话，任何
+  直接调注册表的代码都会静默绕过。
+- **`like_escape()`**：注册表模式 → 显式 `ESCAPE` 风格。每个项目的清理脚本
+  都要这段转义、细节又易错（`!` 翻倍等），上移框架。
+- **`naming_guards`** 模块：AST 源码守卫做成可复用断言，项目一行接入：
+  - `find_handmade_request_kwargs`：禁止 `*Request(...)` 的 kwarg 用 f-string
+    现拼名字（豁免分「字段类别」与「(类, 字段) 个案」两张表）；
+  - `find_prefixed_test_id_calls`：禁止给 `DataGenerator.test_id()` 传前缀。
+- **`NamingRule.static_prefix`**：模板静态前缀的单一访问器，不再让调用方
+  各自 `split("{")` 解析。
+- **`NamingRegistry.items()`**。
+
+---
+
+## 采纳情况
+
+- **master_test**：已完整切换为协议消费者（`data_naming.py` 缩为纯业务声明），
+  产出与库中存量名字逐字节一致，单测 1028 / 接口 290 / 基准池巡检 18 项全绿。
+- **techconnect_test / yx-mixue-test**：本次随版本升级做最小适配
+  （见各自提交），语法迁移可渐进 —— 机制层长期保留，不逼迁。

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/pyproject.toml

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

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/src/df_test_framework/__init__.py

@@ -7,7 +7,7 @@ DF 测试自动化框架
 变更历史见 CHANGELOG.md，发布说明见 docs/releases/。
 """
 
-__version__ = "4.9.0"
+__version__ = "4.9.1"
 __author__ = "DF QA Team"
 
 # ==============================================================================

{df_test_framework-4.9.0 → df_test_framework-4.9.1}/src/df_test_framework/testing/data/__init__.py

@@ -58,10 +58,14 @@ from .naming import (
     Lifecycle,
     NamingRegistry,
     NamingRule,
+    fresh_uid,
+    like_escape,
     like_to_regex,
+    readable_uid,
     scoped,
     short_id,
 )
+from .naming_standard import NamingStandard, ParsedName, StandardRule, normalize_label
 from .pipeline import CaseContext, CaseDataset, CaseReporter, DataAssetResolver, case_dataset
 
 __all__ = [
@@ -95,6 +99,13 @@ __all__ = [
     "Lifecycle",
     "NamingRegistry",
     "NamingRule",
+    "NamingStandard",
+    "ParsedName",
+    "StandardRule",
+    "fresh_uid",
+    "like_escape",
+    "normalize_label",
+    "readable_uid",
     "like_to_regex",
     "scoped",
     "short_id",