jc path-list 解析器详解：把 PATH 风格的冒号分隔路径列表转换为结构化 JSON

开发工具【免费下载链接】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 的path-list解析器jc.parsers.path_list专门处理一类高频出现的文本以冒号或 Windows 场景下的分号分隔的 POSIX 路径列表典型来源就是PATH、LD_LIBRARY_PATH等环境变量。读完后你将掌握该解析器的 CLI/模块两种用法、完整输出 Schema、分隔符自动判定逻辑以及它在 Windows 路径、空输入、含空格路径等边界场景下的行为能把原本难以结构化处理的路径串可靠地喂给jq或 Python 脚本。它解决什么问题环境变量中的路径列表colon-separated POSIX path list是 shell 自动化里最常见的“半结构化文本”之一/Users/admin/.docker/bin:/Users/admin/.asdf/shims这类字符串对jq来说只是一个不透明字符串对 Python 需要手写split(:)加pathlib拆解。jc 的path-list解析器把每一项拆成独立的 JSON 对象并附带父目录、文件名、主名、扩展名和路径分量列表从而支持按字段过滤、排序、去重等操作。它注册在 jc 的解析器列表中见 jc/lib.py 中的path-list条目CLI 选项为--path-list。使用方法CLI 方式文档给出的标准用法是把路径列表通过管道传入$ echo /Users/admin/.docker/bin:/Users/admin/.asdf/shims | jc --path-list加上-ppretty参数可获得缩进格式输出。Python 模块方式作为库调用时jc.parse的第一个参数是解析器名称带连字符第二个参数是待解析文本import jc result jc.parse(path-list, path_string)输出 Schema 与字段说明解析结果是一个 JSON 数组每个元素对应输入中的一个路径字段如下定义见 jc/parsers/path_list.py 模块 docstring字段类型含义pathstring规范化后的完整路径字符串parentstring父目录路径filenamestring最后一级路径分量文件名或目录名stemstring去掉扩展名后的主名无扩展名时与filename相同extensionstring扩展名不含点无扩展名时为空字符串path_liststring[]路径按分量切分后的列表如[/, abc, def, gh.txt]完整示例文档中给出的示例命令与完整输出可直接复制验证$ echo /abc/def/gh.txt:/xyz/uvw/ab.app | jc --path-list -p[ { path: /abc/def/gh.txt, parent: /abc/def, filename: gh.txt, stem: gh, extension: txt, path_list: [ /, abc, def, gh.txt ] }, { path: /xyz/uvw/ab.app, parent: /xyz/uvw, filename: ab.app, stem: ab, extension: app, path_list: [ /, xyz, uvw, ab.app ] } ]可以看出/abc/def/gh.txt被拆成parent/abc/def、stemgh、extensiontxt而path_list保留了包括根/在内的完整分量序列。源码实现剖析parse 函数先做防御性检查再委派给 path 解析器核心入口是 jc/parsers/path_list.py 中的parse(data, rawFalse, quietFalse)def parse(data, rawFalse, quietFalse): jc.utils.compatibility(__name__, info.compatible, quiet) jc.utils.input_type_check(data) # This parser uses path.py path.info info # type: ignore delimiter : if \\ not in data else ; raw_output [ path.parse(line, rawraw, quietquiet) for line in data.split(delimiter) if jc.utils.has_data(data) ] return raw_output几个值得注意的实现细节兼容性检查与输入类型检查。jc.utils.compatibility依据info.compatible列表校验当前平台jc.utils.input_type_check校验输入是否为字符串/字节串二者都在正式解析前执行定义见 jc/utils.py。分隔符自动判定delimiter : if \\ not in data else ;。只要输入中出现反斜杠就认为这是 Windows 风格的路径列表改用分号分隔否则按 POSIX 习惯用冒号分隔。这与PATH在两种平台上的实际格式一致。逐项委派拆分后的每一段单独交给jc.parsers.path的parse()处理path-list本身只负责“列表”这一层路径字段的全部语义来自path解析器jc/parsers/path.py。空输入处理列表推导中的过滤条件jc.utils.has_data(data)作用于整个输入data从源码结构看当输入为空或纯空白时函数返回空列表[]而不是抛出异常这对脚本中“环境变量可能未设置”的场景比较友好。底层path 解析器如何产出字段jc/parsers/path.py 中parse()的关键逻辑data data.rstrip(\n) if \\ in data: path PureWindowsPath(data) else: path PurePosixPath(data) raw_output { path: str(path), parent: str(path.parent), filename: path.name, stem: path.stem, extension: path.suffix[1:], path_list: list(path.parts) }它根据是否包含反斜杠选择pathlib的PureWindowsPath或PurePosixPath然后parent取path.parent的字符串形式filename取path.name最后一级分量extension取path.suffix并去掉前导的点所以输出是txt而不是.txtpath_list直接来自path.parts即 pathlib 标准的路径分量元组。由于使用的是Pure*路径类而非Path解析过程不会触碰文件系统——路径不存在、拼写错误都不会导致报错这保证了对“只是想把字符串拆结构”这一需求的纯粹性。Windows 路径场景path-list的兼容平台声明为linux, darwin, cygwin, win32, aix, freebsd测试 fixture 中专门覆盖了几种 Windows 输入驱动器路径c:\Program Files (x86)\Git\bin;c:\my\folder对应 tests/fixtures/generic/path_list--windows.out 与期望输出 tests/fixtures/generic/path_list--windows.json。注意这里路径中含空格也能正确切分因为分隔符是分号而非反斜杠或空格。含环境变量占位符%PROGRAMFILES%\Git\bin;c:\my\folderpath_list--windows-environment.json。从期望 JSON 可以看到%PROGRAMFILES%被当作普通路径分量保留在path_list中jc 不做环境变量展开只负责文本结构化。边界场景与行为验证单元测试 tests/test_path_list.py 通过tests/utils_for_test的通用框架运行两类用例run_no_data无数据输入不报错和run_all_fixturesfixture 输入与期望 JSON 逐一比对。fixture 覆盖了单路径path_list--one.out/abc/def/gh.txt多路径path_list--two.out超长真实 PATHpath_list--long.out内容是一段典型的 macOS 用户 PATH包含 18 个目录项可用于验证长列表的逐项拆分含空格路径path_list--with-spaces.out/User/admin/Application Support/App.app:/User/admin/path验证含空格的分量不会被错误拆分解析器元信息与扩展用法模块内的info类提供解析器元数据jc/parsers/path_list.pyclass info(): version 1.0 description POSIX path list string parser author Michael Nietzold compatible [linux, darwin, cygwin, win32, aix, freebsd] tags [standard, string, slurpable]其中tags里的string表明它属于 jc 的字符串类解析器输入是一段任意文本而非某条系统命令的输出slurpable表明它可以配合--slurp选项使用当一次输入包含多段路径列表文本时jc 会把它们合并解析。该解析器由社区贡献者 Michael Nietzold 编写。实战与 jq 组合的典型查询理解了 Schema 后可以基于真实环境变量做过滤。例如只提取path_list最后一级为bin的条目$ echo $PATH | jc --path-list | jq .[] | select(.filename bin) | .path或者统计每个父目录下有多少个路径项$ echo $PATH | jc --path-list | jq -r .[].parent | sort | uniq -c | sort -rnWindows 场景下同样适用只需保证输入是分号分隔$ echo c:\Program Files (x86)\Git\bin;c:\my\folder | jc --path-list小结path-list解析器以极小的实现体量覆盖了“路径列表结构化”这一常见需求外层parse负责平台感知的分隔符判定与逐段拆分内层复用path解析器和pathlib纯路径对象完成字段提取配合完整的 fixture 测试POSIX 多路径、Windows 驱动器/环境变量/含空格路径保证行为可预期。对于需要脚本化处理PATH等环境变量、或对任意路径串做字段级操作的场景它是 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 lsof 解析器详解将进程打开文件列表lsof转换为结构化 JSONjc lsof 解析器详解将进程打开文件列表lsof转换为结构化 JSON 本文以 jc/parsers/lsof.py https://link.git开发工具jc lsmod 解析器详解把 Linux 内核模块清单转为结构化 JSONjc lsmod 解析器详解把 Linux 内核模块清单转为结构化 JSON 本篇技术指南围绕 jc 项目中的 lsmod 解析器展开覆盖命令行调用方式、P开发工具jc lspci 解析器把 PCI 设备清单输出转换为结构化 JSON 的完整解析机制jc lspci 解析器把 PCI 设备清单输出转换为结构化 JSON 的完整解析机制 本文以 jc 仓库中的 lspci 解析器为核心完整讲解它支持的三种开发工具上一篇awesome-c编译器选择指南GCC、Clang、TCC性能大比拼下一篇HarfBuzz 项目配置优化指南从基础到高级定制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考