开发工具【免费下载链接】CommandLineA pure Swift library for creating command-line interfaces项目地址https://gitcode.com/gh_mirrors/comm/CommandLine点击查看免费下载想写一个像grep、wc那样好用的命令行工具吗CommandLineKit是一个纯 Swift 实现的命令行界面CLI解析库帮你用几行代码搞定参数解析、类型校验和Usage帮助输出并内置完整的错误处理机制ParseErrorprintUsage()。本文带你从零构建一个带完整错误处理的 Swift 命令行文件处理工具全程只需用到它的两个核心 APICommandLine.parse()和Option体系。⚠️ 提示该项目目前已归档README 中注明不再维护仅作历史保留但代码设计非常经典学习成本极低非常适合理解 CLI 解析的原理。先认识 CommandLineKit3个核心文件整个库的代码量很小核心逻辑集中在 CommandLineKit/ 目录下的三个文件文件职责CommandLine.swift主入口类CommandLine负责参数解析、错误抛出与Usage输出Option.swift7 种内置选项类型BoolOption、IntOption、DoubleOption、StringOption、MultiStringOption、CounterOption、EnumOptionStringExtensions.swift字符串工具负责 locale 感知的浮点数解析与文本对齐包描述文件见 Package.swift标准的 Swift Package 结构直接拖进项目即可。快速上手创建你的第一个 Swift CLI 工具第一步clone 仓库git clone https://gitcode.com/gh_mirrors/comm/CommandLine第二步在你的 Swift Package 中声明依赖并在源码中导入CommandLineKit模块。第三步写一个最小可运行的解析器。下面的例子定义了--type选项并打印未解析的剩余参数即位置参数这段用法示例直接来自 CommandLine.swift#L68-L90 的官方文档注释let cli CommandLine() let fileType StringOption(shortFlag: t, longFlag: type, required: true, helpMessage: Type of file) cli.addOptions(fileType) do { try cli.parse() print(File type is \(fileType.value!), files are \(cli.unparsedArguments)) } catch { cli.printUsage(error) exit(EX_USAGE) }运行效果$ ./readfiles --typepdf file1.pdf file2.pdf File type is pdf, files are [file1.pdf, file2.pdf]三个关键机制全部自动完成短/长旗标-t与--type等价还支持--typepdf的连接写法分隔符定义在 CommandLine.swift#L31位置参数没被任何 Option 认领的参数自动收集进unparsedArguments属性做文件处理工具时文件名列表就是从这里来的停止符--遵循 GNU 惯例遇到--后停止解析旗标CommandLine.swift#L23-L26。7种内置 Option 类型选对类型错误处理少一半Option.swift 为每种数据类型都做了类型安全解析——传错类型直接返回失败并抛出错误而不是给你一个nil让你踩坑类型适用场景例子BoolOption开关标志出现即为true--verboseIntOption整数值如行数、超时秒数--max 100DoubleOption浮点值locale 感知自动处理1,5这类欧式写法--ratio 0.75StringOption单个字符串--output result.txtMultiStringOption多个值如文件后缀列表--ext txt mdCounterOption重复出现即计数做详细度-vvvEnumOption限定取值范围的字符串RawValue 为 String 的枚举--mode copy\|move 一个实用技巧CounterOption每出现一次旗标就加 1用来实现-v/-vv/-vvv的详细度开关非常方便定义见 Option.swift#L146-L165。完整错误处理3种 ParseError 一次看全这是 CommandLineKit 最值得学习的部分。parse()会抛出 ParseError共 3 种情况每种都自带人类可读的英文错误描述public enum ParseError: Error, CustomStringConvertible { case invalidArgument(String) // 严格模式下出现未知旗标 case invalidValueForOption(Option, [String]) // 值类型不合法比如给 IntOption 传 abc case missingRequiredOptions([Option]) // 缺少 required: true 的选项 }对应的错误 → 提示闭环只有三步给关键选项设置required: true漏传时自动抛出missingRequiredOptionscatch住parse()抛出的任何错误调用cli.printUsage(error)——它会先把错误原因打印出来再附上完整 Usage 帮助错误信息自动写入 stderr错误流实现见 CommandLine.swift#L33-L39。用户敲错命令时看到的输出大致如下完全零成本获得Missing required options: --type Usage: ./readfiles [options] -t, --type: Type of file实战构建一个统计文件行数的工具现在把它们组装起来——一个名为linecount的文件处理工具对多个文件统计行数支持--min过滤、-v详细输出。核心代码不到 30 行let cli CommandLine() let minLines IntOption(shortFlag: m, longFlag: min, helpMessage: Only list files with at least N lines) let verbose BoolOption(shortFlag: v, longFlag: verbose, helpMessage: Show per-file details) cli.addOptions(minLines, verbose) do { try cli.parse(strict: true) // 严格模式未知旗标直接报错 } catch { cli.printUsage(error) exit(EX_USAGE) } let files cli.unparsedArguments for file in files { guard let count FileManager.default.contents(atPath: file, as: String) .map({ $0.components(separatedBy: .newlines).count }) else { FileHandle.standardError.write(Error: cannot read \(file)\n.data(using: .utf8)!) continue } if verbose.value { print(\(file): \(count) lines) } if let min minLines.value, count min { print(\(count)\t\(file)) } }几个值得注意的设计点parse(strict: true)严格模式下任何未定义的旗标都会抛出invalidArgument实现见 CommandLine.swift#L287-L292防止用户拼错--verbsoe却静默忽略业务错误与解析错误分离文件读不出来属于运行时错误单独输出到 stderr 并继续处理下一个文件而不是让整个工具崩溃——这就是完整错误处理的分层思路required按需使用--min不设为必填因为它有默认行为不过滤。进阶技巧自定义 Usage 输出格式默认格式由defaultFormat提供对齐、缩进都做好了但如果你想让错误信息更醒目或改成自己的排版只需给formatOutput闭包赋值。它能区分 4 种输出类型aboutUsage 头、error错误行、optionFlag旗标行、optionHelp帮助文字定义在 CommandLine.swift#L138-L150。一个典型用途把错误信息转成大写强调显示完整示例见 CommandLine.swift#L98-L116。另外maxFlagDescriptionWidth属性会把最长旗标描述的宽度暴露给自定义格式化函数方便你手动对齐两列文本。跑测试验证理解行为边界的最快方式仓库自带的 CommandLineTests.swift约 900 行、30 个用例是最好的活文档覆盖了你日常最关心的边界行为testStrictMode严格模式下未知旗标的报错路径testMissingRequiredOption必填选项缺失时的错误描述testAttachedArgumentValues--flagvalue连接写法testArgumentStopper--停止符testConcatOptionWithValue-xvf file1 file2这种短旗标连写。Linux 环境可用仓库内的 script/test 一键执行swift buildswift testmacOS 上直接swift test即可。小结CommandLineKit 给新手的核心经验经验对应机制用required: true表达必填参数ParseError.missingRequiredOptions用类型化 Option 代替手动转型IntOption/DoubleOption等自动校验统一用printUsage(error)输出错误帮助自动写 stderr零成本用strict: true拦截拼错的旗标ParseError.invalidArgument位置参数文件名列表不要自己切unparsedArguments自动收集CommandLineKit 虽已归档但它选项即类型、解析即校验、错误即帮助的设计放在今天写任何 CLI 工具包括用新库时依然通用。把上面这套 3 步错误处理闭环练熟你的 Swift 命令行工具就具备了专业级的健壮性 赞分享开发工具【免费下载链接】CommandLineA pure Swift library for creating command-line interfaces项目地址https://gitcode.com/gh_mirrors/comm/CommandLine点击查看免费下载相关推荐dat命令行错误处理构建健壮的P2P工具dat命令行错误处理构建健壮的P2P工具 你是否遇到过P2P文件同步时连接丢失却毫无提示或命令执行失败后程序直接崩溃本文将带你深入了解dat命令行工具的错数据工程开发工具Spotify开发者账号注册与配置快速获取API凭证的完整指南Spotify开发者账号注册与配置快速获取API凭证的完整指南 Spotify Web API Examples项目提供了使用Spotify Web API进掌握aws-cli错误处理构建健壮命令行工具的完整指南掌握aws cli错误处理构建健壮命令行工具的完整指南 aws cli作为Amazon Web Services的通用命令行界面是云服务管理的核心工具。在日开发工具云原生运维创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
