python-library-ralf-model 0.1.0__tar.gz → 0.1.1__tar.gz

python_library_ralf_model-0.1.1/.gitignore

@@ -0,0 +1,21 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+.env.*
+!.env.example
+# packages 示例本地密钥（*.example 为模板，可提交）
+packages/**/examples/**/.env
+!packages/**/examples/**/.env.example
+packages/**/examples/**/mcp.json
+!packages/**/examples/**/mcp.json.example
+packages/**/examples/**/.sandbox/
+.pytest_cache/
+config.yaml
+logs/
+.cursor/
+uv.lock

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-library-ralf-model
-Version: 0.1.0
+Version: 0.1.1
 Requires-Python: >=3.10
 Requires-Dist: pydantic<3,>=2.0
 Description-Content-Type: text/markdown

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-library-ralf-model"
-version = "0.1.0"
+version = "0.1.1"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/ralf_model/errors.py

@@ -10,10 +10,22 @@ class RalfError(Exception):
 class RalfParseError(RalfError):
     """文本不符合预期语法或词法。"""
 
-    def __init__(self, message: str, *, line: int, col: int) -> None:
-        super().__init__(f"{message} (行 {line}, 列 {col})")
+    def __init__(
+        self,
+        message: str,
+        *,
+        line: int,
+        col: int,
+        path: Path | None = None,
+    ) -> None:
+        loc = f"行 {line}, 列 {col}"
+        if path is not None:
+            loc = f"{path}: {loc}"
+        super().__init__(f"{message} ({loc})")
+        self.message = message
         self.line = line
         self.col = col
+        self.path = path
 
 
 class RalfSourceError(RalfError):

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/ralf_model/io.py

@@ -20,9 +20,13 @@ def load_ralf_file(
     p = Path(path).resolve()
     text = p.read_text(encoding=encoding)
     inc = tuple(Path(x).resolve() for x in (include_paths or ()))
+    line_sources: list[Path] | None = None
     if expand_source:
-        text = expand_ralf_sources(text, current_file=p, include_paths=inc, encoding=encoding)
-    return parse_ralf(text)
+        text, line_sources = expand_ralf_sources(
+            text, current_file=p, include_paths=inc, encoding=encoding
+        )
+        return parse_ralf(text, line_sources=line_sources)
+    return parse_ralf(text, path=p)
 
 
 def loads_ralf(
@@ -38,13 +42,14 @@ def loads_ralf(
     virtual = bd / "__inline__.ralf"
     inc = tuple(Path(x).resolve() for x in (include_paths or ()))
     if expand_source:
-        text = expand_ralf_sources(
+        text, line_sources = expand_ralf_sources(
             text,
             current_file=virtual,
             include_paths=inc,
             encoding=encoding,
         )
-    return parse_ralf(text)
+        return parse_ralf(text, line_sources=line_sources)
+    return parse_ralf(text, path=virtual)
 
 
 def dump_ralf_file(doc: RalfDocument, path: str | Path, *, encoding: str = "utf-8") -> None:

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/ralf_model/parse.py

@@ -1,18 +1,28 @@
 from __future__ import annotations
 
 import re
+from collections.abc import Sequence
+from pathlib import Path
 
 from ralf_model.errors import RalfParseError
 from ralf_model.nodes import BlockNode, FieldNode, RalfDocument, RegisterNode
 
 
 class _Parser:
-    def __init__(self, text: str) -> None:
+    def __init__(
+        self,
+        text: str,
+        *,
+        path: Path | None = None,
+        line_sources: Sequence[Path] | None = None,
+    ) -> None:
         self._s = text
         self._n = len(text)
         self._i = 0
         self.line = 1
         self.col = 1
+        self._path = path
+        self._line_sources = line_sources
 
     def _advance(self, n: int = 1) -> None:
         for _ in range(n):
@@ -30,7 +40,10 @@ class _Parser:
         return self._s[j] if j < self._n else None
 
     def _error(self, msg: str) -> None:
-        raise RalfParseError(msg, line=self.line, col=self.col)
+        path = self._path
+        if self._line_sources and 0 < self.line <= len(self._line_sources):
+            path = self._line_sources[self.line - 1]
+        raise RalfParseError(msg, line=self.line, col=self.col, path=path)
 
     def skip_ws_and_comments(self) -> None:
         while self._i < self._n:
@@ -519,9 +532,14 @@ def _parse_verilog_sized(s: str, i: int) -> tuple[int, int]:
 _VER_WS = re.compile(r"\s+")
 
 
-def parse_ralf(text: str) -> RalfDocument:
+def parse_ralf(
+    text: str,
+    *,
+    path: Path | None = None,
+    line_sources: Sequence[Path] | None = None,
+) -> RalfDocument:
     """将 RALF 源文本解析为 `RalfDocument`。"""
-    p = _Parser(text)
+    p = _Parser(text, path=path, line_sources=line_sources)
     doc = p.parse_document()
     return doc
 

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/ralf_model/source_expand.py

@@ -109,11 +109,13 @@ def expand_ralf_sources(
     include_paths: Sequence[Path] = (),
     encoding: str = "utf-8",
     _chain: tuple[Path, ...] = (),
-) -> str:
+) -> tuple[str, list[Path]]:
     """将 Tcl 风格 ``source path`` 递归展开为单段 RALF 文本后再交给 ``parse_ralf``。
 
     ``current_file`` 用于确定相对路径的基准目录（通常为 ``path.parent``），并参与循环检测。
     从内存加载字符串时可使用 ``base_dir / \"__inline__.ralf\"`` 这类占位路径。
+
+    返回 ``(展开后文本, 行来源)``：``行来源[i]`` 对应展开结果第 ``i+1`` 行的源文件路径。
     """
     cf = current_file.resolve()
     if cf in _chain:
@@ -123,15 +125,17 @@ def expand_ralf_sources(
     inc = tuple(Path(p).resolve() for p in include_paths)
 
     out: list[str] = []
+    line_sources: list[Path] = []
     for line in text.splitlines(keepends=True):
         spec = _parse_source_argument(line)
         if spec is None:
             out.append(line)
+            line_sources.append(cf)
             continue
 
         inner_path = resolve_source_path(spec, base_dir=cf.parent, include_paths=inc)
         inner_text = inner_path.read_text(encoding=encoding)
-        expanded_inner = expand_ralf_sources(
+        expanded_inner, inner_sources = expand_ralf_sources(
             inner_text,
             current_file=inner_path,
             include_paths=inc,
@@ -139,7 +143,9 @@ def expand_ralf_sources(
             _chain=chain,
         )
         out.append(expanded_inner)
+        line_sources.extend(inner_sources)
         if expanded_inner and not expanded_inner.endswith("\n"):
             out.append("\n")
+            line_sources.append(inner_sources[-1] if inner_sources else inner_path)
 
-    return "".join(out)
+    return "".join(out), line_sources

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/tests/test_ralf_model.py

@@ -1,8 +1,10 @@
 from __future__ import annotations
 
+import tempfile
 import unittest
+from pathlib import Path
 
-from ralf_model import dump_ralf, parse_ralf
+from ralf_model import RalfParseError, dump_ralf, load_ralf_file, parse_ralf
 from ralf_model.parse import normalize_ralf_whitespace
 
 
@@ -176,5 +178,29 @@ block a {
         self.assertNotIn("//", n)
 
 
+class ParseErrorTests(unittest.TestCase):
+    def test_parse_error_includes_file_path(self) -> None:
+        with tempfile.TemporaryDirectory() as td:
+            bad = Path(td) / "bad.ralf"
+            bad.write_text("block x {\n  ???\n}\n", encoding="utf-8")
+            with self.assertRaises(RalfParseError) as ctx:
+                load_ralf_file(bad, expand_source=False)
+            self.assertIn(str(bad.resolve()), str(ctx.exception))
+
+    def test_parse_error_in_included_file(self) -> None:
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            inc = root / "inc"
+            inc.mkdir()
+            (inc / "broken.ralf").write_text("block y {\n  ???\n}\n", encoding="utf-8")
+            top = root / "top.ralf"
+            top.write_text('source "inc/broken.ralf"\n', encoding="utf-8")
+            broken = (inc / "broken.ralf").resolve()
+            with self.assertRaises(RalfParseError) as ctx:
+                load_ralf_file(top)
+            self.assertIn(str(broken), str(ctx.exception))
+            self.assertNotIn(str(top.resolve()), str(ctx.exception))
+
+
 if __name__ == "__main__":
     unittest.main()

{python_library_ralf_model-0.1.0 → python_library_ralf_model-0.1.1}/tests/test_source_include.py

@@ -51,7 +51,7 @@ class SourceIncludeTests(unittest.TestCase):
             top = root / "top.ralf"
             top.write_text('source "mid.ralf"\n', encoding="utf-8")
 
-            out = expand_ralf_sources(
+            out, _line_sources = expand_ralf_sources(
                 top.read_text(encoding="utf-8"),
                 current_file=top.resolve(),
                 include_paths=(),

python_library_ralf_model-0.1.0/.gitignore

@@ -1,12 +0,0 @@
-__pycache__/
-*.pyc
-*.pyo
-*.egg-info/
-dist/
-build/
-.venv/
-.env
-.pytest_cache/
-config.yaml
-logs/
-.cursor/