开发工具【免费下载链接】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点击查看免费下载/proc/swaps是 Linux 内核暴露交换设备swap使用状态的虚拟文件。jc 提供了proc_swaps解析器可将该文件的表格化输出转换为结构化的 JSON / YAML / Python 字典便于与jq等工具联动或直接在 Python 脚本中消费。本文以 docs/parsers/proc_swaps.md 为核心结合 解析器源码、自动识别模块 与 测试用例完整讲解该解析器的用法、输出结构、内部实现原理与注意事项。/proc/swaps文件长什么样Linux 内核通过/proc/swaps报告当前系统中所有交换设备的信息。文件以一行表头加若干数据行的形式呈现字段间以制表符Tab分隔。仓库中的测试夹具 tests/fixtures/linux-proc/swaps 给出了真实格式示例Filename Type Size Used Priority /swap.img file 3996668 0 -2各字段含义如下字段含义Filename交换设备或交换文件的路径如/swap.img、/dev/sda2Type交换类型常见取值为file交换文件、partition交换分区Size交换空间总大小单位为 KiB1024 字节Used已使用的空间大小单位为 KiBPriority交换优先级数值越大优先级越高通常为负数如-2该文件仅在 Linux 系统上存在这也是解析器info类中compatible [linux]的由来见 jc/parsers/proc_swaps.py。快速上手三种 CLI 用法原文档给出了三种等价方式将/proc/swaps内容转换为 JSON方式一通过通用 proc 解析器自动识别$ cat /proc/swaps | jc --proc--proc是 jc 的通用/proc文件解析入口它会自动嗅探输入内容并路由到对应的子解析器详见下文「自动识别机制」一节。方式二jc 的 magic 语法直接读取文件$ jc /proc/swaps直接以/proc路径作为参数传入 jc由 jc 自行读取并解析。注意所有 jc 选项必须放在路径之前。方式三调用专用解析器$ cat /proc/swaps | jc --proc-swaps--proc-swaps是该解析器在 CLI 侧的专用选项命名规则为proc-name可直接通过jc -hh或jc -a查看完整解析器清单jc/parsers/proc.py。处理后的输出执行cat /proc/swaps | jc --proc -p-p为 pretty print得到[ { filename: /swap.img, type: file, size: 3996668, used: 0, priority: -2 } ]可见字段名被转为小写且size、used、priority已从字符串转换为整数类型符合 Schema 约定。原始输出-r 模式若需要保留源文件的字符串形态例如只想做简单的结构重组、后续自行处理数值使用-rraw选项$ cat /proc/swaps | jc --proc-swaps -p -r[ { filename: /swap.img, type: file, size: 3996668, used: 0, priority: -2 } ]可以看到 raw 模式下所有值包括数值字段都以字符串原样输出未做任何类型转换。Python 模块用法在 Python 中有两种调用方式方式一通过通用 proc 解析器推荐自动识别文件类型import jc with open(/proc/swaps, r, encodingutf-8) as f: proc_swaps_file f.read() result jc.parse(proc, proc_swaps_file)方式二直接调用专用解析器import jc result jc.parse(proc_swaps, proc_swaps_file)两者返回均为「字典列表」List[Dict]。输出 Schema 与字段类型原文档定义了如下输出 Schema[ { filename: string, type: string, size: integer, used: integer, priority: integer } ]输出字段类型来源说明filenamestring表头Filename交换设备/文件路径表头转为小写typestring表头Type交换类型file或partitionsizeinteger表头Size总大小KiB由字符串转为整数usedinteger表头Used已用大小KiB由字符串转为整数priorityinteger表头Priority交换优先级可为负数由字符串转为整数源码剖析解析流程与底层实现parse 函数的执行链路parse 函数 的实现非常精简完整执行链路如下def parse(data, rawFalse, quietFalse): jc.utils.compatibility(__name__, info.compatible, quiet) # 平台兼容性检查 jc.utils.input_type_check(data) # 输入类型校验 raw_output [] if jc.utils.has_data(data): # 空输入保护 cleandata list(filter(None, data.splitlines())) # 按行拆分并过滤空行 cleandata[0] cleandata[0].lower() # 表头转小写 raw_output simple_table_parse(cleandata) # 通用简单表格解析 return raw_output if raw else _process(raw_output) # raw 直接返回否则类型转换几个关键设计点输入校验compatibility负责在非 Linux 平台给出警告提示input_type_check校验传入的是字符串has_data处理空输入——测试用例test_proc_swaps_nodata验证了空串输入返回空列表[]见 tests/test_proc_swaps.py。表头小写化首行表头通过.lower()转为小写这样simple_table_parse才能把Filename等表头名映射为filename等小写键名。空行过滤filter(None, ...)剔除空白行保证表格干净。通用表格解析器 simple_table_parse解析主体复用了 jc 的通用工具 simple_table_parse。该函数适用于「无空单元格」的简单表格要求传入按.splitlines()拆分的行迭代器且第 0 项必须是表头行表头中的空格需替换为下划线并保证表头为小写这正是 parse 中先做.lower()的原因数据中不得存在空白行。它返回「字典列表」第一行表头作为键后续每行作为值。/proc/swaps的规则表格形态与该工具完全契合因此整个解析器只需约 30 行代码即可完成。类型转换 _processraw 数据处理函数 负责将字符串值转换为 Schema 要求的整数类型int_list {size, used, priority} for entry in proc_data: for key in entry: if key in int_list: entry[key] jc.utils.convert_to_int(entry[key])convert_to_int是 jc 的工具函数见 jc/utils.py用于将字符串、浮点数等输入安全转换为int。注意filename和type不在转换清单中保持字符串类型。priority虽是负数如-2转换逻辑依然能正确处理。自动识别机制--proc 如何找到 proc_swapsjc --proc之所以能处理/proc/swaps的内容依赖 proc 解析器 内置的「特征签名 路由表」机制。该解析器为每个 proc 子文件定义了正则签名其中 swaps 的识别正则位于 jc/parsers/proc.pyswaps_p re.compile(r^Filename\t\t\t\tType\t\tSize\t\tUsed\t\tPriority\n)当输入以Filename\t\t\t\tType\t\tSize\t\tUsed\t\tPriority表头开头时即判定为/proc/swaps文件。随后在 procmap 路由表 中建立映射swaps_p: proc_swaps,再通过get_parser(proc_swaps)动态加载并调用对应解析器jc/parsers/proc.py。如果匹配到的解析器尚未实现会抛出ParseError。因此直接使用jc /proc/swaps的 magic 语法本质上就是先读取文件、再走--proc的识别流程。测试验证与示例夹具仓库通过 tests/test_proc_swaps.py 对解析器进行回归测试。测试加载两组夹具文件输入夹具tests/fixtures/linux-proc/swaps上文展示的原始/proc/swaps文本期望输出tests/fixtures/linux-proc/swaps.json[{filename:/swap.img,type:file,size:3996668,used:0,priority:-2}]测试覆盖两个场景空数据输入返回[]以及真实数据解析结果与期望 JSON 完全一致tests/test_proc_swaps.py。这组夹具同时也可作为读者验证 jc 行为的现成样例——例如将swaps.json与jc --proc-swaps -r的原始输出对比即可直观理解 raw 模式与默认模式的差异。使用注意事项平台限制/proc/swaps仅存在于 Linux 系统解析器声明compatible [linux]在其他平台调用会收到兼容性警告除非传入quietTrue。隐藏解析器info类中hidden Truejc/parsers/proc_swaps.py表示该解析器通常不单独出现在常规jc帮助清单的显眼位置而是作为--proc体系的一员被自动调度。magic 语法参数顺序使用jc /proc/swaps时任何 jc 选项如-p、-r必须放在路径之前否则会被误认为输入文件。多文件 slurp--proc体系支持一次性读取多个 proc 文件如jc /proc/*/stat输出会包裹在数组中并附带_file字段用于关联输入输出见 jc/parsers/proc.py对批量巡检交换设备等场景尤为实用。小结proc_swaps是 jc 众多文件解析器中最典型的「简单表格型」解析器一方面它通过simple_table_parse以极少的代码量完成结构化另一方面借助--proc的正则签名机制实现了零配置的自动识别。无论是手工排查 swap 使用率、编写监控脚本还是将/proc/swaps喂给jq做二次加工本文介绍的三种调用方式都能直接落地使用。赞分享开发工具【免费下载链接】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 解析 /proc/partitions将 Linux 块设备分区表转换为 JSONjc 解析 /proc/partitions将 Linux 块设备分区表转换为 JSON 导读 /proc/partitions 是 Linux 内核导出的虚开发工具jc proc-cpuinfo 解析器将 Linux /proc/cpuinfo 精准转换为结构化 JSONjc proc cpuinfo 解析器将 Linux /proc/cpuinfo 精准转换为结构化 JSON 本文基于 proc_cpuinfo 解析器文档开发工具jc proc_meminfo 解析器详解把 Linux /proc/meminfo 内存信息文件转换为结构化 JSONjc proc_meminfo 解析器详解把 Linux /proc/meminfo 内存信息文件转换为结构化 JSON jcJSON Convert中的开发工具上一篇SkyPilot 开发者指南从仓库结构、工程规范到架构模式与提交流程下一篇Linux动态壁纸终极指南免费在Linux上运行Wallpaper Engine壁纸创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考