infinity-data 1.1.0__tar.gz → 2.0.0__tar.gz

{infinity_data-1.1.0/src/infinity_data.egg-info → infinity_data-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: infinity-data
-Version: 1.1.0
+Version: 2.0.0
 Summary: InfinityData：声明式配置语言（.infd/.inft）的 Python 编译器库
 Author: infinity_system: yin_bailiang
 License: MIT

{infinity_data-1.1.0 → infinity_data-2.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "infinity-data"
-version = "1.1.0"
+version = "2.0.0"
 description = "InfinityData：声明式配置语言（.infd/.inft）的 Python 编译器库"
 readme = "README.md"
 license = { text = "MIT" }
@@ -57,6 +57,9 @@ package-dir = {"" = "src"}
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+infinity_data = ["py.typed"]
+
 [tool.ruff]
 line-length = 120
 target-version = "py312"
@@ -89,3 +92,8 @@ reportMissingImports = "error"
 exclude = ["**/node_modules", "**/__pycache__", "**/.*", ".venv"]
 venvPath = "."
 venv = ".venv"
+
+[tool.interrogate]
+fail-under = 70
+# 测试函数名自解释，docstring 可选；产品代码（src）不豁免
+ignore-regex = ["^test_"]

{infinity_data-1.1.0 → infinity_data-2.0.0}/src/infinity_data/emit/converter.py

@@ -48,6 +48,7 @@ def reduce_value(val: StdValue, *, keep_null: bool = True) -> Any:
 
 
 def _reduce_literal(lit: StdLiteral) -> Any:
+    """字面量降维：null / noexist → None；其余返回原始值。"""
     match lit.kind:
         case 'null' | 'noexist':
             return None

infinity_data-2.0.0/src/infinity_data/infra/__init__.py

@@ -0,0 +1,10 @@
+"""基础设施层：诊断、位置、源码来源与 LL(1) 流抽象。
+
+最底层依赖（不依赖 tokenizer / parser / semantic）：诊断注册表与收集器、
+SourceRange / SourceInfo、File 抽象（磁盘 / 内存）、LL1Stream 泛型流。
+"""
+
+from infinity_data.infra.diagnostics import Diagnostic, DiagnosticCollector, Severity
+from infinity_data.infra.ll1_stream import LL1Stream
+
+__all__ = ['Diagnostic', 'DiagnosticCollector', 'Severity', 'LL1Stream']

{infinity_data-1.1.0 → infinity_data-2.0.0}/src/infinity_data/infra/diagnostics.py

@@ -58,6 +58,7 @@ class Diagnostic:
 
     @property
     def location(self) -> str:
+        """格式化的源码位置（``file:line:col``，零宽 / 区间统一）。"""
         return format_location(self.source)
 
     @property

{infinity_data-1.1.0 → infinity_data-2.0.0}/src/infinity_data/infra/file.py

@@ -35,7 +35,7 @@ class File:
 
     @property
     def identity(self) -> str:
-        """唯一身份（循环导入防护 / 模板身份（TemplateKey）基础，含来源路径）。"""
+        """唯一身份（循环导入防护 / parse_cache 键；模板身份已改用依赖闭包哈希，§2.5）。"""
         raise NotImplementedError
 
     def content_hash(self) -> str:
@@ -49,13 +49,16 @@ class DiskFile(File):
 
     @property
     def path(self) -> Path:
+        """完整路径（``name`` 的 :class:`Path` 视图）。"""
         return Path(self.name)
 
     def read(self) -> str:
+        """读取源码内容（utf-8）。"""
         return self.path.read_text(encoding='utf-8')
 
     @property
     def identity(self) -> str:
+        """解析后绝对路径（循环导入防护 / parse_cache 键）。"""
         return str(self.path.resolve())
 
     @classmethod
@@ -67,11 +70,12 @@ class DiskFile(File):
 
 @dataclass(frozen=True)
 class MemFile(File):
-    """内存源码（测试/嵌入式场景）。身份 = 根路径:mem:内容hash（含路径）。"""
+    """内存源码（测试/嵌入式场景）。身份 = 根路径:mem:内容hash（循环导入防护 / 缓存键）。"""
 
     content: str
 
     def read(self) -> str:
+        """返回内存内容。"""
         return self.content
 
     def chars(self) -> Iterable[str]:
@@ -80,4 +84,5 @@ class MemFile(File):
 
     @property
     def identity(self) -> str:
+        """身份 = 根路径:mem:内容hash（循环导入防护 / 缓存键）。"""
         return str(self.root_path.resolve()) + ':mem:' + self.content_hash()

{infinity_data-1.1.0 → infinity_data-2.0.0}/src/infinity_data/parser/__init__.py

@@ -40,7 +40,10 @@ from infinity_data.parser.models import (
     TemplateField,
     TemplateImportItem,
     TemplateImportStmt,
+    UnpackValue,
     Value,
+    VarStmt,
+    walk,
 )
 from infinity_data.parser.parser import Parser
 
@@ -75,5 +78,8 @@ __all__ = [
     'TemplateField',
     'TemplateImportItem',
     'TemplateImportStmt',
+    'UnpackValue',
     'Value',
+    'VarStmt',
+    'walk',
 ]

{infinity_data-1.1.0 → infinity_data-2.0.0}/src/infinity_data/parser/diagnostics.py

@@ -26,6 +26,16 @@ register_diagnostic_define(
         '[{location}] 期望 {expected}，实际为 {actual}',
         en='[{location}] expected {expected}, got {actual}',
     ),
+    diagnostic_define(
+        'parse.expand_outside_call',
+        '[{location}] ... 只能在模板调用参数上下文使用（展开轴 / 展开传播，§2.8）',
+        en='[{location}] ... is only valid in template call argument context (expand axis / propagate)',
+    ),
+    diagnostic_define(
+        'parse.expand_suffix_order',
+        '[{location}] ... 后不能再跟 ^（调用级后缀顺序固定：^ 笛卡尔积 → ... 传播，§2.8）',
+        en='[{location}] ^ cannot follow ... (call-level suffix order: ^ cartesian → ... propagate)',
+    ),
     diagnostic_define(
         'parse.template_arg_order',
         '[{location}] 位置参数不能出现在命名参数之后',
@@ -48,6 +58,11 @@ register_diagnostic_define(
         '[{location}] 导入项之间必须用逗号分隔（import 列表不接受换行/空格分隔）',
         en='[{location}] import items must be separated by commas (newlines/spaces are not allowed)',
     ),
+    diagnostic_define(
+        'parse.import_requires_newline',
+        '[{location}] 导入语句必须以换行结尾（同一行逗号后不能再接其他语句）',
+        en='[{location}] import statement must end with a newline (cannot be followed by more tokens on the same line)',
+    ),
     diagnostic_define(
         'parse.value_field',
         '[{location}] 值位置出现字段定义 {name}（外层数组/对象未闭合）',