infinity-data 3.3.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.
- infinity_data-3.3.0/LICENSE → infinity_data-4.0.0/LICENSE.md +1 -1
- {infinity_data-3.3.0/src/infinity_data.egg-info → infinity_data-4.0.0}/PKG-INFO +46 -13
- {infinity_data-3.3.0 → infinity_data-4.0.0}/README.md +42 -11
- {infinity_data-3.3.0 → infinity_data-4.0.0}/pyproject.toml +24 -2
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/__init__.py +3 -2
- infinity_data-4.0.0/src/infinity_data/infra/diagnostics.py +523 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/infra/file.py +13 -4
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/infra/path.py +1 -1
- infinity_data-4.0.0/src/infinity_data/parser/diagnostics.py +455 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/parser/parser.py +162 -130
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/parser/token_stream.py +4 -7
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/pipeline.py +38 -19
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/sandbox/__init__.py +22 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/sandbox/config.py +1 -1
- infinity_data-4.0.0/src/infinity_data/sandbox/errors.py +271 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/sandbox/mediator.py +28 -7
- infinity_data-4.0.0/src/infinity_data/sandbox/schema.py +24 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/builder/__init__.py +4 -1
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/builder/builder.py +125 -123
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/builder/models.py +17 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/constraints.py +7 -11
- infinity_data-4.0.0/src/infinity_data/semantic/diagnostics.py +1623 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/executor/executor.py +181 -54
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/__init__.py +10 -9
- infinity_data-3.3.0/src/infinity_data/semantic/registry/_core.py → infinity_data-4.0.0/src/infinity_data/semantic/registry/core.py +20 -13
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/dict_constraints.py +15 -8
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/general.py +92 -53
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/logic.py +18 -9
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/registry/types.py +68 -35
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/identity.py +6 -3
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/imports.py +81 -21
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/models.py +3 -3
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/resolver.py +47 -31
- infinity_data-4.0.0/src/infinity_data/tokenizer/diagnostics.py +254 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/finalizer.py +11 -6
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/tokenizer.py +44 -66
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/cli.py +26 -2
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/language.py +41 -23
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/server.py +6 -2
- {infinity_data-3.3.0 → infinity_data-4.0.0/src/infinity_data.egg-info}/PKG-INFO +46 -13
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/SOURCES.txt +2 -2
- infinity_data-4.0.0/src/infinity_data.egg-info/requires.txt +7 -0
- infinity_data-3.3.0/src/infinity_data/infra/diagnostics.py +0 -214
- infinity_data-3.3.0/src/infinity_data/parser/diagnostics.py +0 -127
- infinity_data-3.3.0/src/infinity_data/sandbox/errors.py +0 -106
- infinity_data-3.3.0/src/infinity_data/sandbox/schema.py +0 -21
- infinity_data-3.3.0/src/infinity_data/semantic/diagnostics.py +0 -283
- infinity_data-3.3.0/src/infinity_data/tokenizer/diagnostics.py +0 -99
- infinity_data-3.3.0/src/infinity_data.egg-info/requires.txt +0 -4
- {infinity_data-3.3.0 → infinity_data-4.0.0}/setup.cfg +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/emit/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/emit/config.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/emit/converter.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/emit/plain_yaml.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/frontend.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/infra/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/infra/ll1_stream.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/infra/location.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/parser/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/parser/models.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/py.typed +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/executor/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/jsonpath.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/resolver/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/semantic/std.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/char_stream.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/models/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/models/raw_tokens.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tokenizer/models/tokens.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/__main__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/cov/convert.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/__init__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/__main__.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/positions.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data/tools/lsp/protocol.py +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/dependency_links.txt +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/entry_points.txt +0 -0
- {infinity_data-3.3.0 → infinity_data-4.0.0}/src/infinity_data.egg-info/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: infinity-data
|
|
3
|
-
Version:
|
|
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
|
+
[](https://github.com/yinbailiang/infinity_data/actions/workflows/test.yml)
|
|
31
|
+
[](https://yinbailiang.github.io/infinity_data/)
|
|
32
|
+
[](ENGINEERING.md)
|
|
33
|
+
[](ENGINEERING.md)
|
|
34
|
+
[](LICENSE.md)
|
|
35
|
+
[](https://pypi.org/project/infinity-data/)
|
|
36
|
+
[](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.
|
|
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
|
-
| [
|
|
57
|
-
| [
|
|
58
|
-
| [
|
|
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`(精确位置 + 稳定错误码 +
|
|
122
|
+
| 诊断 | `didOpen`/`didChange`/`didSave` → `publishDiagnostics`(精确位置 + 稳定错误码 + 多语言消息 zh-CN / en-US;UTF-16 对齐) |
|
|
104
123
|
| 补全 | 命名空间(`$` 触发)+ 内置约束名 + 当前文件可见模板名 + 模板字段(含必填/可选)+ 语言关键字 |
|
|
105
|
-
| 悬停 |
|
|
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
|
-
{
|
|
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
|
|
153
|
-
uv run
|
|
154
|
-
uv run
|
|
155
|
-
uv run
|
|
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
|
+
[](https://github.com/yinbailiang/infinity_data/actions/workflows/test.yml)
|
|
4
|
+
[](https://yinbailiang.github.io/infinity_data/)
|
|
5
|
+
[](ENGINEERING.md)
|
|
6
|
+
[](ENGINEERING.md)
|
|
7
|
+
[](LICENSE.md)
|
|
8
|
+
[](https://pypi.org/project/infinity-data/)
|
|
9
|
+
[](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.
|
|
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
|
-
| [
|
|
32
|
-
| [
|
|
33
|
-
| [
|
|
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`(精确位置 + 稳定错误码 +
|
|
95
|
+
| 诊断 | `didOpen`/`didChange`/`didSave` → `publishDiagnostics`(精确位置 + 稳定错误码 + 多语言消息 zh-CN / en-US;UTF-16 对齐) |
|
|
79
96
|
| 补全 | 命名空间(`$` 触发)+ 内置约束名 + 当前文件可见模板名 + 模板字段(含必填/可选)+ 语言关键字 |
|
|
80
|
-
| 悬停 |
|
|
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
|
-
{
|
|
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
|
|
128
|
-
uv run
|
|
129
|
-
uv run
|
|
130
|
-
uv run
|
|
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
|
+
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
|
-
#
|
|
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 →
|
|
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.
|
|
13
|
+
print(d.location, d.render())
|
|
13
14
|
else:
|
|
14
15
|
print(result.value)
|
|
15
16
|
"""
|