From 1f51665e42d240a8608f2ec7ebd20b0ea686b246 Mon Sep 17 00:00:00 2001
From: MikiVL <mikivl@MikiVLdeMacBook-Air.local>
Date: Tue, 5 May 2026 05:52:42 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=AE=9E=E7=8E=B0=E6=A8=A1=E6=9D=BF?=
 =?UTF-8?q?=E8=A7=A3=E6=9E=90=EF=BC=8C=E8=87=AA=E5=8A=A8=E8=AF=86=E5=88=AB?=
 =?UTF-8?q?=20{{=E5=8D=A0=E4=BD=8D=E7=AC=A6}}?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 python/parser.py                    |  25 +++++++++++++++++++++++-
 tests/create_fixtures.py            |  10 ++++++++++
 tests/fixtures/sample_template.xlsx | Bin 0 -> 4866 bytes
 tests/python/test_parser.py         |  29 +++++++++++++++++++++++++++-
 4 files changed, 62 insertions(+), 2 deletions(-)
 create mode 100644 tests/create_fixtures.py
 create mode 100644 tests/fixtures/sample_template.xlsx

diff --git a/python/parser.py b/python/parser.py
index fdffa2a..6737d44 100644
--- a/python/parser.py
+++ b/python/parser.py
@@ -1 +1,24 @@
-# placeholder
+import re
+from openpyxl import load_workbook
+
+PLACEHOLDER_RE = re.compile(r"\{\{(.+?)\}\}")
+
+def parse_template(file_path: str) -> dict:
+    wb = load_workbook(file_path, data_only=False)
+    sheets = wb.sheetnames
+    placeholders = []
+
+    for sheet_name in sheets:
+        ws = wb[sheet_name]
+        for row in ws.iter_rows():
+            for cell in row:
+                if cell.value and isinstance(cell.value, str):
+                    m = PLACEHOLDER_RE.search(cell.value)
+                    if m:
+                        placeholders.append({
+                            "name": m.group(1),
+                            "sheet": sheet_name,
+                            "cell": cell.coordinate,
+                        })
+
+    return {"sheets": sheets, "placeholders": placeholders}
diff --git a/tests/create_fixtures.py b/tests/create_fixtures.py
new file mode 100644
index 0000000..671fdc4
--- /dev/null
+++ b/tests/create_fixtures.py
@@ -0,0 +1,10 @@
+from openpyxl import Workbook
+
+wb = Workbook()
+ws = wb.active
+ws.title = "Sheet1"
+ws["B3"] = "{{编号}}"
+ws["C5"] = "{{姓名}}"
+ws["D7"] = "normal_value"  # not a placeholder, should NOT be detected
+wb.save("tests/fixtures/sample_template.xlsx")
+print("fixture created")
diff --git a/tests/fixtures/sample_template.xlsx b/tests/fixtures/sample_template.xlsx
new file mode 100644
index 0000000000000000000000000000000000000000..c6d220a9b73c1427c6f915ed73e4c76044575590
GIT binary patch
literal 4866
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

literal 0
HcmV?d00001

diff --git a/tests/python/test_parser.py b/tests/python/test_parser.py
index fdffa2a..537fcfb 100644
--- a/tests/python/test_parser.py
+++ b/tests/python/test_parser.py
@@ -1 +1,28 @@
-# placeholder
+import sys, os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "../../python"))
+
+from parser import parse_template
+
+FIXTURE = os.path.join(os.path.dirname(__file__), "../fixtures/sample_template.xlsx")
+
+def test_returns_sheets():
+    result = parse_template(FIXTURE)
+    assert "sheets" in result
+    assert "Sheet1" in result["sheets"]
+
+def test_detects_placeholders():
+    result = parse_template(FIXTURE)
+    names = [p["name"] for p in result["placeholders"]]
+    assert "编号" in names
+    assert "姓名" in names
+
+def test_ignores_non_placeholders():
+    result = parse_template(FIXTURE)
+    names = [p["name"] for p in result["placeholders"]]
+    assert "normal_value" not in names
+
+def test_placeholder_has_cell_info():
+    result = parse_template(FIXTURE)
+    biaohao = next(p for p in result["placeholders"] if p["name"] == "编号")
+    assert biaohao["sheet"] == "Sheet1"
+    assert biaohao["cell"] == "B3"