首页/新闻资讯/正文详情

Optique解析器组合子速查表:object、or、merge、optional、multiple、map六大核心函数完全掌握

发布时间:2026/11/20 6:27:07 来源:云帆数科 栏目:资讯中心
Optique解析器组合子速查表:object、or、merge、optional、multiple、map六大核心函数完全掌握
【免费下载链接】optiqueType-safe combinatorial CLI parser for TypeScript项目地址https://gitcode.com/gh_mirrors/op/optique点击查看免费下载Optique 是一个面向 TypeScript 的类型安全组合式 CLI 解析器type-safe combinatorial CLI parser。这份速查表聚焦最常被用到的六大组合子——object()、or()、merge()、optional()、multiple()、map()用最少的代码讲清楚每个函数做什么、类型如何变化、什么时候该选它帮你在构建子命令、共享选项、重复参数等场景时快速选对组合子。 一屏速查表六大组合子怎么选组合子一句话定位结果类型所在模块object()把命名字段组成结构化对象对象字段名→值optique/core/constructsor()互斥备选按顺序逐个尝试联合类型可收窄optique/core/constructsmerge()把多个解析器合并成一个对象合并后的对象optique/core/constructsoptional()允许字段缺失T \| undefinedoptique/core/modifiersmultiple()收集重复出现为数组数组T[]optique/core/modifiersmap()变换解析出的值映射后的类型Uoptique/core/modifiers记忆口诀object 按名分组、or 选一个、merge 组合并组、optional 允许缺席、multiple 收集重复、map 变换结果。1️⃣ object()多数 CLI 结构的地基object()接收一个字段名 → 解析器的映射返回结构化对象是几乎所有 CLI 应用的基础构件。const serverConfig object({ name: argument(string({ metavar: NAME })), port: option(-p, --port, integer()), verbose: option(-v, --verbose), });关键要点无需手写类型注解InferValuetypeof serverConfig会自动推导出完整对象类型。第一个参数可传标签如object(Network, {...})帮助文本中会显示为分组标题。整体优先级取组成解析器中的最高值因此内嵌的 command 字段会优先被尝试。源码入口packages/core/src/constructs.ts。2️⃣ or()互斥模式与子命令分发or()按顺序尝试每个备选直到某一个成功是server 模式 / client 模式以及子命令结构的标准做法。const gitLike or( command(add, object({ type: constant(add), files: multiple(argument(string())), })), command(commit, object({ type: constant(commit), message: option(-m, --message, string()), })), );关键要点配合constant()字段会形成 TypeScript 判别联合discriminated union可对type字段写类型安全的switch。单次or()调用最多 15 个分支更多时拆成嵌套分组。想让一个都不选也合法并得到undefined用optional()包住整个or()。错误消息可通过errors.noMatch选项自定义会根据上下文期望的是 option / command / argument自动适配措辞。源码入口packages/core/src/constructs.ts可运行示例见 examples/patterns/subcommands.ts 与 examples/patterns/mutually-exclusive-options.ts。3️⃣ merge()模块化复用选项组merge()把多个产生对象的解析器合并为一个解析器是实现同一选项组在多个命令间复用的关键。const globalOptions object({ verbose: option(-v, --verbose), config: option(-c, --config, string()), }); const deployParser merge(globalOptions, deployOptions);关键要点最常见模式是merge(globals, or(...))把全局选项提到每个子命令分支之外避免在每条命令里重复声明。不限于object()withDefault()、map()等产生对象的解析器同样可以合并类型会智能推断。与or()一样受 15 个参数上限约束也支持标签参数在帮助文本中整组显示。可用optional()包裹某个对象组让整个分组变成可选功能组不与必填参数冲突。源码入口packages/core/src/constructs.ts实战配方见 examples/patterns/shared-options.ts。4️⃣ optional()显式允许未提供optional()让任何解析器变成可选匹配成功就返回其值失败则返回undefined不报错、不消耗输入。const backupConfig object({ source: argument(string({ metavar: SRC })), compress: optional(option(-c, --compress, choice([gzip, bzip2]))), });关键要点类型从T变为T | undefined编译器会强制你处理值可能不存在的情况避免运行时误判。当值缺失本身有语义时使用它如果你想要一个兜底值而不是undefined应改用withDefault()。它是把or()变成全部可选的标准搭配optional(or(flagA, flagB))。源码入口packages/core/src/modifiers.ts。5️⃣ multiple()重复参数收集成数组multiple()允许解析器多次匹配并把所有结果收集到数组中适合多个输入文件、include 路径、环境变量等可重复选项。const parser object({ files: multiple(argument(string()), { min: 1, max: 5 }), includes: multiple(option(-I, --include, string())), });关键要点未提供任何匹配时返回空数组而非失败因此重复选项天然可选取值前无需判空。约束选项{ min, max }控制最少与最多出现次数例如恰好 2~4 个文件。常与map()搭配把数组转成Set去重小写或 key-value 对象。源码入口packages/core/src/modifiers.ts。6️⃣ map()变换解析结果map()用映射函数变换解析结果同时保留原解析逻辑适合类型转换、格式归一化、派生字段等场景。const parser object({ upperName: map(option(-n, --name, string()), (name) name.toUpperCase()), tags: map(multiple(option(-t, --tag, string())), (tags) new Set(tags.map((tag) tag.toLowerCase()))), });关键要点变换函数必须返回新值不能原地修改输入延迟提示解析时输入可能是共享占位引用原地修改会污染后续解析。支持链式流式写法如option(--port, integer()).map((v) v 1).withDefault(3001)与独立函数写法等价。常与or()搭配把每个分支的 flag 映射成字符串标签map(flag(--verbose), () verbose as const)让联合类型更可读。源码入口packages/core/src/modifiers.ts。 典型组合套路组合子的威力在套娃场景典型组合子命令 全局选项merge(globals, or(cmdA, cmdB, ...))全部可选的互斥项optional(or(flagA, flagB))详细度等级数 flag 次数optional(map(multiple(flag(--verbose)), (v) v.length))重复参数转 Set / 对象map(multiple(option(-t, string())), ...)条件性选项组merge(withDefault(object({...}), { flag: false }), globalOptions)组合之后帮助文本、shell 补全、man 页面都由同一个解析器定义生成无需手工同步维护。组合子产生的错误信息如or()的noMatch同样是结构化 Message选项名、值、metavar 会在终端中着色高亮管道或 CI 环境下自动降级为带引号的纯文本方便脚本消费。更多细节见 docs/concepts/messages.md。 选型决策流拿不准时按这个顺序问自己想把一堆字段按名字组织成对象 →object()要几个里选一的互斥模式或子命令 →or()想把同一组选项在多处复用 →merge()某字段允许不出现 →optional()某参数可以出现多次 →multiple()想在解析后变换值 →map()如果结果类型长得不对先想少套了哪个组合子而不是重写整个解析器——这正是组合式解析器复杂行为由简单积木组合的核心思想。 参考资料构造组合子官方文档docs/concepts/constructs.md修饰组合子官方文档docs/concepts/modifiers.md核心实现源码packages/core/src/constructs.ts、packages/core/src/modifiers.ts可运行模式示例目录examples/patterns/推荐从 conditional-options.ts、dependent-options.ts、verbosity-levels.ts 入手赞分享【免费下载链接】optiqueType-safe combinatorial CLI parser for TypeScript项目地址https://gitcode.com/gh_mirrors/op/optique点击查看免费下载相关推荐如何跨 1000 多个网站查出社交账号Social-Analyzer 完整实操指南如何跨 1000 多个网站查出社交账号Social Analyzer 完整实操指南 手里只有一个用户名想知道这个人出现在哪些网站上逐个打开上千家站点去猜不后端网络安全网页爬虫Pixelle-Video终极指南AI全自动短视频创作从入门到精通Pixelle Video终极指南AI全自动短视频创作从入门到精通 Pixelle Video是一款革命性的AI全自动短视频引擎能够将你的创意想法一键转化为人工智能AI 应用媒体生成视频视频处理语音数字人MCP 服务Reactor Core 组合操作符终极指南掌握 zip、combineLatest、merge 三大核心工具Reactor Core 组合操作符终极指南掌握 zip、combineLatest、merge 三大核心工具 在反应式编程的世界中Reactor Core后端异步编程上一篇Bili2text终极指南3步完成B站视频转文字轻松获取视频字幕内容下一篇5步搞定bili2text安装错误从零到完美运行的全流程指南 创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

Snapdrop 免安装零注册,3步搞定跨设备文件传输
Snapdrop 免安装零注册,3步搞定跨设备文件传输

Snapdrop 免安装零注册,3步搞定跨设备文件传输 【免费下载链接】snapdrop A Progressive Web App for local file sharing 项目地址: https://gitcode.com/gh_mirrors/sn/snapdrop 手机拍了个 200MB 的视频,想传到电脑桌面。走即时通讯软件会被压… · 2026/11/20 6:27:05

Jasna 视频马赛克修复指南:GPU 加速、免费模型选型与显存调优实战
Jasna 视频马赛克修复指南:GPU 加速、免费模型选型与显存调优实战

Jasna 视频马赛克修复指南:GPU 加速、免费模型选型与显存调优实战 【免费下载链接】jasna Video restoration tool 项目地址: https://gitcode.com/GitHub_Trending/ja/jasna Jasna 是一款免费开源(AGPL-3.0)的 GPU 加速视频马赛克修复… · 2026/11/12 20:45:36

小爱音箱自定义固件:打造完全开源的智能语音助手
小爱音箱自定义固件:打造完全开源的智能语音助手

小爱音箱自定义固件:打造完全开源的智能语音助手 【免费下载链接】xiaoai-patch Patching for XiaoAi Speakers (小爱音箱), add custom binaries and open source software. Tested on LX06, LX01, LX05, L09A 项目地址: https://gitcode.com/GitHub_Trending/xi… · 2026/11/19 16:40:30

重庆电工证全部重考吗 怎么报名不被学历卡住
重庆电工证全部重考吗 怎么报名不被学历卡住

重庆电工证全部重考吗 怎么报名不被学历卡住 你是不是正愁学历不高,怕报不上电工证?重庆电工证全部重考吗这个问题,其实很多人都在问。特别是在施工行业干了几年的你,可能更清楚,没证就没办法上岗,证书不合规就可能被清退。今天咱们就从一个郑州中小施… · 2026/11/20 6:32:30

电工证异地能用么真实经历告诉你怎么办
电工证异地能用么真实经历告诉你怎么办

电工证异地能用么真实经历告诉你怎么办 学历不高怕报不上名?我也是从零开始的,现在手里有高压电工证、低压电工证,还带过几个徒弟。说实话,刚开始听说要考证,心里也打鼓,担心学历不够、操作经验不足,根本报不上名。但经过几年的实践,我才知道,… · 2026/11/20 6:32:30

元氏办电工证在哪里内部消息曝光!急需电工证才能上岗找工作
元氏办电工证在哪里内部消息曝光!急需电工证才能上岗找工作

元氏办电工证在哪里内部消息曝光!急需电工证才能上岗找工作 你是不是正被“ 急需特种作业证才能上岗找工作 ”这个问题折磨得焦头烂额?别急,今天就给你 内部消息 ,讲讲 元氏办电工证在哪里… · 2026/11/20 6:32:30

初级水电工证补助郑州报考避坑指南
初级水电工证补助郑州报考避坑指南

初级水电工证补助郑州报考避坑指南 证书过期了不知道怎么复审延期?这可能是很多初级水电工从业者遇到的难题。尤其是在郑州地区,报考和复审流程复杂,容易踩坑。今天我们就来聊聊【初级水电工证补助】的相关内容,尤其是针对信阳浉河区转岗从业者,从考试内… · 2026/11/20 6:32:30

吉林市考登高架设证千万别踩坑,新手必看避坑指南
吉林市考登高架设证千万别踩坑,新手必看避坑指南

吉林市考登高架设证千万别踩坑,新手必看避坑指南 现在找工作越来越难,很多人在面试时都会被问到:“你有特种作业证吗?”没有相关证书,连基本的面试资格都没有。如果你正在准备考【吉林市考登高架设证】,那一定要认真看完这篇, 千万别踩坑… · 2026/11/20 6:32:30

低压电工证过期了怎么办?广陵低压电工作业+郑州报考避坑指南
低压电工证过期了怎么办?广陵低压电工作业+郑州报考避坑指南

低压电工证过期了怎么办?广陵低压电工作业+郑州报考避坑指南 证书过期了不知道怎么复审延期,这个问题在我们这行太常见了。上周有个新乡房建项目的电工小李找到我,他的低压电工证已经到期三个月了,现在公司安排他去带电作业,结果被项目安全员当场叫停,… · 2026/11/20 6:31:30

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/19 16:06:02

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/19 17:40:37

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/19 17:50:07

建设厅特种工周三报名怎么弄?上岗必备别被中介坑
建设厅特种工周三报名怎么弄?上岗必备别被中介坑

建设厅特种工周三报名怎么弄?上岗必备别被中介坑 不知道去哪报名怕被中介坑?作为商丘某高校工程类应届毕业生,小李最近就遇到了这样的困扰。他刚毕业,正在找实习岗位,发现很多工地都要求持有特种作业操作证,尤其是【建设厅特种工周三报名】这个时间点,… · 2026/11/20 0:00:54

中专考的中级电工证内部消息全攻略
中专考的中级电工证内部消息全攻略

中专考的中级电工证内部消息全攻略 你中专毕业,手头有中级电工证,但不知道从哪开始报名,怕被中介坑?别急,这篇文章就是为你量身定制的“内部消息”,帮你避开报名陷阱,稳稳拿到证书。… · 2026/11/20 0:00:54

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价
外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 之前考的证在外省能不能转过来?这几乎是所有在外地打拼的电工从业者最关心的问题。特别是像洛阳这样的工业城市,很多电工证是在外地考的,现在想在当地用,流程是不是很复杂?其实,只要搞清楚… · 2026/11/20 0:00:54

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码