chore: 工具迁入正式工程 + 工程 README + 根目录草稿报告入 ignore

- eip4-poc/tools/{s3_rewriter,loadtest} → tools/(P4 改写器种子与压测 harness 随工程演进,PoC 冻结)
- 新增工程 README(模块图/纪律/常用命令/自举说明)
- 根目录 parity-reports/ 为 CLI 默认输出草稿,入 .gitignore(正式报告在 platform-parity/parity-reports/)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 11:20:01 +08:00
parent f10d11c958
commit c174fbdf83
94 changed files with 17746 additions and 0 deletions

View File

@@ -0,0 +1,776 @@
"""
S3 脚本正则改写器 — rewrite.py
将 Groovy S3 脚本(直接调 Vaadin API)改写为 S2 形态(facade 辅助函数调用)。
分类标签:
FULL_AUTO — 全部 S3 模式改写成功,无遗留
PARTIAL — 部分改写成功,仍有 S3 片段待人工处理
HARD — 命中硬 S3 特征(动态 Vaadin 组件/确认框),整条转人工
NO_S3 — 未检测到任何 S3 模式,原样返回
用法:
from rewrite import rewrite_script
text, details, label = rewrite_script(groovy_src)
"""
import re
from dataclasses import dataclass, field
from typing import List, Tuple
# ──────────────────────────────────────────────
# 1. 硬 S3 检测模式(命中即整条转人工)
# ──────────────────────────────────────────────
HARD_S3_PATTERNS: List[Tuple[str, str]] = [
# 动态创建 Vaadin 组件
(r"\bnew\s+(Window|Button|ComboBox|TextField|Label|Table|Panel|"
r"VerticalLayout|HorizontalLayout|FormLayout|GridLayout|"
r"AbsoluteLayout|TabSheet|Accordion|PopupView|Upload|"
r"ProgressBar|Slider|DateField|CheckBox|OptionGroup|"
r"TwinColSelect|ListSelect|NativeSelect|PasswordField|"
r"RichTextArea|TextArea|InlineDateField|Link|Embedded|"
r"MenuBar|Tree|TreeTable|SplitPanel|HorizontalSplitPanel|"
r"VerticalSplitPanel|Notification)\b",
"动态创建 Vaadin 组件"),
(r"\bshowConfirmDialog\b", "同步确认框 showConfirmDialog"),
(r"\bUI\.getCurrent\(\)", "UI.getCurrent()"),
]
# ──────────────────────────────────────────────
# 2. 数据表驱动改写规则(按优先级顺序)
# 每条规则: (规则名, 正则模式, 替换模板或替换函数)
#
# 占位符约定:
# {FIELD} — 字段名字符串(含引号),如 "PROJ_NAME"
# {ARG} — 单参数
# {ARGS} — 多参数(逗号分隔)
# {VAR} — Groovy 变量名
# ──────────────────────────────────────────────
@dataclass
class RewriteRule:
name: str
pattern: re.Pattern
replacement: str # 可含 \1 \2 等反向引用,或直接是字符串
def _make_field_rules() -> List[RewriteRule]:
"""生成字段句柄链式调用规则表(数据表驱动)。
形态说明(真实库实测,2026-06-11):
- 字段句柄链同时存在普通点 `.` 与 Groovy 安全导航 `?.`,二者语义在
facade 形态下等价(facade 内部处理空值),因此每条字段规则用 NAV 占位
统一匹配两者。真实库 266/400 字段链调用使用 `?.`,不支持则丢失约半数。
"""
# field_ref 匹配: group.getField("X") 或 group.getField('X')
# NAV 同时匹配 `.` 与 `?.`,并允许中间空白(真实库有换行/空格变体)。
fref = r'group\.getField\((["\'][^"\']+["\'])\)'
NAV = r'\s*\??\.\s*'
rules: List[RewriteRule] = []
# ── 2.1 addButton(字段内联按钮)─────────────────────────────
# group.getField("X").addButton("label", handler)
# → addFieldButton("X", "label", handler)
# 注意: 仅当首参为字符串字面量(按钮文案)时才视为字段按钮。
# 形如 addButton(group.getField("SELECT"),0) 是子表动作按钮(另规则)。
rules.append(RewriteRule(
name="addButton",
pattern=re.compile(
fref + NAV + r'addButton\(\s*(["\'][^"\']*["\'][^)]*)\)',
re.DOTALL
),
replacement=r'addFieldButton(\1, \2)',
))
# ── 2.1b addSubTableButton(子表动作按钮)────────────────────
# group.getField("LIST").addButton(group.getField("SELECT"), 0)
# → addSubTableButton("LIST", "SELECT", 0)
# 真实库子表挂载选择/新增按钮的写法,首参是另一个字段句柄。
rules.append(RewriteRule(
name="addSubTableButton",
pattern=re.compile(
fref + NAV +
r'addButton\(\s*group\.getField\((["\'][^"\']+["\'])\)\s*,\s*([^)]+)\)',
re.DOTALL
),
replacement=r'addSubTableButton(\1, \2, \3)',
))
# ── 2.2 getValue ───────────────────────────────────────────
# group.getField("X").getValue() → getFieldValue("X")
rules.append(RewriteRule(
name="getValue",
pattern=re.compile(fref + NAV + r'getValue\(\)'),
replacement=r'getFieldValue(\1)',
))
# ── 2.3 setValue ───────────────────────────────────────────
# group.getField("X").setValue(v) → setFieldValue("X", v)
rules.append(RewriteRule(
name="setValue",
pattern=re.compile(fref + NAV + r'setValue\(([^)]+)\)'),
replacement=r'setFieldValue(\1, \2)',
))
# ── 2.4 setVisible ─────────────────────────────────────────
# group.getField("X").setVisible(b) → setFieldVisible("X", b)
rules.append(RewriteRule(
name="setVisible",
pattern=re.compile(fref + NAV + r'setVisible\(([^)]+)\)'),
replacement=r'setFieldVisible(\1, \2)',
))
# ── 2.5 setCaption ─────────────────────────────────────────
# group.getField("X").setCaption(s) → setFieldCaption("X", s)
rules.append(RewriteRule(
name="setCaption",
pattern=re.compile(fref + NAV + r'setCaption\(([^)]+)\)'),
replacement=r'setFieldCaption(\1, \2)',
))
# ── 2.6 setEnabled / setReadOnly ───────────────────────────
# group.getField("X").setEnabled(b) → setFieldEnabled("X", b)
rules.append(RewriteRule(
name="setEnabled",
pattern=re.compile(fref + NAV + r'setEnabled\(([^)]+)\)'),
replacement=r'setFieldEnabled(\1, \2)',
))
# group.getField("X").getPropertyDataSource().setReadOnly(b)
# → setFieldReadOnly("X", b)
# 真实库"把字段底层属性置只读"的等价惯用写法,须先于裸 setReadOnly 规则,
# 否则中间的 getPropertyDataSource() 会阻断匹配。
rules.append(RewriteRule(
name="propertyDataSource_setReadOnly",
pattern=re.compile(
fref + NAV + r'getPropertyDataSource\(\)' + NAV + r'setReadOnly\(([^)]+)\)'),
replacement=r'setFieldReadOnly(\1, \2)',
))
# group.getField("X").setReadOnly(b) → setFieldReadOnly("X", b)
rules.append(RewriteRule(
name="setReadOnly_field",
pattern=re.compile(fref + NAV + r'setReadOnly\(([^)]+)\)'),
replacement=r'setFieldReadOnly(\1, \2)',
))
# ── 2.7 setRequired / setRequiredError ─────────────────────
# group.getField("X").setRequired(b) → setFieldRequired("X", b)
rules.append(RewriteRule(
name="setRequired",
pattern=re.compile(fref + NAV + r'setRequired\(([^)]+)\)'),
replacement=r'setFieldRequired(\1, \2)',
))
# group.getField("X").setRequiredError(msg) → setFieldRequiredError("X", msg)
rules.append(RewriteRule(
name="setRequiredError",
pattern=re.compile(fref + NAV + r'setRequiredError\(([^)]+)\)', re.DOTALL),
replacement=r'setFieldRequiredError(\1, \2)',
))
# ── 2.8 getContainerDataSource().setFilter / removeAllItems ─
# group.getField("X").getContainerDataSource().setFilter(...)
# → setFieldDataFilter("X", ...)
rules.append(RewriteRule(
name="setFilter",
pattern=re.compile(
fref + NAV + r'getContainerDataSource\(\)' + NAV + r'setFilter\(([^)]*)\)',
re.DOTALL
),
replacement=r'setFieldDataFilter(\1, \2)',
))
# group.getField("X").getContainerDataSource().removeAllItems()
# → clearFieldData("X")
rules.append(RewriteRule(
name="removeAllItems_ds",
pattern=re.compile(
fref + NAV + r'getContainerDataSource\(\)' + NAV + r'removeAllItems\(\)'
),
replacement=r'clearFieldData(\1)',
))
# group.getField("X").removeAllItems() (无中间 getContainerDataSource)
# → clearFieldData("X") — 真实库下拉清空常见简写
rules.append(RewriteRule(
name="removeAllItems",
pattern=re.compile(fref + NAV + r'removeAllItems\(\)'),
replacement=r'clearFieldData(\1)',
))
# ── 2.9 getContainerDataSource (裸取数据源) ─────────────────
# group.getField("X").getContainerDataSource()
# → getFieldDataSource("X")
rules.append(RewriteRule(
name="getContainerDataSource",
pattern=re.compile(fref + NAV + r'getContainerDataSource\(\)'),
replacement=r'getFieldDataSource(\1)',
))
# ── 2.10 getDisplay ────────────────────────────────────────
# group.getField("X").getDisplay() → getFieldDisplay("X")
rules.append(RewriteRule(
name="getDisplay",
pattern=re.compile(fref + NAV + r'getDisplay\(\)'),
replacement=r'getFieldDisplay(\1)',
))
# ── 2.10b showAddButton(子表新增按钮显隐)──────────────────
# group.getField("X").showAddButton(b) → setSubTableAddButtonVisible("X", b)
rules.append(RewriteRule(
name="showAddButton",
pattern=re.compile(fref + NAV + r'showAddButton\(([^)]+)\)'),
replacement=r'setSubTableAddButtonVisible(\1, \2)',
))
# ── 2.10c setViewWithoutEditor(只读视图无编辑器)────────────
# group.getField("X").setViewWithoutEditor(b) → setFieldViewOnly("X", b)
rules.append(RewriteRule(
name="setViewWithoutEditor",
pattern=re.compile(fref + NAV + r'setViewWithoutEditor\(([^)]+)\)'),
replacement=r'setFieldViewOnly(\1, \2)',
))
# ── 2.10d setFilter / setFilterMap(字段下拉过滤,复杂参数)─
# 直接挂在字段句柄上的 setFilter(map) / setFilterMap(map)。
# 参数常含嵌套 [..] 与函数调用,无法用 [^)]+ 安全匹配,
# 改由平衡括号预处理 _rewrite_balanced_field_calls 处理(见下)。
# 此处不注册正则规则,留空说明保持登记完整性。
# ── 2.10e focus(字段聚焦)──────────────────────────────────
# group.getField("X").focus() → focusField("X")
rules.append(RewriteRule(
name="focus",
pattern=re.compile(fref + NAV + r'focus\(\)'),
replacement=r'focusField(\1)',
))
# ── 2.10f setWidth / setHeight(字段尺寸)───────────────────
# group.getField("X").setWidth(w) → setFieldWidth("X", w)
rules.append(RewriteRule(
name="setWidth",
pattern=re.compile(fref + NAV + r'setWidth\(([^)]+)\)'),
replacement=r'setFieldWidth(\1, \2)',
))
rules.append(RewriteRule(
name="setHeight",
pattern=re.compile(fref + NAV + r'setHeight\(([^)]+)\)'),
replacement=r'setFieldHeight(\1, \2)',
))
# ── 2.10h reload(字段数据源刷新)──────────────────────────
# group.getField("X").reload() → reloadField("X")
rules.append(RewriteRule(
name="reload",
pattern=re.compile(fref + NAV + r'reload\(\)'),
replacement=r'reloadField(\1)',
))
# ── 2.10i setConvertedValue(转换后赋值)────────────────────
# group.getField("X").setConvertedValue(v) → setFieldConvertedValue("X", v)
rules.append(RewriteRule(
name="setConvertedValue",
pattern=re.compile(fref + NAV + r'setConvertedValue\(([^)]+)\)'),
replacement=r'setFieldConvertedValue(\1, \2)',
))
# ── 2.10j setNullSelectionItemId(空选项 id)────────────────
# group.getField("X").setNullSelectionItemId(v) → setFieldNullSelection("X", v)
rules.append(RewriteRule(
name="setNullSelectionItemId",
pattern=re.compile(fref + NAV + r'setNullSelectionItemId\(([^)]+)\)'),
replacement=r'setFieldNullSelection(\1, \2)',
))
# ── 2.10k removeItem(删下拉项)─────────────────────────────
# group.getField("X").removeItem(v) → removeFieldItem("X", v)
rules.append(RewriteRule(
name="removeItem",
pattern=re.compile(fref + NAV + r'removeItem\(([^)]+)\)'),
replacement=r'removeFieldItem(\1, \2)',
))
# ── 2.10l showDeleteButton(子表删除按钮显隐)───────────────
# group.getField("X").showDeleteButton(b) → setSubTableDeleteButtonVisible("X", b)
rules.append(RewriteRule(
name="showDeleteButton",
pattern=re.compile(fref + NAV + r'showDeleteButton\(([^)]+)\)'),
replacement=r'setSubTableDeleteButtonVisible(\1, \2)',
))
# ── 2.10m getModifyButton().setVisible / getDetailButton().setVisible ─
# group.getField("X").getModifyButton().setVisible(b)
# → setSubTableModifyButtonVisible("X", b)
rules.append(RewriteRule(
name="getModifyButton_setVisible",
pattern=re.compile(
fref + NAV + r'getModifyButton\(\)' + NAV + r'setVisible\(([^)]+)\)'),
replacement=r'setSubTableModifyButtonVisible(\1, \2)',
))
rules.append(RewriteRule(
name="getDetailButton_setVisible",
pattern=re.compile(
fref + NAV + r'getDetailButton\(\)' + NAV + r'setVisible\(([^)]+)\)'),
replacement=r'setSubTableDetailButtonVisible(\1, \2)',
))
# ── 2.11 group.setReadOnly (组级) ──────────────────────────
# group.setReadOnly(b) / group?.setReadOnly(b) → setGroupReadOnly(b)
rules.append(RewriteRule(
name="group_setReadOnly",
pattern=re.compile(r'\bgroup\s*\??\.\s*setReadOnly\(([^)]+)\)'),
replacement=r'setGroupReadOnly(\1)',
))
# ── 2.12 group.setEnabled (组级) ───────────────────────────
rules.append(RewriteRule(
name="group_setEnabled",
pattern=re.compile(r'\bgroup\s*\??\.\s*setEnabled\(([^)]+)\)'),
replacement=r'setGroupEnabled(\1)',
))
# ── 2.13 Notification.show ─────────────────────────────────
# Notification.show(msg) / Notification.show(msg, Type)
# → showToast(msg) / showToast(msg, type)
rules.append(RewriteRule(
name="Notification_show",
pattern=re.compile(
r'\bNotification\.show\(([^)]+)\)',
re.DOTALL
),
replacement=r'showToast(\1)',
))
# ── 2.14 enableButton ──────────────────────────────────────
# enableButton("BTN", b) — 已是 S2 形态,保持不变(作为无操作规则)
# 此处不改写,仅识别(不在 S3 剩余检测里误报)
return rules
# 单例规则表(模块加载时编译一次)
REWRITE_RULES: List[RewriteRule] = _make_field_rules()
# ──────────────────────────────────────────────
# 2bis. 平衡括号字段调用预处理
# 处理参数含嵌套 [..]/(..) 的字段句柄方法(setFilter/setFilterMap),
# 正则的 [^)]+ 会在首个 ) 处截断,故用括号配平扫描。
# 形态: group.getField("X")[?.|.]<method>( ...balanced... )
# 映射: setFilter→setFieldFilter, setFilterMap→setFieldFilterMap
# ──────────────────────────────────────────────
_BALANCED_FIELD_VERBS = {
"setFilter": "setFieldFilter",
"setFilterMap": "setFieldFilterMap",
}
_BALANCED_HEAD_RE = re.compile(
r'group\.getField\((["\'][^"\']+["\'])\)\s*\??\.\s*(setFilter|setFilterMap)\('
)
def _match_balanced(text: str, open_idx: int) -> int:
"""从 text[open_idx]=='(' 起,返回配平的 ')' 索引;失败返回 -1。"""
depth = 0
i = open_idx
n = len(text)
while i < n:
ch = text[i]
if ch == '(':
depth += 1
elif ch == ')':
depth -= 1
if depth == 0:
return i
i += 1
return -1
def _rewrite_balanced_field_calls(text: str) -> Tuple[str, int]:
"""改写复杂参数字段调用(setFilter/setFilterMap)。返回 (新文本, 次数)。"""
count = 0
out = []
pos = 0
while True:
m = _BALANCED_HEAD_RE.search(text, pos)
if not m:
out.append(text[pos:])
break
field, verb = m.group(1), m.group(2)
open_idx = m.end() - 1 # 指向方法名后的 '('
close_idx = _match_balanced(text, open_idx)
if close_idx == -1:
# 括号不配平,放弃改写该处,原样输出并跳过
out.append(text[pos:m.end()])
pos = m.end()
continue
arg = text[open_idx + 1:close_idx]
facade = _BALANCED_FIELD_VERBS[verb]
out.append(text[pos:m.start()])
out.append(f'{facade}({field}, {arg})')
pos = close_idx + 1
count += 1
return ''.join(out), count
# ──────────────────────────────────────────────
# 2ter. 下拉选项填充 idiom → addFieldOption(平衡括号)
# 形态(改写后): getFieldDataSource("F")?.addItem(V).getItemProperty("des").setValue(D)
# 映射: addFieldOption("F", V, D)
# 说明: 真实库构造下拉选项的标准写法(250/271 形态一致,属性键恒为 "des")。
# 此为确定性 1:1 语句转换——把"向 F 字段的数据源加一个值/显示项"
# 折叠为 facade 调用,不臆测循环体,逐条安全。
# 前置: 需先把 `def ic = getFieldDataSource("F")` 句柄变量内联回字面形态
# (见 _inline_datasource_handles)。
# ──────────────────────────────────────────────
# 头: getFieldDataSource("F")?.addItem( —— 捕获字段名,定位 addItem 起始括号
_OPTION_HEAD_RE = re.compile(
r'getFieldDataSource\((["\'][^"\']+["\'])\)\s*\??\.\s*addItem\('
)
# addItem 参数闭合后紧跟: [?.|.]getItemProperty("des")[?.|.]setValue( D )
# 真实库 getItemProperty/setValue 之间同样存在 ?. 安全导航变体。
_OPTION_TAIL_RE = re.compile(
r'\s*\??\.\s*getItemProperty\(\s*["\']des["\']\s*\)\s*\??\.\s*setValue\('
)
def _rewrite_option_population(text: str) -> Tuple[str, int]:
"""改写下拉选项填充 idiom → addFieldOption。返回 (新文本, 次数)。"""
count = 0
out = []
pos = 0
while True:
m = _OPTION_HEAD_RE.search(text, pos)
if not m:
out.append(text[pos:])
break
field = m.group(1)
ai_open = m.end() - 1 # addItem 的 '('
ai_close = _match_balanced(text, ai_open)
if ai_close == -1:
out.append(text[pos:m.end()]); pos = m.end(); continue
value_arg = text[ai_open + 1:ai_close]
tail = _OPTION_TAIL_RE.match(text, ai_close + 1)
if not tail:
# 仅 addItem(...) 无 getItemProperty("des").setValue —— 不属本 idiom,跳过
out.append(text[pos:m.end()]); pos = m.end(); continue
sv_open = tail.end() - 1 # setValue 的 '('
sv_close = _match_balanced(text, sv_open)
if sv_close == -1:
out.append(text[pos:m.end()]); pos = m.end(); continue
desc_arg = text[sv_open + 1:sv_close]
out.append(text[pos:m.start()])
out.append(f'addFieldOption({field}, {value_arg}, {desc_arg})')
pos = sv_close + 1
count += 1
return ''.join(out), count
# 数据源句柄变量赋值行(改写后): def ic = getFieldDataSource("F");
_DS_ASSIGN_LINE_RE = re.compile(
r'^[ \t]*(?:def\s+|final\s+|var\s+|Object\s+)?(\w+)\s*=\s*'
r'(getFieldDataSource\(["\'][^"\']+["\']\))[ \t]*;?[ \t]*(?://[^\n]*)?$',
re.MULTILINE,
)
def _inline_datasource_handles(text: str) -> Tuple[str, List[str]]:
"""
将单赋值数据源句柄变量内联展开,使 addFieldOption 模式可匹配。
def ic = getFieldDataSource("F")
ic?.addItem(...)...
→ getFieldDataSource("F")?.addItem(...)...
复用与字段句柄内联相同的"持有者引用"语义(仅替换 var. / var?.)。
"""
inlined: List[str] = []
lines = text.split('\n')
result_lines = list(lines)
assignments: List[Tuple[int, str, str]] = []
for idx, line in enumerate(lines):
m = _DS_ASSIGN_LINE_RE.match(line)
if m:
assignments.append((idx, m.group(1), m.group(2)))
for assign_idx, var, fexpr in reversed(assignments):
ref_re = re.compile(r'\b' + re.escape(var) + r'\b(?=\s*\??\.)')
replaced_any = False
for i in range(assign_idx + 1, len(result_lines)):
cur = result_lines[i]
m2 = _DS_ASSIGN_LINE_RE.match(cur)
if m2 and m2.group(1) == var:
break
if ref_re.search(cur):
result_lines[i] = ref_re.sub(fexpr, cur)
replaced_any = True
if replaced_any:
result_lines[assign_idx] = ''
inlined.append(
f"内联数据源句柄变量 `{var}` → `{fexpr}`(原第 {assign_idx+1} 行)"
)
return '\n'.join(result_lines), inlined
# ──────────────────────────────────────────────
# 3. S3 残留检测(改写后仍有未处理的 Vaadin API)
#
# 判定原则: 凡仍能匹配 *未被改写的 Vaadin UI 句柄链* 即残留。
# - group.getField( 仍存在 → 必有未覆盖动词,残留。
# - group.setReadOnly / setEnabled(含 ?.)仍存在 → 残留。
# - 容器/Item 级数据填充 idiom(getContainerDataSource / addItem /
# getItemProperty / removeAllItems / setFilter)仍存在 → 残留。
# 这些直接操作 Vaadin Container/Item 数据模型,不在自动改写边界内,
# 诚实保留为 PARTIAL,不强行转换(避免错改)。
# 注意: facade 自身的 setFieldValue/getFieldValue 等 *不带句柄前缀* 的形态
# 不应触发残留,故这里只匹配 group.getField( 句柄链与容器/Item 链。
# ──────────────────────────────────────────────
RESIDUAL_S3_PATTERNS = [
# 任何残留的字段句柄链(含 ?.,含未覆盖动词)
re.compile(r'group\.getField\('),
# 组级残留(含安全导航)
re.compile(r'\bgroup\s*\??\.\s*setReadOnly\('),
re.compile(r'\bgroup\s*\??\.\s*setEnabled\('),
re.compile(r'\bgroup\s*\??\.\s*setVisible\('),
re.compile(r'\bNotification\.show\('),
# 容器 / Item 级数据填充 idiom(保留为人工,不自动转)
re.compile(r'\.getContainerDataSource\('),
re.compile(r'\.getPropertyDataSource\('),
re.compile(r'\.getItemProperty\('),
re.compile(r'\.addItem\('),
re.compile(r'\.removeAllItems\('),
re.compile(r'\.setFilter\('),
]
# ──────────────────────────────────────────────
# 4. 内联单赋值字段句柄变量(两遍处理)
#
# def f = group.getField("X") // 或 def fld = ...
# f.setVisible(true)
# →
# group.getField("X").setVisible(true)
# ──────────────────────────────────────────────
# 匹配单行字段句柄赋值:
# def f = group.getField("X")
# final fld = group.getField('Y')
# f = group.getField("Z")
# 使用 MULTILINE 在完整文本中逐行匹配,不依赖行末换行符
# 匹配字段句柄赋值行(允许行末分号 / 注释 / 普通点或安全导航不触发——仅裸取句柄)。
# 真实库 548 处赋值写成 `def isShare = group.getField("ISSHARE");`(带分号),
# 旧正则用 `$` 收尾不允许分号,导致全部漏内联。这里允许尾随 `;` 与空白。
_FIELD_ASSIGN_LINE_RE = re.compile(
r'^[ \t]*(?:def\s+|final\s+|String\s+|Object\s+|var\s+)?(\w+)\s*=\s*'
r'(group\.getField\(["\'][^"\']+["\']\))[ \t]*;?[ \t]*(?://[^\n]*)?$',
re.MULTILINE,
)
def _inline_field_handles(text: str) -> Tuple[str, List[str]]:
"""
将单赋值字段句柄变量内联展开。
返回 (展开后文本, 内联操作说明列表)。
只处理在赋值行之后、**下一个同名赋值之前**出现的引用。
引用替换同时覆盖普通点 `var.foo()` 与安全导航 `var?.foo()`:
真实库句柄变量后续多用 `?.`(如 isShare?.setReadOnly(...)),
内联时把 `var?.` 还原为 `group.getField("ISSHARE")?.`,
保留导航符交由后续字段规则统一改写。
"""
inlined: List[str] = []
lines = text.split('\n')
result_lines = list(lines)
# 收集所有赋值:(行号, 变量名, 字段表达式)
assignments: List[Tuple[int, str, str]] = []
for idx, line in enumerate(lines):
m = _FIELD_ASSIGN_LINE_RE.match(line)
if m:
assignments.append((idx, m.group(1), m.group(2)))
# 倒序处理(避免行号偏移影响索引)
for assign_idx, var, fexpr in reversed(assignments):
# 只替换作为"句柄持有者"的引用:var. 或 var?.(后面紧跟方法链),
# 不误伤把 var 当普通值用的场景(如 `if (var == null)`)。
# 替换时仅吃掉变量名,保留其后的 `.`/`?.`,故用零宽断言。
ref_re = re.compile(r'\b' + re.escape(var) + r'\b(?=\s*\??\.)')
replaced_any = False
for i in range(assign_idx + 1, len(result_lines)):
cur = result_lines[i]
# 遇到同名重赋值则停止
m2 = _FIELD_ASSIGN_LINE_RE.match(cur)
if m2 and m2.group(1) == var:
break
if ref_re.search(cur):
result_lines[i] = ref_re.sub(fexpr, cur)
replaced_any = True
if replaced_any:
# 删除赋值行(置为空行,保留行号结构)
result_lines[assign_idx] = ''
inlined.append(
f"内联字段句柄变量 `{var}` → `{fexpr}`(原第 {assign_idx+1} 行)"
)
return '\n'.join(result_lines), inlined
# ──────────────────────────────────────────────
# 5. 主改写入口
# ──────────────────────────────────────────────
@dataclass
class RewriteDetail:
rule_name: str
original: str
rewritten: str
count: int = 1
def rewrite_script(source: str) -> Tuple[str, List[RewriteDetail], str]:
"""
对输入的 Groovy 脚本文本执行 S3 改写。
返回:
(改写后文本, 改写明细列表, 分类标签)
分类标签: FULL_AUTO / PARTIAL / HARD / NO_S3
"""
details: List[RewriteDetail] = []
# ── 5.1 硬 S3 检测 ────────────────────────────────────────
hard_reasons = []
for pattern_str, reason in HARD_S3_PATTERNS:
if re.search(pattern_str, source):
hard_reasons.append(reason)
if hard_reasons:
details.append(RewriteDetail(
rule_name="HARD_DETECTION",
original="; ".join(hard_reasons),
rewritten="[人工处理]",
count=len(hard_reasons),
))
return source, details, "HARD"
# ── 5.2 无 S3 快检 ────────────────────────────────────────
def _has_s3(text: str) -> bool:
for pat in RESIDUAL_S3_PATTERNS:
if pat.search(text):
return True
# 还检查 Notification.show
if re.search(r'\bNotification\.show\(', text):
return True
return False
if not _has_s3(source):
return source, details, "NO_S3"
# ── 5.3 内联字段句柄变量(第一遍)────────────────────────
working, inline_notes = _inline_field_handles(source)
for note in inline_notes:
details.append(RewriteDetail(
rule_name="inline_field_handle",
original=note,
rewritten="[已内联]",
))
# ── 5.4 平衡括号字段调用(setFilter/setFilterMap 复杂参数)─
working, bcount = _rewrite_balanced_field_calls(working)
if bcount > 0:
details.append(RewriteDetail(
rule_name="balanced_setFilter",
original=f"命中 {bcount} 处",
rewritten="→ 已替换",
count=bcount,
))
# ── 5.5 应用规则表(第二遍)──────────────────────────────
for rule in REWRITE_RULES:
new_text, count = _apply_rule(working, rule)
if count > 0:
details.append(RewriteDetail(
rule_name=rule.name,
original=f"命中 {count} 处",
rewritten=f"→ 已替换",
count=count,
))
working = new_text
# ── 5.6 再次内联(处理可能被改写暴露的新变量引用)─────────
working2, inline_notes2 = _inline_field_handles(working)
for note in inline_notes2:
details.append(RewriteDetail(
rule_name="inline_field_handle_pass2",
original=note,
rewritten="[已内联 pass2]",
))
working = working2
# ── 5.7 再次应用规则(处理第二遍内联暴露的模式)──────────
if inline_notes2:
working, bcount2 = _rewrite_balanced_field_calls(working)
if bcount2 > 0:
details.append(RewriteDetail(
rule_name="balanced_setFilter_pass2",
original=f"命中 {bcount2} 处",
rewritten="→ 已替换",
count=bcount2,
))
for rule in REWRITE_RULES:
new_text, count = _apply_rule(working, rule)
if count > 0:
details.append(RewriteDetail(
rule_name=rule.name + "_pass2",
original=f"命中 {count} 处",
rewritten=f"→ 已替换",
count=count,
))
working = new_text
# ── 5.8 下拉选项填充 idiom(数据源句柄内联 + addFieldOption)─
# 此时 getContainerDataSource() 已被规则改写为 getFieldDataSource(),
# 先内联数据源句柄变量,再把 addItem().getItemProperty("des").setValue()
# 链折叠为 addFieldOption。
working, ds_notes = _inline_datasource_handles(working)
for note in ds_notes:
details.append(RewriteDetail(
rule_name="inline_datasource_handle",
original=note,
rewritten="[已内联数据源]",
))
working, opt_count = _rewrite_option_population(working)
if opt_count > 0:
details.append(RewriteDetail(
rule_name="addFieldOption",
original=f"命中 {opt_count} 处",
rewritten="→ 已折叠为 addFieldOption",
count=opt_count,
))
# ── 5.9 分类 ──────────────────────────────────────────────
if not _has_s3(working):
label = "FULL_AUTO"
else:
label = "PARTIAL"
return working, details, label
def _apply_rule(text: str, rule: RewriteRule) -> Tuple[str, int]:
"""应用单条规则,返回 (新文本, 替换次数)。"""
count = 0
def replacer(m: re.Match) -> str:
nonlocal count
count += 1
return m.expand(rule.replacement)
new_text = rule.pattern.sub(replacer, text)
return new_text, count
# ──────────────────────────────────────────────
# 6. CLI 入口(便于快速测试单文件)
# ──────────────────────────────────────────────
if __name__ == "__main__":
import sys
if len(sys.argv) < 2:
print("用法: python rewrite.py <groovy文件>")
sys.exit(1)
with open(sys.argv[1], encoding="utf-8") as fh:
src = fh.read()
result, dets, lbl = rewrite_script(src)
print(f"=== 分类: {lbl} ===")
for d in dets:
print(f" [{d.rule_name}] {d.original} {d.rewritten} (×{d.count})")
print("=== 改写结果 ===")
print(result)