Shell 规则

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

规则

sh_binary

查看规则源代码 
sh_binary(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, output_licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

sh_binary 规则用于声明可执行的 Shell 脚本。 （sh_binary 是一个误称：其输出不一定是二进制文件。）此规则可确保 所有依赖项都已构建，并在执行时显示在 runfiles 区域中。 我们建议您根据脚本名称（不含扩展名，例如 .sh）为 sh_binary() 规则命名；规则名称和文件名必须不同。sh_binary 遵循 Shebang，因此可以使用任何可用的解释器（例如 #!/bin/zsh）

示例

对于没有依赖项和一些数据文件的简单 Shell 脚本： 

sh_binary(
    name = "foo",
    srcs = ["foo.sh"],
    data = glob(["datafiles/*.txt"]),
)

实参

属性
name

名称；必需

此目标的唯一名称。
deps

标签列表；默认值为 []

要聚合到此目标中的“库”目标列表。 如需了解有关 deps 的一般注释，请参阅大多数构建规则定义的 典型属性。

此属性应用于列出其他 sh_library 规则，这些规则提供 srcs 中的代码所依赖的解释型程序源代码。这些规则提供的文件将存在于此目标的 runfiles 中。
srcs

标签列表；默认值为 []

输入文件列表。

此属性应用于列出属于 此库的 Shell 脚本源文件。脚本可以使用 Shell 的 source 或 . 命令。

env_inherit

字符串列表；默认值为 []

sh_library

查看规则源代码 
sh_library(name, deps, srcs, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

此规则的主要用途是将相关脚本（一种解释型语言的程序，不需要编译或链接，例如 Bourne Shell）以及这些程序在运行时所需的任何数据聚合在一起，形成一个逻辑 "库"。然后，可以从 一个或 多个 sh_binary 规则的 data 属性中使用此类“库”。

您可以使用 filegroup 规则来聚合数据 文件。

在解释型编程语言中，“代码”和“数据”之间并不总是存在明确的 区别：毕竟，从解释器的角度来看，程序只是 “数据”。因此，此规则具有三个属性，它们本质上是等效的：srcs、deps 和 data。当前实现不会区分这些列表的元素。这三个属性都接受规则、源文件和生成的文件。 不过，最好将这些属性用于其常用用途（与其他规则一样）。

示例

sh_library(
    name = "foo",
    data = [
        ":foo_service_script",  # an sh_binary with srcs
        ":deploy_foo",  # another sh_binary with srcs
    ],
)

实参

属性
name

名称；必需

此目标的唯一名称。
deps

标签列表；默认值为 []

要聚合到此目标中的“库”目标列表。 如需了解有关 deps 的一般注释，请参阅大多数构建规则定义的 典型属性。

此属性应用于列出其他 sh_library 规则，这些规则提供 srcs 中的代码所依赖的解释型程序源代码。这些规则提供的文件将存在于此目标的 runfiles 中。
srcs

标签列表；默认值为 []

输入文件列表。

此属性应用于列出属于 此库的 Shell 脚本源文件。脚本可以使用 Shell 的 source 或 . 命令。

sh_test

查看规则源代码 
sh_test(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, local, restricted_to, shard_count, size, tags, target_compatible_with, testonly, timeout, toolchains, visibility)

sh_binary 规则用于声明可执行的 Shell 脚本。 （sh_binary 是一个误称：其输出不一定是二进制文件。）此规则可确保 所有依赖项都已构建，并在执行时显示在 runfiles 区域中。 我们建议您根据脚本名称（不含扩展名，例如 .sh）为 sh_binary() 规则命名；规则名称和文件名必须不同。sh_binary 遵循 Shebang，因此可以使用任何可用的解释器（例如 #!/bin/zsh）

示例

对于没有依赖项和一些数据文件的简单 Shell 脚本： 

sh_binary(
    name = "foo",
    srcs = ["foo.sh"],
    data = glob(["datafiles/*.txt"]),
)

实参

属性
name

名称；必需

此目标的唯一名称。
deps

标签列表；默认值为 []

要聚合到此目标中的“库”目标列表。 如需了解有关 deps 的一般注释，请参阅大多数构建规则定义的 典型属性。

此属性应用于列出其他 sh_library 规则，这些规则提供 srcs 中的代码所依赖的解释型程序源代码。这些规则提供的文件将存在于此目标的 runfiles 中。
srcs

标签列表；默认值为 []

输入文件列表。

此属性应用于列出属于 此库的 Shell 脚本源文件。脚本可以使用 Shell 的 source 或 . 命令。