规则
sh_binary
sh_binary(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, exec_compatible_with, exec_properties, features, licenses, output_licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
sh_binary
规则用于声明可执行 shell 脚本。(sh_binary
不恰当:其输出不一定是二进制文件。)此规则可确保所有依赖项均已构建,并在执行时显示在 runfiles
区域中。我们建议您以脚本名称减去扩展名(例如 .sh
)的名称为 sh_binary()
规则命名;规则名称和文件名必须不同。sh_binary
尊重传统语言,因此可以使用任何口译工具(例如#!/bin/zsh
)
示例
对于没有依赖项和一些数据文件的简单 Shell 脚本,请使用以下代码:
sh_binary( name = "foo", srcs = ["foo.sh"], data = glob(["datafiles/*.txt"]), )
参数
属性 | |
---|---|
name |
此目标的唯一名称。 |
deps
|
deps 的一般注释。
此属性应该用于列出其他 |
srcs
|
此属性必须是单例列表,其元素是 Shell 脚本。该脚本必须是可执行文件,可以是源文件,也可以是生成的文件。运行时所需的所有其他文件(无论是脚本还是数据)都属于 |
sh_library
sh_library(name, deps, srcs, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
此规则的主要用途是将由相关脚本(采用不需要编译或链接的解释型语言的程序,如 Bourne shell)组成的逻辑“库”以及这些程序在运行时需要的任何数据汇总在一起。然后,可以通过一条或多条 sh_binary
规则的 data
属性使用此类“库”。
您可以使用 filegroup
规则来汇总数据文件。
在解释型编程语言中,“code”和“data”之间并不总是有明确的区分:毕竟,从解释器的角度来看,该程序只是“data”。因此,此规则具有三个基本相同的属性: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 的一般注释。
此属性应该用于列出其他 |
srcs
|
此属性应用于列出属于此库的 Shell 脚本源文件。脚本可以使用 shell 的 |
sh_test
sh_test(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, licenses, local, restricted_to, shard_count, size, tags, target_compatible_with, testonly, timeout, toolchains, visibility)
sh_test()
规则会创建一个以 Bourne shell 脚本编写的测试。
示例
sh_test( name = "foo_integration_test", size = "small", srcs = ["foo_integration_test.sh"], deps = [":foo_sh_lib"], data = glob(["testdata/*.txt"]), )
参数
属性 | |
---|---|
name |
此目标的唯一名称。 |
deps
|
deps 的一般注释。
此属性应该用于列出其他 |
srcs
|
此属性必须是单例列表,其元素是 Shell 脚本。该脚本必须是可执行文件,可以是源文件,也可以是生成的文件。运行时所需的所有其他文件(无论是脚本还是数据)都属于 |