pyda-config 0.0.1__tar.gz

pyda_config-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wangzk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyda_config-0.0.1/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: pyda-config
+Version: 0.0.1
+Summary: Python Dict Annotation — 受限字面量子集的 .da.py 配置文件校验与加载
+Author-email: wangzk <biocory42@gmail.com>
+License: MIT
+Keywords: config,dict,literal,ast,annotation,validation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PyDA — Python Dict Annotation
+
+受限的 Python 字面量子集,用于**人类可读、可注释、可调试**的配置文件。
+
+扩展名约定 `.da.py`(Dict Annotation),文件内容是一个**裸 dict 表达式**(可嵌套),只能用字面量,不能有任何求值、赋值、导入、调用。通过白名单 AST 校验保证它能被 `ast.literal_eval` 安全求值。
+
+## 为什么
+
+- 比 JSON 多了**注释**和**尾逗号**;
+- 比 YAML 多了**结构严格、零歧义**;
+- 比「真正的 Python 模块」多了**安全保证**(不执行任意代码,不引用外部符号)。
+
+适合作为纳管多套资源的注册表(集群、服务、账号等)。
+
+## 子集规则
+
+### 允许
+
+| 类型 | 语法 |
+|---|---|
+| 字典 | `{k: v}` |
+| 列表 / 元组 / 集合 | `[...]` / `(...)` / `{...}` |
+| 标量 | str / int / float / bool / None |
+| 一元正负号 | `-1` / `+2` |
+| 嵌套 | 任意深度 |
+
+### 禁止(一旦出现即拒收)
+
+- 裸变量名 `Name`(最关键的安全闸 —— 禁掉它就无法引用任何外部符号)
+- 赋值 / 海象 `:=`
+- `import`
+- 函数调用 `f(...)`
+- 二元运算、布尔运算、比较 `a + b` / `a and b` / `a == b`
+- 属性 / 下标 / 切片 `a.b` / `a[b]`
+- 列表 / 字典 / 集合推导式
+- `def` / `class` / `lambda` / `for` / `if` 等一切语句
+- `bytes` / `complex` / `...` 常量
+
+## 用法
+
+### 命令行
+
+```bash
+python -m pyda clusters.da.py credentials.da.py
+# 或 pip install -e . 之后:
+pyda clusters.da.py credentials.da.py
+```
+
+通过打印 `OK: <file>` 退出 0;不通过逐条报错并退出 1。
+
+### Python API
+
+```python
+from pyda import check, load
+
+# 只校验
+errors = check("clusters.da.py")
+assert errors == []
+
+# 校验 + 求值
+cfg = load("clusters.da.py")
+print(cfg["clusters"][0]["name"])
+```
+
+### 示例 `.da.py` 文件
+
+```python
+{
+    "name": "a-cluster",
+    "port": 22,
+    "sudo": False,          # 注释 OK
+    "tags": ["cpu", "gpu"],
+    "storage": {
+        "shared": "/shared/a",
+        "quota_gb": 5000,
+    },
+}
+```
+
+被拒收的写法:
+
+```python
+HOST = "login01"            # ✗ 赋值
+import os                   # ✗ import
+{"a": len([1, 2])}          # ✗ 函数调用
+{"a": my_var}               # ✗ 裸变量名
+config["b"]                 # ✗ 下标
+```
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+仅依赖 Python 标准库。
+
+## License
+
+MIT

pyda_config-0.0.1/README.md

@@ -0,0 +1,100 @@
+# PyDA — Python Dict Annotation
+
+受限的 Python 字面量子集,用于**人类可读、可注释、可调试**的配置文件。
+
+扩展名约定 `.da.py`(Dict Annotation),文件内容是一个**裸 dict 表达式**(可嵌套),只能用字面量,不能有任何求值、赋值、导入、调用。通过白名单 AST 校验保证它能被 `ast.literal_eval` 安全求值。
+
+## 为什么
+
+- 比 JSON 多了**注释**和**尾逗号**;
+- 比 YAML 多了**结构严格、零歧义**;
+- 比「真正的 Python 模块」多了**安全保证**(不执行任意代码,不引用外部符号)。
+
+适合作为纳管多套资源的注册表(集群、服务、账号等)。
+
+## 子集规则
+
+### 允许
+
+| 类型 | 语法 |
+|---|---|
+| 字典 | `{k: v}` |
+| 列表 / 元组 / 集合 | `[...]` / `(...)` / `{...}` |
+| 标量 | str / int / float / bool / None |
+| 一元正负号 | `-1` / `+2` |
+| 嵌套 | 任意深度 |
+
+### 禁止(一旦出现即拒收)
+
+- 裸变量名 `Name`(最关键的安全闸 —— 禁掉它就无法引用任何外部符号)
+- 赋值 / 海象 `:=`
+- `import`
+- 函数调用 `f(...)`
+- 二元运算、布尔运算、比较 `a + b` / `a and b` / `a == b`
+- 属性 / 下标 / 切片 `a.b` / `a[b]`
+- 列表 / 字典 / 集合推导式
+- `def` / `class` / `lambda` / `for` / `if` 等一切语句
+- `bytes` / `complex` / `...` 常量
+
+## 用法
+
+### 命令行
+
+```bash
+python -m pyda clusters.da.py credentials.da.py
+# 或 pip install -e . 之后:
+pyda clusters.da.py credentials.da.py
+```
+
+通过打印 `OK: <file>` 退出 0;不通过逐条报错并退出 1。
+
+### Python API
+
+```python
+from pyda import check, load
+
+# 只校验
+errors = check("clusters.da.py")
+assert errors == []
+
+# 校验 + 求值
+cfg = load("clusters.da.py")
+print(cfg["clusters"][0]["name"])
+```
+
+### 示例 `.da.py` 文件
+
+```python
+{
+    "name": "a-cluster",
+    "port": 22,
+    "sudo": False,          # 注释 OK
+    "tags": ["cpu", "gpu"],
+    "storage": {
+        "shared": "/shared/a",
+        "quota_gb": 5000,
+    },
+}
+```
+
+被拒收的写法:
+
+```python
+HOST = "login01"            # ✗ 赋值
+import os                   # ✗ import
+{"a": len([1, 2])}          # ✗ 函数调用
+{"a": my_var}               # ✗ 裸变量名
+config["b"]                 # ✗ 下标
+```
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+仅依赖 Python 标准库。
+
+## License
+
+MIT

pyda_config-0.0.1/pyda/__init__.py

@@ -0,0 +1,146 @@
+"""PyDA — Python Dict Annotation.
+
+受限的 Python 字面量子集,用于人类可读、可注释、可调试的配置文件。
+
+子集规则(白名单 AST 节点):
+  允许: Dict/List/Tuple/Set/Constant/UnaryOp(UAdd,USub) + 模块层 Expr
+  禁止: Name(裸变量)、Assign/Import/Call/BinOp/Attribute/Subscript/推导式/def/class/...
+
+加载方式: check() 校验 → ast.literal_eval() 求值。
+"""
+
+from __future__ import annotations
+
+import ast
+from dataclasses import dataclass
+from pathlib import Path
+
+__version__ = "0.0.1"
+
+__all__ = ["check", "check_many", "load", "DaCheckError", "ALLOWED_NODES"]
+
+
+# 允许的 AST 节点类型白名单。
+# Constant 覆盖 str/int/float/bool/None (Py3.8+)。
+# UnaryOp + UAdd/USub 允许写 -1、+2 这样的负正号。
+ALLOWED_NODES: frozenset[type[ast.AST]] = frozenset({
+    ast.Dict,
+    ast.List,
+    ast.Tuple,
+    ast.Set,
+    ast.Constant,
+    ast.UnaryOp,
+    ast.UAdd,
+    ast.USub,
+    ast.Expr,
+    ast.Module,
+})
+
+# Constant 节点允许的值类型(进一步收紧,排除 bytes/complex/Ellipsis)。
+_ALLOWED_CONSTANT_TYPES: tuple[type, ...] = (str, int, float, bool, type(None))
+
+
+class DaCheckError(ValueError):
+    """PyDA 文件未通过子集校验。"""
+
+
+@dataclass
+class _Issue:
+    line: int
+    msg: str
+
+    def __str__(self) -> str:
+        return f"line {self.line}: {self.msg}"
+
+
+def _check_source(src: str, filename: str) -> list[str]:
+    """校验源码字符串,返回错误信息列表(空表示通过)。"""
+    issues: list[_Issue] = []
+
+    # 关卡 1: 语法解析
+    try:
+        tree = ast.parse(src, filename=filename)
+    except SyntaxError as e:
+        return [f"line {e.lineno or 0}: syntax error: {e.msg}"]
+
+    if not tree.body:
+        return ["file is empty (no top-level expression)"]
+
+    # 关卡 2: 模块层只允许 Expr(裸表达式)
+    for node in tree.body:
+        if not isinstance(node, ast.Expr):
+            issues.append(_Issue(node.lineno,
+                                 f"top-level only allows bare expression, "
+                                 f"forbidden {type(node).__name__} statement"))
+
+    # 关卡 3: 节点白名单遍历
+    # 只检查"带位置"的节点(有 lineno):真正的语法结构。
+    # 跳过操作符(Add/Mult/Eq)和上下文(Load/Store)等无位置子节点。
+    for node in ast.walk(tree):
+        if isinstance(node, ast.Module):
+            continue
+        if isinstance(node, ast.Expr):
+            continue
+        if not hasattr(node, "lineno"):
+            continue
+        # Name 是最关键的安全闸:禁止一切裸变量引用。
+        if isinstance(node, ast.Name):
+            issues.append(_Issue(node.lineno,
+                                 f"forbidden name '{node.id}', "
+                                 f"only literals allowed"))
+            continue
+        if isinstance(node, ast.Constant):
+            if not isinstance(node.value, _ALLOWED_CONSTANT_TYPES):
+                issues.append(_Issue(node.lineno,
+                                     f"forbidden constant type "
+                                     f"{type(node.value).__name__}, "
+                                     f"only str/int/float/bool/None"))
+            continue
+        if type(node) not in ALLOWED_NODES:
+            issues.append(_Issue(node.lineno,
+                                 f"forbidden node {type(node).__name__}"))
+
+    # 关卡 4: 双保险,白名单通过后再 literal_eval
+    if not issues:
+        try:
+            ast.literal_eval(src)
+        except Exception as e:  # noqa: BLE001
+            issues.append(_Issue(0, f"literal_eval failed: {e}"))
+
+    return [f"line {i.line}: {i.msg}" if i.line else i.msg for i in issues]
+
+
+def check(path: str | Path) -> list[str]:
+    """校验单个 .da.py 文件。
+
+    返回错误信息列表;为空表示通过子集校验。
+    """
+    p = Path(path)
+    if not p.exists():
+        return [f"{p}: file not found"]
+    src = p.read_text(encoding="utf-8")
+    return _check_source(src, str(p))
+
+
+def check_many(paths) -> dict[Path, list[str]]:
+    """批量校验,返回 {path: errors}。"""
+    result = {}
+    for path in paths:
+        p = Path(path)
+        result[p] = check(p)
+    return result
+
+
+def load(path: str | Path):
+    """校验通过后返回 literal_eval 的求值结果。
+
+    未通过校验则 raise DaCheckError,错误信息附在异常中。
+    """
+    p = Path(path)
+    errors = check(p)
+    if errors:
+        raise DaCheckError(
+            f"{p} 未通过 PyDA 子集校验:\n  - " + "\n  - ".join(errors)
+        )
+    src = p.read_text(encoding="utf-8")
+    return ast.literal_eval(src)

pyda_config-0.0.1/pyda/__main__.py

@@ -0,0 +1,42 @@
+"""PyDA 命令行入口。
+
+用法:
+  python -m pyda <file.da.py> [file2.da.py ...]
+  pyda <file.da.py> [file2.da.py ...]   (pip install 后)
+"""
+
+from __future__ import annotations
+
+import sys
+
+from . import check_many
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = sys.argv[1:] if argv is None else argv
+
+    if not args:
+        print("usage: pyda <file.da.py> [file2.da.py ...]")
+        print("validate .da.py files against the PyDA literal subset")
+        return 2
+
+    results = check_many(args)
+
+    all_ok = True
+    for path, errors in results.items():
+        if not errors:
+            print(f"OK: {path}")
+        else:
+            all_ok = False
+            for e in errors:
+                print(f"{path}: {e}", file=sys.stderr)
+
+    if all_ok:
+        print(f"passed: {len(results)} file(s) conform to PyDA subset",
+              file=sys.stderr)
+        return 0
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pyda_config-0.0.1/pyda_config.egg-info/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: pyda-config
+Version: 0.0.1
+Summary: Python Dict Annotation — 受限字面量子集的 .da.py 配置文件校验与加载
+Author-email: wangzk <biocory42@gmail.com>
+License: MIT
+Keywords: config,dict,literal,ast,annotation,validation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PyDA — Python Dict Annotation
+
+受限的 Python 字面量子集,用于**人类可读、可注释、可调试**的配置文件。
+
+扩展名约定 `.da.py`(Dict Annotation),文件内容是一个**裸 dict 表达式**(可嵌套),只能用字面量,不能有任何求值、赋值、导入、调用。通过白名单 AST 校验保证它能被 `ast.literal_eval` 安全求值。
+
+## 为什么
+
+- 比 JSON 多了**注释**和**尾逗号**;
+- 比 YAML 多了**结构严格、零歧义**;
+- 比「真正的 Python 模块」多了**安全保证**(不执行任意代码,不引用外部符号)。
+
+适合作为纳管多套资源的注册表(集群、服务、账号等)。
+
+## 子集规则
+
+### 允许
+
+| 类型 | 语法 |
+|---|---|
+| 字典 | `{k: v}` |
+| 列表 / 元组 / 集合 | `[...]` / `(...)` / `{...}` |
+| 标量 | str / int / float / bool / None |
+| 一元正负号 | `-1` / `+2` |
+| 嵌套 | 任意深度 |
+
+### 禁止(一旦出现即拒收)
+
+- 裸变量名 `Name`(最关键的安全闸 —— 禁掉它就无法引用任何外部符号)
+- 赋值 / 海象 `:=`
+- `import`
+- 函数调用 `f(...)`
+- 二元运算、布尔运算、比较 `a + b` / `a and b` / `a == b`
+- 属性 / 下标 / 切片 `a.b` / `a[b]`
+- 列表 / 字典 / 集合推导式
+- `def` / `class` / `lambda` / `for` / `if` 等一切语句
+- `bytes` / `complex` / `...` 常量
+
+## 用法
+
+### 命令行
+
+```bash
+python -m pyda clusters.da.py credentials.da.py
+# 或 pip install -e . 之后:
+pyda clusters.da.py credentials.da.py
+```
+
+通过打印 `OK: <file>` 退出 0;不通过逐条报错并退出 1。
+
+### Python API
+
+```python
+from pyda import check, load
+
+# 只校验
+errors = check("clusters.da.py")
+assert errors == []
+
+# 校验 + 求值
+cfg = load("clusters.da.py")
+print(cfg["clusters"][0]["name"])
+```
+
+### 示例 `.da.py` 文件
+
+```python
+{
+    "name": "a-cluster",
+    "port": 22,
+    "sudo": False,          # 注释 OK
+    "tags": ["cpu", "gpu"],
+    "storage": {
+        "shared": "/shared/a",
+        "quota_gb": 5000,
+    },
+}
+```
+
+被拒收的写法:
+
+```python
+HOST = "login01"            # ✗ 赋值
+import os                   # ✗ import
+{"a": len([1, 2])}          # ✗ 函数调用
+{"a": my_var}               # ✗ 裸变量名
+config["b"]                 # ✗ 下标
+```
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+仅依赖 Python 标准库。
+
+## License
+
+MIT

pyda_config-0.0.1/pyda_config.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+pyda/__init__.py
+pyda/__main__.py
+pyda_config.egg-info/PKG-INFO
+pyda_config.egg-info/SOURCES.txt
+pyda_config.egg-info/dependency_links.txt
+pyda_config.egg-info/entry_points.txt
+pyda_config.egg-info/top_level.txt
+tests/test_invalid.py
+tests/test_valid.da.py

pyda_config-0.0.1/pyda_config.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyda_config-0.0.1/pyda_config.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pyda = pyda.__main__:main

pyda_config-0.0.1/pyda_config.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyda

pyda_config-0.0.1/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyda-config"
+version = "0.0.1"
+description = "Python Dict Annotation — 受限字面量子集的 .da.py 配置文件校验与加载"
+readme = {file = "README.md", content-type = "text/markdown"}
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "wangzk", email = "biocory42@gmail.com" }]
+keywords = ["config", "dict", "literal", "ast", "annotation", "validation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
+]
+dependencies = []  # 纯标准库
+
+[project.urls]
+# Homepage = "https://github.com/<user>/pyda"  # 仓库公开后补上
+
+[project.scripts]
+pyda = "pyda.__main__:main"
+
+[tool.setuptools]
+packages = ["pyda"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

pyda_config-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyda_config-0.0.1/tests/test_invalid.py

@@ -0,0 +1,71 @@
+"""PyDA 非法写法测试:各种应被拒收的子集违规。
+
+每条是一个独立的非法源码片段,_check_source 应返回非空错误列表。
+运行: python tests/test_invalid.py
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+# 确保 UTF-8 输出(Windows GBK 终端兼容)
+for stream in (sys.stdout, sys.stderr):
+    if hasattr(stream, "reconfigure"):
+        stream.reconfigure(encoding="utf-8")
+
+# 让脚本能直接 import 已安装的 pyda
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from pyda import _check_source  # type: ignore  # noqa: E402
+from pyda import check, load  # noqa: E402
+
+INVALID_CASES = [
+    ('HOST = "login01"', "assignment"),
+    ("import os", "import"),
+    ('{"a": len([1, 2])}', "function call"),
+    ('{"a": my_var}', "bare name"),
+    ('config["b"]', "subscript"),
+    ("a.b", "attribute"),
+    ("1 + 2", "binary op"),
+    ("True and False", "bool op"),
+    ("1 == 1", "compare"),
+    ("[x for x in range(3)]", "list comprehension"),
+    ("{k: 1 for k in [1,2]}", "dict comprehension"),
+    ("(y := 1)", "walrus"),
+    ("def f(): pass", "def statement"),
+    ("(lambda: 1)", "lambda"),
+    ('b"data"', "bytes constant"),
+]
+
+
+def main() -> int:
+    failures = []
+    for i, (src, desc) in enumerate(INVALID_CASES, 1):
+        errors = _check_source(src, f"<case {i}>")
+        if not errors:
+            failures.append((i, desc, src))
+            print(f"FAIL [{desc}] NOT rejected, src: {src}")
+        else:
+            print(f"OK   [{desc}] rejected: {errors[0]}")
+
+    # 合法文件应能通过 check + load
+    valid = Path(__file__).resolve().parent / "test_valid.da.py"
+    if check(valid):
+        failures.append((0, "valid file rejected", str(valid)))
+        print(f"FAIL [valid file] rejected: {check(valid)}")
+    else:
+        cfg = load(valid)
+        print(f"OK   [valid file] loaded: "
+              f"{len(cfg['nested']['partitions'])} partitions")
+
+    if failures:
+        print(f"\n{len(failures)} case(s) failed", file=sys.stderr)
+        return 1
+    print(f"\nall {len(INVALID_CASES)} invalid cases rejected, "
+          f"valid file loaded", file=sys.stderr)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pyda_config-0.0.1/tests/test_valid.da.py

@@ -0,0 +1,23 @@
+{
+    # 顶层裸 dict,带注释
+    "name": "a-cluster",
+    "host": "login01.example.edu",
+    "port": 22,
+    "sudo": False,                          # bool 是 Constant,不是 Name
+    "tags": ["cpu", "gpu"],                 # 列表
+    "quota": -1,                            # 一元负号 OK
+    "ratio": +0.5,                          # 一元正号 OK
+    "nested": {
+        "storage": {
+            "shared": "/shared/a",
+            "quota_gb": 5000,
+            "purge_days": 30,
+        },
+        "partitions": [
+            {"name": "cpu", "max_walltime": "72:00:00"},
+            {"name": "gpu", "gres": "gpu:a100:4", "max_walltime": "48:00:00"},
+        ],
+    },
+    "notes": None,                          # None 是 Constant
+    "empty": {},                            # 空 dict OK
+}