jc 解析器实战：将 `update-alternatives --get-selections` 输出转换为 JSON 的 `update-alt-gs` 指南

开发工具【免费下载链接】jcCLI tool and python library that converts the output of popular command-line tools, file-types, and common strings to JSON, YAML, or Dictionaries. This allows piping of output to tools like jq and simplifying automation scripts.项目地址https://gitcode.com/gh_mirrors/jc/jc点击查看免费下载本指南围绕 jc 项目中的update-alt-gs解析器展开讲解如何把 Linux 下update-alternatives --get-selections命令输出的备选方案alternatives清单转换为结构化 JSON以便接入 jq 等工具链、简化系统配置审计与自动化脚本。读完本文你将掌握该解析器的 CLI 用法、Python 模块调用方式、输出 Schema以及它的底层解析原理与测试验证方法。背景为什么要解析update-alternatives --get-selections在 Debian/Ubuntu 等发行版中update-alternatives用于维护系统中同名命令或文件的符号链接备选方案如editor、awk、cc等。其中update-alternatives --get-selections以纯文本清单形式输出当前所有备选方案的注册名、模式与当前指向路径update-alternatives --query name则输出单个备选方案的详细结构化信息对应 jc 的 update-alt-q 解析器。纯文本清单不便被脚本直接消费jc 的update-alt-gs解析器正是为它量身定制的将每一行转换为{name, status, current}对象最终得到一个 JSON 数组。CLI 用法两种等价调用方式根据文档与 源码模块文档字符串有两种命令行用法方式一管道方式$ update-alternatives --get-selections | jc --update-alt-gs方式二magic 方式直接让 jc 代为执行命令$ jc update-alternatives --get-selections方式二依赖 jc 的 magic command 机制jc在 cli.py 中会把用户给出的命令与各解析器的magic_commands元数据做匹配update-alt-gs解析器注册的 magic command 正是update-alternatives --get-selections见 update_alt_gs.py匹配成功后由 jc 调用subprocess运行该命令并自动解析其标准输出。带-ppretty美化输出$ update-alternatives --get-selections | jc --update-alt-gs -p [ { name: arptables, status: auto, current: /usr/sbin/arptables-nft }, { name: awk, status: auto, current: /usr/bin/gawk } ]Python 模块用法在自动化脚本中直接调用除 CLI 外update-alt-gs也是 jc 的公开解析器之一已注册于 lib.py 的解析器清单可导入jc.parsers.update_alt_gs单独使用或通过统一的jc.parse()入口调用import jc result jc.parse(update-alt-gs, update_alternatives_get_selections_command_output)单独导入解析器模块的方式import jc.parsers.update_alt_gs as my_parser result my_parser.parse(update_alternatives_get_selections_command_output)两种方式返回的都是List[Dict]可直接交给json.dumps()序列化或交给 pandas、jinja2 等下游工具继续处理。输出 Schema 说明解析结果是一个数组每个元素包含三个字符串字段见 文档 Schema 定义字段类型含义namestring备选方案的注册名如editor、awk、ccstatusstring当前模式通常为auto自动或manual手动currentstring当前生效的备选路径如/usr/bin/gawk完整示例取自仓库测试 fixture 对应的原始输出见 fixtures 输入文件[ { name: arptables, status: auto, current: /usr/sbin/arptables-nft }, { name: awk, status: auto, current: /usr/bin/gawk }, { name: editor, status: auto, current: /bin/nano }, { name: vim, status: auto, current: /usr/bin/vim.basic } ]底层解析原理三列固定格式的行拆分从源码 update_alt_gs.py 可以看到完整的解析流程平台兼容性检查parse()首先调用jc.utils.compatibility()校验当前平台。解析器的info.compatible [linux]见 update_alt_gs.py在非 Linux 平台运行时若未传入quietTrue会向 STDERR 打印一条警告提示如果你处理的是来自受支持平台的输出可忽略此警告见 utils.py 的 compatibility 实现。需要说明的是该警告属于跨平台消费远程文本时的提示并非错误——用户可用-q选项抑制。输入类型校验jc.utils.input_type_check()确保传入的是str对象否则抛出TypeError。空数据处理jc.utils.has_data()检查输入是否只含空白字符无有效数据时返回空列表这一点有测试用例专门覆盖见下文。逐行解析对data.splitlines()过滤掉空行后对每一行执行line.split(maxsplit2)——这是关键所在。update-alternatives --get-selections的输出固定为名称 模式 路径三列且名称与模式之间、模式与路径之间可能存在多个空格而路径本身如/usr/share/man/man7/bash-builtins.7.gz不含空格因此maxsplit2能保证前三列被正确拆开line_list[0]→nameline_list[1]→statusline_list[2]→currentraw 与处理逻辑rawTrue时直接返回上述字典列表否则交给_process()做最终处理。当前版本的_process()为无额外处理见 update_alt_gs.py因为三字段结构本身已符合 Schema无需类型转换或字段重命名——这与update-alt-q需要将priority转为整数等不同。测试验证如何确认解析结果正确仓库提供了针对该解析器的单元测试 test_update_alt_gs.py包含两个用例test_update_alt_gs_nodata传入空字符串quietTrue应返回[]验证空输入边界test_update_alt_gs读取 update-alternatives-get-selections.out包含 41 行真实输出覆盖arptables、awk、vim、w、write等备选方案断言解析结果与 update-alternatives-get-selections.json 完全一致。如果要在本地复现验证可以先手动将update-alternatives --get-selections的输出保存为文件再用 jc 的-p选项对比 JSON 结果也可以直接运行$ python -m unittest tests.test_update_alt_gs与其他解析器的关系与适用前提update-alt-gs本文处理--get-selections的全局清单输出数组适合快速盘点系统上所有备选方案的注册名与当前路径update-alt-q文档处理--query的单个备选详情输出对象包含link、best、value、alternatives列表及优先级等更丰富的信息适合深入分析某一个方案。实际使用中可以根据需求组合先用--update-alt-gs得到全量清单再对感兴趣的name用jc update-alternatives --query name --update-alt-q展开详情。适用前提与限制该解析器针对 Linux 平台的update-alternatives输出设计info.compatible [linux]因此在 Linux 上直接执行jc update-alternatives --get-selections或管道方式均无警告在 macOS/BSD/Windows 上若手动喂入从 Linux 主机采集的文本应使用-q抑制平台兼容性提示解析假定输入行严格符合名称 模式 路径三列格式非该命令格式的输入可能产生解析偏差需先确认数据来源。小结update-alt-gs是 jc 解析器家族中结构最简洁的成员之一输入一行三列文本、输出{name, status, current}列表底层仅依赖split(maxsplit2)即可完成。它的价值在于让系统管理员能够把update-alternatives的状态盘点直接接入 JSON 工具链如 jq、Python、表格化工具快速生成备选方案审计报告或作为自动化配置校验的前置数据源。想深入了解 jc 的解析器架构与更多用法可继续阅读 jc 解析器索引文档 与 通用库参考。赞分享开发工具【免费下载链接】jcCLI tool and python library that converts the output of popular command-line tools, file-types, and common strings to JSON, YAML, or Dictionaries. This allows piping of output to tools like jq and simplifying automation scripts.项目地址https://gitcode.com/gh_mirrors/jc/jc点击查看免费下载相关推荐jc update_alt_q 解析器将 update-alternatives --query 输出转换为 JSON 的完整实战指南jc update_alt_q 解析器将 update alternatives query 输出转换为 JSON 的完整实战指南 update altern开发工具jc 解析器实战用 jc --amixer 将 amixer sget 输出转换为 JSONjc 解析器实战用 jc amixer 将 amixer sget 输出转换为 JSON jc 是 GitHub 加速计划下的一个 CLI 工具与 Pytho开发工具jc 解析器实战指南用 jc --history 将 shell history 命令输出转换为 JSONjc 解析器实战指南用 jc history 将 shell history 命令输出转换为 JSON 本指南以 jc 开源项目中的 history 解析器文开发工具上一篇SOCD Cleaner如何彻底解决游戏键盘输入冲突提升竞技表现下一篇KKManager游戏Mod管理的智能解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考