infinity-data 3.2.0__tar.gz → 4.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. infinity_data-3.2.0/LICENSE → infinity_data-4.0.0/LICENSE.md +1 -1
  2. {infinity_data-3.2.0/src/infinity_data.egg-info → infinity_data-4.0.0}/PKG-INFO +46 -13
  3. {infinity_data-3.2.0 → infinity_data-4.0.0}/README.md +42 -11
  4. {infinity_data-3.2.0 → infinity_data-4.0.0}/pyproject.toml +24 -2
  5. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/__init__.py +3 -2
  6. infinity_data-4.0.0/src/infinity_data/infra/diagnostics.py +523 -0
  7. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/infra/file.py +13 -4
  8. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/infra/path.py +1 -1
  9. infinity_data-4.0.0/src/infinity_data/parser/diagnostics.py +455 -0
  10. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/parser/parser.py +162 -130
  11. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/parser/token_stream.py +4 -7
  12. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/pipeline.py +38 -19
  13. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/sandbox/__init__.py +22 -0
  14. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/sandbox/config.py +1 -1
  15. infinity_data-4.0.0/src/infinity_data/sandbox/errors.py +271 -0
  16. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/sandbox/mediator.py +28 -7
  17. infinity_data-4.0.0/src/infinity_data/sandbox/schema.py +24 -0
  18. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/builder/__init__.py +4 -1
  19. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/builder/builder.py +134 -122
  20. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/builder/models.py +17 -0
  21. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/constraints.py +7 -11
  22. infinity_data-4.0.0/src/infinity_data/semantic/diagnostics.py +1623 -0
  23. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/executor/executor.py +181 -54
  24. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/__init__.py +10 -9
  25. infinity_data-3.2.0/src/infinity_data/semantic/registry/_core.py → infinity_data-4.0.0/src/infinity_data/semantic/registry/core.py +20 -13
  26. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/dict_constraints.py +15 -8
  27. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/general.py +92 -53
  28. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/logic.py +18 -9
  29. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/types.py +68 -35
  30. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/identity.py +6 -3
  31. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/imports.py +81 -21
  32. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/models.py +3 -3
  33. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/resolver.py +53 -34
  34. infinity_data-4.0.0/src/infinity_data/tokenizer/diagnostics.py +254 -0
  35. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/finalizer.py +11 -6
  36. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/tokenizer.py +44 -66
  37. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/cli.py +26 -2
  38. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/language.py +41 -23
  39. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/server.py +6 -2
  40. {infinity_data-3.2.0 → infinity_data-4.0.0/src/infinity_data.egg-info}/PKG-INFO +46 -13
  41. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/SOURCES.txt +2 -2
  42. infinity_data-4.0.0/src/infinity_data.egg-info/requires.txt +7 -0
  43. infinity_data-3.2.0/src/infinity_data/infra/diagnostics.py +0 -214
  44. infinity_data-3.2.0/src/infinity_data/parser/diagnostics.py +0 -127
  45. infinity_data-3.2.0/src/infinity_data/sandbox/errors.py +0 -106
  46. infinity_data-3.2.0/src/infinity_data/sandbox/schema.py +0 -21
  47. infinity_data-3.2.0/src/infinity_data/semantic/diagnostics.py +0 -278
  48. infinity_data-3.2.0/src/infinity_data/tokenizer/diagnostics.py +0 -99
  49. infinity_data-3.2.0/src/infinity_data.egg-info/requires.txt +0 -4
  50. {infinity_data-3.2.0 → infinity_data-4.0.0}/setup.cfg +0 -0
  51. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/emit/__init__.py +0 -0
  52. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/emit/config.py +0 -0
  53. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/emit/converter.py +0 -0
  54. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/emit/plain_yaml.py +0 -0
  55. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/frontend.py +0 -0
  56. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/infra/__init__.py +0 -0
  57. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/infra/ll1_stream.py +0 -0
  58. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/infra/location.py +0 -0
  59. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/parser/__init__.py +0 -0
  60. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/parser/models.py +0 -0
  61. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/py.typed +0 -0
  62. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/__init__.py +0 -0
  63. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/executor/__init__.py +0 -0
  64. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/jsonpath.py +0 -0
  65. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/__init__.py +0 -0
  66. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/semantic/std.py +0 -0
  67. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/__init__.py +0 -0
  68. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/char_stream.py +0 -0
  69. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/models/__init__.py +0 -0
  70. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/models/raw_tokens.py +0 -0
  71. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/models/tokens.py +0 -0
  72. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/__init__.py +0 -0
  73. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/__init__.py +0 -0
  74. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/__main__.py +0 -0
  75. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/convert.py +0 -0
  76. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/__init__.py +0 -0
  77. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/__main__.py +0 -0
  78. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/positions.py +0 -0
  79. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/protocol.py +0 -0
  80. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/dependency_links.txt +0 -0
  81. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/entry_points.txt +0 -0
  82. {infinity_data-3.2.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/top_level.txt +0 -0
@@ -1,4 +1,4 @@
1
- MIT License
1
+ #MIT License
2
2
 
3
3
  Copyright (c) 2026 InfinitySystem (yin_bailiang)
4
4
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: infinity-data
3
- Version: 3.2.0
3
+ Version: 4.0.0
4
4
  Summary: InfinityData:声明式配置语言(.infd/.inft)的 Python 编译器库
5
5
  Author: infinity_system: yin_bailiang
6
6
  License: MIT
@@ -17,14 +17,24 @@ Classifier: Programming Language :: Python :: 3.13
17
17
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
18
18
  Requires-Python: >=3.12
19
19
  Description-Content-Type: text/markdown
20
- License-File: LICENSE
20
+ License-File: LICENSE.md
21
21
  Provides-Extra: tool
22
22
  Requires-Dist: pyyaml; extra == "tool"
23
23
  Requires-Dist: tomli-w; extra == "tool"
24
+ Provides-Extra: docs
25
+ Requires-Dist: mkdocs-material>=9.5; extra == "docs"
24
26
  Dynamic: license-file
25
27
 
26
28
  # InfinityData
27
29
 
30
+ [![Test](https://github.com/yinbailiang/infinity_data/actions/workflows/test.yml/badge.svg)](https://github.com/yinbailiang/infinity_data/actions/workflows/test.yml)
31
+ [![Docs](https://github.com/yinbailiang/infinity_data/actions/workflows/docs.yml/badge.svg)](https://yinbailiang.github.io/infinity_data/)
32
+ [![Coverage](https://img.shields.io/badge/coverage-91%25-brightgreen)](ENGINEERING.md)
33
+ [![Pyright](https://img.shields.io/badge/pyright-strict-blue)](ENGINEERING.md)
34
+ [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)
35
+ [![PyPI](https://img.shields.io/pypi/v/infinity-data)](https://pypi.org/project/infinity-data/)
36
+ [![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://pypi.org/project/infinity-data/)
37
+
28
38
  声明式配置语言(`.infd` / `.inft`)的 Python 编译器库。
29
39
 
30
40
  - **编译优先**:`.infd` 是源码,JSON/YAML/TOML 是构建产物
@@ -44,18 +54,25 @@ from infinity_data import load, safe_load, SandboxConfig, Schema
44
54
  result = load('app.infd') # 默认零信任
45
55
  if result.has_errors:
46
56
  for d in result.diagnostics:
47
- print(d.location, d.code, d.message)
57
+ print(d.location, d.code, d.render())
48
58
  else:
49
59
  print(result.value) # 降维后的 dict
50
60
  ```
51
61
 
52
62
  ## 文档导航
53
63
 
64
+ > **文档分流**:语言规范在 `docs/`;决策与实现取舍在 `.agents/MEMORY/project/`。
65
+
54
66
  | 文档 | 内容 |
55
67
  |---|---|
56
- | [neo_desg.md](./neo_desg.md) | 语言基础设计(语法 / 类型 / 模板 / 约束) |
57
- | [extra_desg.md](./extra_desg.md) | 库 API / CLI / 生态设计 |
58
- | [impl_desg.md](./impl_desg.md) | 编译器实现层的取舍与假设 |
68
+ | [docs/zh-CN/](./docs/zh-CN/index.md) | **语言参考**(语法 / 类型 / 约束 / 模板 / 导入 / 词法) |
69
+ | [在线文档](https://yinbailiang.github.io/infinity_data/) | MkDocs 站点(GitHub Pages) |
70
+ | [.agents/MEMORY/project/decisions.md](./.agents/MEMORY/project/decisions.md) | 决策与设计记忆(库 API / CLI / 生态 / 路线图) |
71
+ | [.agents/MEMORY/project/internals.md](./.agents/MEMORY/project/internals.md) | 实现内部记忆(EOF / 错误模型 / 位置 / 沙盒边界) |
72
+ | [ENGINEERING.md](./ENGINEERING.md) | 工程质量标准与指标 |
73
+ | [CONTRIBUTING.md](./CONTRIBUTING.md) | 贡献流程与提交规范 |
74
+ | [COMMIT_LOG.md](./COMMIT_LOG.md) | 发布基线与提交历史快照 |
75
+ | [AGENT.md](./AGENT.md) | 智能体引导入口(技能 / 记忆 / 临时文件) |
59
76
 
60
77
  ## 官方工具
61
78
 
@@ -83,6 +100,8 @@ cat a.infd | infd-cov -f json # stdin → stdout
83
100
  - `--format`:`yaml`(默认,零依赖手写 emitter)/ `json` / `toml`
84
101
  - `--extract PATH`:点分路径(如 `web.spec.selector`);空 = 整树
85
102
  - `--severity LEVEL`:拒绝阈值(`error`/`warning`/`info`/`debug`/`none`,默认 `error`)
103
+ - `--lang zh-CN|en-US`:诊断消息语言(仅支持这两种标签;缺省按环境探测)
104
+ - `--diag-format text|json`:诊断报告格式(`json` 输出包含 `code` / `severity` / `params` / `location` 等字段,写入 stderr)
86
105
  - `#env: NAME "VALUE"` 声明的变量在当前进程缺失时自动注入虚拟值
87
106
  - 演示文件:`examples/app.infd`(干净配置)/ `examples/demo.infd`(含故意错误)
88
107
 
@@ -100,9 +119,9 @@ python -m infinity_data.tools.lsp
100
119
 
101
120
  | 能力 | 说明 |
102
121
  |---|---|
103
- | 诊断 | `didOpen`/`didChange`/`didSave` → `publishDiagnostics`(精确位置 + 稳定错误码 + 中文消息;UTF-16 对齐) |
122
+ | 诊断 | `didOpen`/`didChange`/`didSave` → `publishDiagnostics`(精确位置 + 稳定错误码 + 多语言消息 zh-CN / en-US;UTF-16 对齐) |
104
123
  | 补全 | 命名空间(`$` 触发)+ 内置约束名 + 当前文件可见模板名 + 模板字段(含必填/可选)+ 语言关键字 |
105
- | 悬停 | 约束描述、**编译产物预览**(字段/子字段/模板参数,jsonpath 投影)、**被实例化的模板**(模板骨架提示在前 + 实例预览在后)、**`$` 变量值**(定义点与调用点)、模板结构骨架(必填/可选 + description 元数据) |
124
+ | 悬停 | 约束描述、**编译产物预览**(字段/子字段/模板参数;emit 完整转化语义:decimal / path / noexist 自描述标记)、**被实例化的模板**(模板骨架提示在前 + 实例预览在后)、**`$` 变量值**(定义点与调用点)、模板结构骨架(必填/可选 + description 元数据) |
106
125
  | 文档大纲 | `documentSymbol`:模板定义(Class)+ 顶层字段(Property) |
107
126
  | 跳转定义 | `definition`:模板调用 / `!from` 导入 / `$` 引用(含跨文件) |
108
127
  | 语义令牌 | `semanticTokens`:直接用 `RawTokenizer` 分词(UTF-16 单元对齐;跨行多行字符串按行拆分) |
@@ -115,12 +134,18 @@ python -m infinity_data.tools.lsp
115
134
  ```json
116
135
  {
117
136
  "lspConfig.servers": [
118
- { "language": "infd", "cmd": ["infd-lsp"] },
137
+ {
138
+ "language": "infd",
139
+ "cmd": ["infd-lsp"],
140
+ "initializationOptions": { "lang": "zh-CN" }
141
+ },
119
142
  { "language": "inft", "cmd": ["infd-lsp"] }
120
143
  ]
121
144
  }
122
145
  ```
123
146
 
147
+ `initializationOptions.lang` 支持 `zh-CN` / `en-US`;缺省按环境探测,不支持的语言按固定回退链渲染英文(消息带 `[fallback: en-US]` 标记)。诊断消息还会附带结构化 `diagnostic.data`(`code` / `severity` / `params` / `location`),便于客户端二次消费。
148
+
124
149
  打开 `.infd` / `.inft` 文件即可获得:诊断波浪线 + 语法高亮(semantic tokens)+ 补全 + 悬停 + 大纲 + 跳转定义。
125
150
 
126
151
  #### 端到端演示
@@ -149,8 +174,16 @@ uv run python examples/lsp_demo.py # 自动起服务器 + 走一遍握手 +
149
174
  ## 开发
150
175
 
151
176
  ```bash
152
- uv run pytest -q # 测试
153
- uv run ruff check src tests # lint
154
- uv run pyright # 类型检查(strict)
155
- uv run python test.py # 错误报告演示
177
+ uv sync --group dev # 安装开发依赖
178
+ uv run pre-commit install # 安装提交钩子
179
+ uv run pytest -q # 测试
180
+ uv run ruff check src tests # lint
181
+ uv run pyright # 类型检查(strict)
182
+ uv run interrogate src/infinity_data/ # docstring 覆盖率
183
+ uv run mkdocs serve # 文档本地预览
184
+ uv run agent-kit update --check # 智能体规则漂移检查
185
+ uv run python others/test.py # 错误报告演示
156
186
  ```
187
+
188
+ 工程质量标准、测试矩阵与发布流程见 [ENGINEERING.md](./ENGINEERING.md);
189
+ 贡献流程见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
@@ -1,5 +1,13 @@
1
1
  # InfinityData
2
2
 
3
+ [![Test](https://github.com/yinbailiang/infinity_data/actions/workflows/test.yml/badge.svg)](https://github.com/yinbailiang/infinity_data/actions/workflows/test.yml)
4
+ [![Docs](https://github.com/yinbailiang/infinity_data/actions/workflows/docs.yml/badge.svg)](https://yinbailiang.github.io/infinity_data/)
5
+ [![Coverage](https://img.shields.io/badge/coverage-91%25-brightgreen)](ENGINEERING.md)
6
+ [![Pyright](https://img.shields.io/badge/pyright-strict-blue)](ENGINEERING.md)
7
+ [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)
8
+ [![PyPI](https://img.shields.io/pypi/v/infinity-data)](https://pypi.org/project/infinity-data/)
9
+ [![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://pypi.org/project/infinity-data/)
10
+
3
11
  声明式配置语言(`.infd` / `.inft`)的 Python 编译器库。
4
12
 
5
13
  - **编译优先**:`.infd` 是源码,JSON/YAML/TOML 是构建产物
@@ -19,18 +27,25 @@ from infinity_data import load, safe_load, SandboxConfig, Schema
19
27
  result = load('app.infd') # 默认零信任
20
28
  if result.has_errors:
21
29
  for d in result.diagnostics:
22
- print(d.location, d.code, d.message)
30
+ print(d.location, d.code, d.render())
23
31
  else:
24
32
  print(result.value) # 降维后的 dict
25
33
  ```
26
34
 
27
35
  ## 文档导航
28
36
 
37
+ > **文档分流**:语言规范在 `docs/`;决策与实现取舍在 `.agents/MEMORY/project/`。
38
+
29
39
  | 文档 | 内容 |
30
40
  |---|---|
31
- | [neo_desg.md](./neo_desg.md) | 语言基础设计(语法 / 类型 / 模板 / 约束) |
32
- | [extra_desg.md](./extra_desg.md) | 库 API / CLI / 生态设计 |
33
- | [impl_desg.md](./impl_desg.md) | 编译器实现层的取舍与假设 |
41
+ | [docs/zh-CN/](./docs/zh-CN/index.md) | **语言参考**(语法 / 类型 / 约束 / 模板 / 导入 / 词法) |
42
+ | [在线文档](https://yinbailiang.github.io/infinity_data/) | MkDocs 站点(GitHub Pages) |
43
+ | [.agents/MEMORY/project/decisions.md](./.agents/MEMORY/project/decisions.md) | 决策与设计记忆(库 API / CLI / 生态 / 路线图) |
44
+ | [.agents/MEMORY/project/internals.md](./.agents/MEMORY/project/internals.md) | 实现内部记忆(EOF / 错误模型 / 位置 / 沙盒边界) |
45
+ | [ENGINEERING.md](./ENGINEERING.md) | 工程质量标准与指标 |
46
+ | [CONTRIBUTING.md](./CONTRIBUTING.md) | 贡献流程与提交规范 |
47
+ | [COMMIT_LOG.md](./COMMIT_LOG.md) | 发布基线与提交历史快照 |
48
+ | [AGENT.md](./AGENT.md) | 智能体引导入口(技能 / 记忆 / 临时文件) |
34
49
 
35
50
  ## 官方工具
36
51
 
@@ -58,6 +73,8 @@ cat a.infd | infd-cov -f json # stdin → stdout
58
73
  - `--format`:`yaml`(默认,零依赖手写 emitter)/ `json` / `toml`
59
74
  - `--extract PATH`:点分路径(如 `web.spec.selector`);空 = 整树
60
75
  - `--severity LEVEL`:拒绝阈值(`error`/`warning`/`info`/`debug`/`none`,默认 `error`)
76
+ - `--lang zh-CN|en-US`:诊断消息语言(仅支持这两种标签;缺省按环境探测)
77
+ - `--diag-format text|json`:诊断报告格式(`json` 输出包含 `code` / `severity` / `params` / `location` 等字段,写入 stderr)
61
78
  - `#env: NAME "VALUE"` 声明的变量在当前进程缺失时自动注入虚拟值
62
79
  - 演示文件:`examples/app.infd`(干净配置)/ `examples/demo.infd`(含故意错误)
63
80
 
@@ -75,9 +92,9 @@ python -m infinity_data.tools.lsp
75
92
 
76
93
  | 能力 | 说明 |
77
94
  |---|---|
78
- | 诊断 | `didOpen`/`didChange`/`didSave` → `publishDiagnostics`(精确位置 + 稳定错误码 + 中文消息;UTF-16 对齐) |
95
+ | 诊断 | `didOpen`/`didChange`/`didSave` → `publishDiagnostics`(精确位置 + 稳定错误码 + 多语言消息 zh-CN / en-US;UTF-16 对齐) |
79
96
  | 补全 | 命名空间(`$` 触发)+ 内置约束名 + 当前文件可见模板名 + 模板字段(含必填/可选)+ 语言关键字 |
80
- | 悬停 | 约束描述、**编译产物预览**(字段/子字段/模板参数,jsonpath 投影)、**被实例化的模板**(模板骨架提示在前 + 实例预览在后)、**`$` 变量值**(定义点与调用点)、模板结构骨架(必填/可选 + description 元数据) |
97
+ | 悬停 | 约束描述、**编译产物预览**(字段/子字段/模板参数;emit 完整转化语义:decimal / path / noexist 自描述标记)、**被实例化的模板**(模板骨架提示在前 + 实例预览在后)、**`$` 变量值**(定义点与调用点)、模板结构骨架(必填/可选 + description 元数据) |
81
98
  | 文档大纲 | `documentSymbol`:模板定义(Class)+ 顶层字段(Property) |
82
99
  | 跳转定义 | `definition`:模板调用 / `!from` 导入 / `$` 引用(含跨文件) |
83
100
  | 语义令牌 | `semanticTokens`:直接用 `RawTokenizer` 分词(UTF-16 单元对齐;跨行多行字符串按行拆分) |
@@ -90,12 +107,18 @@ python -m infinity_data.tools.lsp
90
107
  ```json
91
108
  {
92
109
  "lspConfig.servers": [
93
- { "language": "infd", "cmd": ["infd-lsp"] },
110
+ {
111
+ "language": "infd",
112
+ "cmd": ["infd-lsp"],
113
+ "initializationOptions": { "lang": "zh-CN" }
114
+ },
94
115
  { "language": "inft", "cmd": ["infd-lsp"] }
95
116
  ]
96
117
  }
97
118
  ```
98
119
 
120
+ `initializationOptions.lang` 支持 `zh-CN` / `en-US`;缺省按环境探测,不支持的语言按固定回退链渲染英文(消息带 `[fallback: en-US]` 标记)。诊断消息还会附带结构化 `diagnostic.data`(`code` / `severity` / `params` / `location`),便于客户端二次消费。
121
+
99
122
  打开 `.infd` / `.inft` 文件即可获得:诊断波浪线 + 语法高亮(semantic tokens)+ 补全 + 悬停 + 大纲 + 跳转定义。
100
123
 
101
124
  #### 端到端演示
@@ -124,8 +147,16 @@ uv run python examples/lsp_demo.py # 自动起服务器 + 走一遍握手 +
124
147
  ## 开发
125
148
 
126
149
  ```bash
127
- uv run pytest -q # 测试
128
- uv run ruff check src tests # lint
129
- uv run pyright # 类型检查(strict)
130
- uv run python test.py # 错误报告演示
150
+ uv sync --group dev # 安装开发依赖
151
+ uv run pre-commit install # 安装提交钩子
152
+ uv run pytest -q # 测试
153
+ uv run ruff check src tests # lint
154
+ uv run pyright # 类型检查(strict)
155
+ uv run interrogate src/infinity_data/ # docstring 覆盖率
156
+ uv run mkdocs serve # 文档本地预览
157
+ uv run agent-kit update --check # 智能体规则漂移检查
158
+ uv run python others/test.py # 错误报告演示
131
159
  ```
160
+
161
+ 工程质量标准、测试矩阵与发布流程见 [ENGINEERING.md](./ENGINEERING.md);
162
+ 贡献流程见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "infinity-data"
3
- version = "3.2.0"
3
+ version = "4.0.0"
4
4
  description = "InfinityData:声明式配置语言(.infd/.inft)的 Python 编译器库"
5
5
  readme = "README.md"
6
6
  license = { text = "MIT" }
@@ -38,6 +38,10 @@ tool = [
38
38
  "pyyaml", # !file 的 yaml/yml 格式导入(LSP / 编译器)
39
39
  "tomli-w", # infd-cov -f toml 输出
40
40
  ]
41
+ # 文档 extra:MkDocs 站点构建(uv sync --group docs)
42
+ docs = [
43
+ "mkdocs-material>=9.5",
44
+ ]
41
45
 
42
46
  [project.urls]
43
47
  Repository = "https://github.com/yinbailiang/infinity_data"
@@ -56,13 +60,19 @@ test = [
56
60
  "pytest-cov>=5.0",
57
61
  { include-group = "tool" },
58
62
  ]
59
- # 开发组:lint/类型/钩子 + 测试组(本地开发与 CI pre-commit job 装这组)
63
+ # 文档组:MkDocs 站点构建(CI docs job 只装这组)
64
+ docs = [
65
+ "mkdocs-material>=9.5",
66
+ ]
67
+ # 开发组:lint/类型/钩子 + 测试组 + 文档组(本地开发与 CI pre-commit job 装这组)
60
68
  dev = [
61
69
  "ruff>=0.15.21",
62
70
  "pyright",
63
71
  "pre-commit>=4.0",
64
72
  "interrogate>=1.7.0",
73
+ "infinity-agent-kit>=1.1.0",
65
74
  { include-group = "test" },
75
+ { include-group = "docs" },
66
76
  ]
67
77
 
68
78
  [build-system]
@@ -105,13 +115,25 @@ line-ending = "lf"
105
115
 
106
116
  [tool.pyright]
107
117
  typeCheckingMode = "strict"
118
+ pythonVersion = "3.12"
108
119
  reportMissingTypeStubs = false
109
120
  reportMissingImports = "error"
121
+ include = ["src", "tests"]
110
122
  exclude = ["**/node_modules", "**/__pycache__", "**/.*", ".venv", "build"]
111
123
  venvPath = "."
112
124
  venv = ".venv"
113
125
 
126
+ [tool.pytest.ini_options]
127
+ testpaths = ["tests"]
128
+
114
129
  [tool.interrogate]
115
130
  fail-under = 60
116
131
  # 测试函数名自解释,docstring 可选;产品代码(src)不豁免
117
132
  ignore-regex = ["^test_"]
133
+ ignore-init-method = true
134
+ ignore-init-module = true
135
+ ignore-magic = true
136
+ ignore-private = true
137
+ ignore-semiprivate = true
138
+ ignore-nested-functions = true
139
+ exclude = ["tests", "docs", "others", "build", ".agents"]
@@ -1,6 +1,7 @@
1
1
  """InfinityData —— 声明式配置语言(.infd/.inft)的 Python 编译器库。
2
2
 
3
- 编译流水线:RawTokenizer → FinalTokenizer → Parser → AstBuilder → Executor → Converter
3
+ 编译流水线:RawTokenizer → FinalTokenizer → Parser → Resolver → AstBuilder
4
+ → ConstraintExecutor → std_to_python / emit(JSON / YAML / TOML)。
4
5
 
5
6
  用法::
6
7
 
@@ -9,7 +10,7 @@
9
10
  result = safe_load("app.infd")
10
11
  if result.has_errors:
11
12
  for d in result.diagnostics:
12
- print(d.location, d.message)
13
+ print(d.location, d.render())
13
14
  else:
14
15
  print(result.value)
15
16
  """