Files
eip4-platform/tools/s3_rewriter/rewrite.py
zhengwr c174fbdf83 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>
2026-06-11 11:20:01 +08:00

777 lines
34 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
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)