clutch 🪺 从依赖巢运行 Swift 脚本

• 对等名称是初始文件名段（在 . 之前）。
  • 巢名称是任何尾随段（忽略 .swift）
    • 如果没有尾随段，clutch 使用默认巢 Nest。
  • 巢和对等名称都必须是有效的 ASCII 标识符。
• 该文件是可执行的。
• 第一行的 hash-bang 取决于您安装 clutch 的位置
  • #!/usr/bin/env clutch （最佳，如果 clutch 在您的 PATH 中）
  • #!/path/to/clutch （当 clutch 已安装但不在 PATH 中时）
• 脚本文件具有有效的顶层代码，仅依赖于巢库。

巢对等文件在 {nest}/Sources/{peer} 中将在首次印象时创建。对等文件名是 main.swift，或者如果它包含 @main，则为 {peer}.swift。

Package.swift 将更新为对等产品和目标声明

• .executable(name: "{peer}", targets: [ "{peer}" ]),
• .executableTarget(name: "{peer}", dependencies: ["{nest}"]),

// in Package.swift (e.g., as created by `swift package --init`)

products: [
  // peer product created for each script, using the script name {peer}
  .executable(name: "{peer}", targets: [ "{peer}" ]),
  .library(name: "{nest}", targets: ["{nest}"]),
],
targets: [
  // peer executable created for each script
  .executableTarget(name: "{peer}", dependencies: ["{nest}"]),
  .target(
    name: "{nest}",
    dependencies: [ ... ] 

巢目录名称必须是库模块的名称。

有关示例巢包，请参阅 nests 或使用 swift package init --type library。

默认情况下，clutch 使用 -c debug --quiet 构建（以避免延迟和噪音），巢包名为 Nest，并且它位于 $HOME/git/Nest。

您可以配置巢位置、输出或构建标志。

配置很少需要（主要只是 CLUTCH_NEST_RELPATH 直接更改 git 父目录）。

要配置，请设置环境变量

• CLUTCH_NEST_NAME: 在 $HOME/{relative-path}/{nest-name} 中查找巢
• CLUTCH_NEST_RELPATH: 从 HOME 的相对路径（默认为 git）
• CLUTCH_NEST_BASE: 在 $CLUTCH_NEST_BASE/{nest-name} 中查找巢，而不是在默认位置
• CLUTCH_NEST_PATH: 巢目录的完整路径（忽略其他变量）
• CLUTCH_LOG: 任何值都将 clutch 构建步骤记录到标准错误
• CLUTCH_BUILD: @{arg0}@{arg1}.., 或 {release} {loud | verbose}
  • 特殊值 release、loud 和 verbose 生成适当的构建标志。
  • 任意 @ 分隔的参数将传递给 swift build 命令。

clutch name{.Nest}             # Run peer by name
clutch [peers|path]-Nest       # Emit Nest peers or location
clutch [cat|path]-name{.Nest}  # Emit peer code or location

直接使用 clutch 按文件名或对等名称运行脚本

clutch name.swift      # Create/build/run `name` from default nest
clutch name            # Run by name

使用 clutch 列出巢中的对等文件，并查找或复制对等源文件

clutch peers-Data      # List peers in the `Data` nest
clutch path-name       # Echo path to source file for peer `name`
clutch cat-init.Data   # Output code from peer `init` in Data nest

• 对于新脚本，@main 检测非常简单（并且不针对更新执行）。
• 对于新脚本，Package.swift 编辑也是一个简单的扫描。
  • 它搜索 products: 和 targets: （后者带有 2 个前导空格）
    • target: 很常见；请避免在其前使用 2 个空格。
    • 并且请避免在注释或其他声明中使用该文本。
  • 为避免错过/无效的插入，请标记声明之前的行：使用 CLUTCH_PRODUCT 或 CLUTCH_TARGET
• 用户必须手动编辑包以重命名/删除对等文件或修复错误。
  • 要删除，请删除 Sources/peer 和 Package.swift 中对等文件的两行
• 构建仅基于上次修改时间。
  • 在编辑导致相同代码后，Swift 不会重新链接二进制文件（因此第二次 clutch 运行将触发另一个空操作构建）。
• 输出流和退出代码混合了 clutch、swift build 和可执行文件。
  • 失败的退出代码将始终为 1（即使脚本以 2 退出）。