JSON Schema 工具包

零依赖地验证、生成和转换 JSON Schema。

命令

所有命令均使用 scripts/json_schema.py。

从样本数据生成 Schema

bash
python3 scripts/json_schema.py generate --input sample.json
python3 scripts/json_schema.py generate --input sample.json --output schema.json
echo {name:Jo,age:25} | python3 scripts/json_schema.py generate --input -

自动检测字符串格式（email、date-time、date、uri、ipv4）。

根据 Schema 验证 JSON

bash
python3 scripts/json_schema.py validate --schema schema.json --data data.json

报告所有带有 JSON 路径的验证错误。验证失败时退出码为 1。

将 Schema 转换为代码

bash
python3 scripts/json_schema.py convert --input schema.json --format typescript
python3 scripts/json_schema.py convert --input schema.json --format python-dataclass
python3 scripts/json_schema.py convert --input schema.json --format markdown --name User

支持的格式：typescript、python-dataclass、markdown。

支持的验证关键字

type、enum、required、properties、additionalProperties、items、minLength、maxLength、pattern、minimum、maximum、minItems、maxItems、format。

标准输入支持

使用 --input - 从标准输入管道传输 JSON，适用于 generate 和 validate --data 命令。