# coreutils-swift **Repository Path**: codelint/coreutils-swift ## Basic Information - **Project Name**: coreutils-swift - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-20 - **Last Updated**: 2026-11-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # coreutils-swift 用纯 Swift 标准库 + Foundation 实现的跨平台核心命令行工具集,提供库与命令行两种使用方式。零第三方依赖。 ## 架构 | Target | 类型 | 平台 | 职责 | |---|---|---|---| | `CoreUtils` | 库 | macOS / iOS / Linux | 纯函数式核心逻辑,三平台可用 | | `scu` | 命令行 | macOS / Linux | 参数解析、stdin/stdout、退出码 | 库层不依赖任何 CLI 语义(不用 `stdin/stdout/exitCode`),文本处理以 `Data`/`String` 输入输出,文件系统操作显式传 `URL`——因此 iOS App 可直接 `import CoreUtils` 使用文本处理能力。 ## 快速开始 ```bash # 构建 swift build -c release # 运行 CLI .build/release/scu echo hello printf 'banana\napple\n' | .build/release/scu sort # 运行测试 swift test ``` 在 Swift App 中使用库: ```swift import CoreUtils let sorted = sort(splitLines("banana\napple\n")) print(joinLines(sorted)) let encoded = base64Encode(Data("hello".utf8)) ``` ## 文档 - [命令行使用说明](Docs/command.md) - [库 API 文档](Docs/api/README.md) - [文本处理](Docs/api/TextProcessing.md) - [排序与字段处理](Docs/api/SortingAndFields.md) - [字符处理与格式化](Docs/api/CharacterProcessing.md) - [编码与转储](Docs/api/Encoding.md) - [哈希与校验](Docs/api/Hashing.md) - [路径与文件系统](Docs/api/FileSystem.md) - [条件与分割](Docs/api/ConditionsAndSplit.md) ## 工具范围 共实现约 40 个工具: - **文本处理**:`echo` `printf` `yes` `cat` `head` `tail` `tee` `wc` `nl` - **排序与字段**:`sort` `uniq` `cut` `paste` `join` `comm` - **字符与格式化**:`tr` `expand` `unexpand` `fold` `fmt` `pr` - **编码与转储**:`base32` `base64` `od` - **哈希与校验**:`md5sum` `sha1sum` `sha224sum` `sha256sum` `sha384sum` `sha512sum` `b2sum` - **分割**:`split` `csplit` - **路径与文件**:`basename` `dirname` `realpath` `pathchk` `pwd` `touch` `mkdir` `rmdir` `unlink` `cp` `mv` `ls` `mktemp` - **条件**:`true` `false` `test` 以下工具不在范围内,因为 Swift 标准库与 Foundation 不提供所需能力:权限与所有权修改(`chmod`/`chown`/`chgrp`)、链接(`ln`)、完整文件状态(`stat`)、磁盘用量(`df`/`du`)。 ## 测试 共 173 项测试,其中 117 项为库单元测试、56 项为 CLI 进程级测试(参数解析、长选项、`--`、帮助/版本、退出码与 GNU 对齐行为),全部通过。 ## 平台验证状态 | 平台 | 状态 | |---|---| | macOS | 构建(debug/release)、CLI 运行、173 项测试全部通过 | | iOS | 库 target 交叉编译通过(arm64-apple-ios17.0);运行时测试待真机/模拟器环境 | | Linux | release 构建无警告、173 项测试全部通过、CLI 交叉比对通过 | ## 已知限制 - `tail -f` 使用轮询实现,`--follow=name` 与 `--follow=descriptor` 不区分 - `sort --debug` 的 `^` 标记输出为语义近似,未与 GNU 的装饰细节逐字节对齐 - `pr` 双栏布局为预留字段,未完整实现 - 浮点格式化 `printf` 在 Linux (corelibs-foundation) 可能与 macOS 有细微差异