JSON Toolkit

一个零依赖的 Python 工具，用于处理 JSON 数据。使用 Python 标准库即可完成 JSON 的校验、格式化、压缩、查询与检查。

特性

• 美化输出（Pretty-print）：支持自定义缩进（2 个、4 个空格，或任意数量空格）
• 压缩（Minify）：移除空白字符以减小文件体积，适用于 API 传输和存储场景
• 校验（Validate）：验证 JSON 有效性，并输出结构统计信息（类型、键数量、字节大小）
• 查询（Query）：支持点号表示法（dot-notation）路径查询嵌套数据，包括数组索引
• 按键排序（Sort keys）：按字母顺序对对象键排序，确保输出确定性，便于版本比对（diff）
• 标准输入支持（Stdin support）：可与其他命令行工具配合，在 shell 管道中使用

使用示例

美化输出一个 JSON 文件：

python main.py data.json

仅校验，不输出内容：

python main.py config.json --validate
# ✓ Valid JSON
#   Type: object (12 keys)
#   Size: 4832 bytes

查询嵌套字段值：

python main.py users.json --query data.users.0.name
# "Alice"

为生产环境压缩 JSON：

python main.py config.json --minify -o config.min.json

按键排序以获得一致的 diff 结果：

python main.py package.json --sort-keys -o package-sorted.json

从 curl 输出管道传入：

curl -s https://api.example.com/data | python main.py - --query results.0

查询语法

使用点号表示法（dot notation）遍历嵌套结构；数组索引使用数字表示：

• name —— 顶层键
• data.users —— 嵌套对象的键
• data.users.0 —— 数组的第一个元素
• data.users.0.email —— 第一个数组元素中的字段
• config.servers.2.host —— 深层嵌套的值

命令行选项

• input —— JSON 文件路径；或使用 - 表示从 stdin 读取
• -o, --output —— 输出文件路径（默认输出到 stdout）
• --indent N —— 缩进空格数（默认为 2）
• --minify —— 输出压缩后的 JSON（无空白字符）
• --query PATH / -q PATH —— 提取指定点号路径下的值
• --validate —— 仅执行校验并打印统计信息，不输出 JSON 内容
• --sort-keys —— 按字母顺序对 JSON 对象的键进行排序
• --json —— （隐式启用）输出始终为合法 JSON