"""调整 Excel 公式中的单元格引用(插入/删除行列)。 基于 openpyxl 官方 Tokenizer 逐 token 重写,只动 RANGE——裸正则会犯的经典错误这里都不存在: - 函数名(LOG10(、ATAN2()是 OPEN token、字符串字面量是 TEXT token,永不触碰; - RANGE token 值自带 sheet 前缀(OTHER!D3:D9、'My Sheet'!A1),可以精确判断引用指向**哪张表**。 调整规则(对齐 Excel): - 无 sheet 前缀:公式所在表 == 目标表才动; - 有前缀:前缀 == 目标表才动;目标表公式引用其他表 → 不动(Excel 同样不动)。 - 插入(delete=False):端点 >= at → +count(区间两端独立移动 = Excel 的区间扩张)。 - 删除(count 行/列从 at 起):端点 >= at+count → -count;单引用落在删除区间内 → #REF!; 区间端点落在删除区间内 → 收缩(起点→at、终点→at-1),与 Excel 行为一致;区间整体被删 → #REF!。 - 绝对引用($A$1)同样移动——Excel 的插删会改写绝对引用(区别于复制填充)。 不静默改坏(遇到即 UserError 拒绝): - 外部簿引用([Book.xlsx]Sheet!A1); - 解析不了的结构化引用(Table1[金额] 之类)。 不调整(保持原样,SKILL.md 有说明): - 命名范围(Tokenizer 归为非 RANGE token,天然不动)。 """ import re from openpyxl.formula.tokenizer import Tokenizer from openpyxl.utils import column_index_from_string, get_column_letter from . import UserError # RANGE 端点形态:$?COL$?ROW / $ROW / $COL _CELL_EP = re.compile(r'^(\$?)([A-Za-z]{1,3})(\$?)(\d+)$') _ROW_EP = re.compile(r'^(\$?)(\d+)$') _COL_EP = re.compile(r'^(\$?)([A-Za-z]{1,3})$') # 带引号的 sheet 前缀:'My Sheet'!A1 _QUOTED_PREFIX = re.compile(r"^'([^']*)'!(.+)$", re.S) def _norm_sheet(name): return str(name).strip().lower() def _split_ref(value): """'OTHER!D3:D9' → ('OTHER', 'D3:D9');'D3' → (None, 'D3')。""" if value.startswith("'"): m = _QUOTED_PREFIX.match(value) if m: return m.group(1), m.group(2) raise UserError(f"不支持的引用语法:{value!r}") if '!' in value: sheet, rest = value.split('!', 1) if sheet.startswith('[') or '[' in sheet: raise UserError(f"不支持外部工作簿引用:{value!r}(请先把跨簿公式改成本表/本簿引用)") return sheet, rest return None, value def _endpoint_axis_shape(ep): """返回 (kind, col_letters_or_None, row_num_or_None, col_abs, row_abs)。""" m = _CELL_EP.match(ep) if m: col_abs, col, row_abs, row = m.groups() return 'cell', col.upper(), int(row), col_abs, row_abs m = _ROW_EP.match(ep) if m: return 'row', None, int(m.group(2)), '', m.group(1) m = _COL_EP.match(ep) if m: return 'col', m.group(2).upper(), None, m.group(1), '' raise UserError(f"不支持的引用语法(结构化引用/特殊形式):{ep!r}") def _shift_pair(nums, at, count, delete): """区间两端点在同一轴上的数值移动;返回 None 表示整体失效(#REF!)。""" out = [] for i, v in enumerate(nums): if not delete: out.append(v + count if v >= at else v) elif v < at: out.append(v) elif v < at + count: if len(nums) == 1: return [None] out.append(at if i == 0 else at - 1) else: out.append(v - count) if len(out) == 2 and out[1] < out[0]: return [None, None] return out def _shift_endpoint_set(eps, axis, at, count, delete): """移动一组端点(1 个=单引用,2 个=区间),返回新端点字符串列表。""" shapes = [_endpoint_axis_shape(e) for e in eps] nums = [] for kind, col, row, col_abs, row_abs in shapes: if kind == 'cell': nums.append(row if axis == 'row' else column_index_from_string(col)) elif kind == 'row': nums.append(row if axis == 'row' else None) else: # col nums.append(None if axis == 'row' else column_index_from_string(col)) if any(n is None for n in nums): return eps # 本轴不涉及的引用(整列引用遇行操作等)原样返回 moved = _shift_pair(nums, at, count, delete) if moved[0] is None: return ['#REF!'] if len(eps) == 1 else ['#REF!', '#REF!'] new_eps = [] for (kind, col, row, col_abs, row_abs), v in zip(shapes, moved): if kind == 'cell': if axis == 'row': new_eps.append(f'{col_abs}{col}{row_abs}{v}') else: new_eps.append(f'{col_abs}{get_column_letter(v)}{row_abs}{row}') elif kind == 'row': new_eps.append(f'{row_abs}{v}') else: new_eps.append(f'{col_abs}{get_column_letter(v)}') return new_eps def shift_formula(formula, owner_sheet, target_sheet, axis, at, count, delete=False): """重写一条公式中所有指向 target_sheet 的引用。 owner_sheet: 公式所在表的表名;axis: 'row' | 'col';at: 1-based 起始行/列。 未被命中的公式原串返回(不经 Tokenizer 重组,零副作用)。 """ if not isinstance(formula, str) or not formula.startswith('='): return formula try: items = Tokenizer(formula).items except UserError: raise except Exception: raise UserError(f"公式语法解析失败(不支持的公式形式):{formula!r}") items = Tokenizer(formula).items touched = False for tok in items: # openpyxl 3.1:引用格的判别是 type='OPERAND' + subtype='RANGE'(type 只到大类) if getattr(tok, 'subtype', None) != 'RANGE': continue if '#REF' in tok.value: continue # 已失效引用:Excel 不会再调整它,原样保留 sheet, body = _split_ref(tok.value) if sheet is None: points_target = _norm_sheet(owner_sheet) == _norm_sheet(target_sheet) else: points_target = _norm_sheet(sheet) == _norm_sheet(target_sheet) if not points_target: continue prefix_raw = tok.value[: len(tok.value) - len(body)] eps = body.split(':') if ':' in body else [body] if len(eps) > 2: raise UserError(f"不支持 3D/多段引用:{tok.value!r}") new_val = prefix_raw + ':'.join(_shift_endpoint_set(eps, axis, at, count, delete)) if new_val != tok.value: tok.value = new_val touched = True if not touched: return formula return '=' + ''.join(t.value for t in items)