jc --kv 实战指南：Key/Value 配置文件与字符串的 JSON 化解析（jc.parsers.kv）

开发工具【免费下载链接】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.parsers.kv是 jc 项目中专用于 Key/Value 文件的解析器它把包含简单键值对的文本如网络配置、环境变量、自定义清单文件转换成 JSON、YAML 或 Python 字典便于通过jq等工具做进一步筛选与自动化。读完本文你可以掌握--kv的命令行与模块两种用法、完整的解析规则分隔符、注释、重复键、引号处理并能从 jc/parsers/kv.py 与底层 jc/parsers/ini.py 的源码理解其基于 Python 标准库configparser的实现机制。kv 解析器做什么jc 的定位是把常用命令行工具的输出、文件类型和常见字符串统一转换成 JSON/YAML/字典。kv解析器处理的是其中最常见的一类文本扁平的键值对文件——没有 INI 的[section]分节文件顶层就是一系列key value或key: value行。典型适用场景包括解析/etc/sysconfig/network-scripts/ifcfg-*之类的网络配置文件将环境变量清单、导出变量文件KEYvalue形式转为结构化数据处理任意自定义的简单键值清单再交给jq提取字段。解析结果是一个扁平的字典顶层键全部映射到字符串值不会自动推断布尔、数字等类型。例如测试夹具中value2 true解析后是字符串truevalue4 3.14解析后是字符串3.14见 tests/fixtures/generic/keyvalue.json。解析规则根据 docs/parsers/kv.md 的说明kv 解析器遵循以下规则规则说明分隔符可以是或:可混用如name John Doe与age: 34缺失值支持。只有键没有或:值时该键的值为空字符串注释前缀#或;注释必须独占一行不支持行尾注释重复键如果找到重复键只保留最后一个值引号处理以引号开头和结尾的值会默认去掉引号使用-r命令行参数或parse()的rawTrue参数可保留其中引号处理值得展开从源码看去引号逻辑由 jc/utils.py 中的remove_quotes()函数实现——只有当值同时以双引号开头和结尾或同时以单引号开头和结尾时才剥离引号引号出现在值中间、或首尾引号类型不一致时保持原样。测试用例test_kv_doublequote/test_kv_singlequote验证了双引号与单引号两种情况而 tests/fixtures/generic/keyvalue-ifcfg.txt 中还有更细致的边界数据例如this value has quotations at the beginning but not the end这类首尾不对称的值不会被动引号逻辑影响。CLI 用法基本用法是把键值文件管道给jc --kv$ cat foo.txt | jc --kv配合-ppretty print查看格式化输出$ cat keyvalue.txt | jc --kv -p保留引号则加-r$ cat keyvalue.txt | jc --kv -r -p模块用法在 Python 脚本中作为库调用import jc result jc.parse(kv, kv_file_output)parse()函数签名与参数见 docs/parsers/kv.md 与 jc/parsers/kv.pydef parse(data, rawFalse, quietFalse)参数类型说明datastring待解析的文本数据rawboolean为True时返回未经处理的原始输出不做引号剥离与None转空串quietboolean为True时抑制警告信息返回值为表示键值对文档的字典。输入输出示例官方文档给出的完整示例。输入文件keyvalue.txt# this file contains key/value pairs name John Doe address555 California Drive age: 34 ; comments can include # or ; # delimiter can be or : # quoted values have quotation marks stripped by default # but can be preserved with the -r argument occupation:Engineer执行cat keyvalue.txt | jc --kv -p输出{ name: John Doe, address: 555 California Drive, age: 34, occupation: Engineer }这个例子同时覆盖了全部解析规则#与;两种注释、与:两种分隔符、分隔符前后有无空格的写法差异以及带引号值occupation:Engineer的引号剥离。再看一个更贴近实战的输入——仓库测试夹具 tests/fixtures/generic/keyvalue.txtvalue1 hello value2 true no_value value4 3.14 value5: 42其对应输出 tests/fixtures/generic/keyvalue.json{value1: hello, value2: true, no_value: , value4: 3.14, value5: 42}这里可以看到两个关键行为裸键no_value没有任何分隔符解析为空字符串而不是报错所有值无论内容都输出为字符串类型。夹具 tests/fixtures/generic/keyvalue-ifcfg.txt 则模拟了典型的 ifcfg 网络配置TYPEEthernet PROXY_METHODnone BOOTPROTOdhcp IPV6_ADDR_GEN_MODEstable-privacy NAMEens33 ONBOOTyes value_with_spaces: this value includes spaces value_with_quotes_inside this value has quotation marks inside解析结果tests/fixtures/generic/keyvalue-ifcfg.json中首尾成对的引号被剥离TYPE变为Ethernet而值中间或首尾不对称的引号如value_with_quotes_inside原样保留。输出 Schemakv 解析器把键值文档直接转换为字典{ key1: string, key2: string }由于解析基于 Python 标准库configparser行为细节可参照该标准库模块的文档。与--ini解析器相比kv 面向无分节的扁平文件结果中不会出现嵌套的 section 字典分节文件请见 docs/parsers/ini.md。源码实现kv 是 ini 的别名打开 jc/parsers/kv.py 会发现它非常短——核心实现只有几行def parse(data, rawFalse, quietFalse): # This parser is an alias of ini.py ini.info info # type: ignore ini.__name__ __name__ return ini.parse(data, raw, quiet)也就是说jc --kv实际复用了 INI 解析器 jc/parsers/ini.py 的全部解析逻辑只在元数据info类版本 2.2、描述、tags 为[generic, file, string]上换成自己的身份。从源码结构看这种别名设计意味着 kv 与 ini 共享同一套规则演进维护成本很低。底层ini.parse()的关键实现细节同样作用于 kvconfigparser 构造参数jc/parsers/ini.pyallow_no_valueTrue允许只有键没有值的行configparser返回None后续统一转为空字符串interpolationNone禁用%插值值中的%字符不会被特殊解释default_sectionNone不注入默认节strictFalse允许重复键而不抛异常天然实现重复键取最后一个值的语义。大小写保留ini_parser.optionxform lambda option: option键名不做小写化configparser默认会转小写所以TYPE与type是两个不同的键。无节头兜底jc/parsers/ini.pyconfigparser要求文件以[section]开头纯键值行会触发MissingSectionHeaderError。解析器捕获该异常后给输入临时拼上一个用 UUID 生成的假节头解析完成后把假节下的条目提升回字典根层再合并其余真实 section。这就是 kv 能直接处理无分节文件的原因。后处理_process()jc/parsers/ini.py遍历结果把None转为空字符串再对每个值调用jc.utils.remove_quotes()剥离首尾成对引号rawTrue时跳过该步骤直接返回原始数据此时缺值键为None。解析前还有两道通用检查jc/parsers/ini.pyjc.utils.compatibility()校验当前操作系统是否在支持列表中jc.utils.input_type_check()校验输入类型空输入经jc.utils.has_data()判定后直接返回空字典{}。测试用例验证tests/test_kv.py 对 kv 解析器的规则做了完整覆盖test_kv_nodata空输入返回{}test_kv_keyvalue/test_kv_keyvalue_ifcfg分别用上述两个夹具文件做输入/输出全量比对test_kv_duplicate_keys内联构造重复键数据断言duplicate_key只保留后出现的value2test_kv_doublequote/test_kv_singlequote双引号与单引号包裹的值都被剥离引号。运行方式参考 runtests.sh$ python -m pytest tests/test_kv.py -v相关解析器kv_dup如果重复键不应该互相覆盖jc 提供了姊妹解析器kv_dupjc/parsers/kv_dup.pydocs/parsers/kv_dup.md它把每个键的值存成列表重复键的多个值全部保留。例如occupation:Engineer与occupation Pilot两行会得到occupation: [Engineer, Pilot]。它同样是 jc/parsers/ini_dup.py 的别名引号剥离规则与 kv 一致。解析器重复键行为值类型命令行kv只保留最后一个值单个字符串jc --kvkv_dup全部保留字符串列表jc --kv-dup兼容性说明根据 docs/parsers/kv.md 与解析器元数据kv 解析器声明兼容的平台为linux、darwin、cygwin、win32、aix、freebsd见 jc/parsers/kv.py。由于底层只依赖 Python 标准库configparser实际限制主要在 jc 自身的平台检查上。解析器版本为 2.2info.version作者 Kelly Brazil。小结jc --kv提供了一个零依赖、规则明确的键值文本 JSON 化通道/:双分隔符、#/;独占行注释、重复键取最后值、缺值转空串、成对引号默认剥离-r保留。当你的自动化脚本需要把 ifcfg、env 清单之类的小配置文件接入jq或 Python 流水线时它是成本最低的方案之一需要保留重复键时切换到--kv-dup即可。赞分享开发工具【免费下载链接】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点击查看免费下载相关推荐Pydantic JSON 解析与序列化内置 jiter 解析器、Partial JSON 与字符串缓存实战指南Pydantic JSON 解析与序列化内置 jiter 解析器、Partial JSON 与字符串缓存实战指南 导读 本文聚焦 Pydantic 的 JSO后端序列化go-micro 集成 NATS JetStream Key-Value Storenatsjs-kv 存储插件完整实战指南go micro 集成 NATS JetStream Key Value Storenatsjs kv 存储插件完整实战指南 本篇指南围绕 go micro后端微服务AI AgentRPC框架OpenCodex OpenAI 三档加固Direct / Multi / API 分层、GPT-5.6 Pro 虚拟模型与迁移审计全解析OpenCodex OpenAI 三档加固Direct / Multi / API 分层、GPT 5.6 Pro 虚拟模型与迁移审计全解析 OpenCodex上一篇终极指南Backstage内存泄漏检测与预防全攻略下一篇突破系统限制KernelSU模块动态加载机制全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考