本国的/原生的/土著

支持原生规则和其他软件包辅助函数的内置模块。所有原生规则在此模块中都显示为函数,例如native.cc_library。请注意,原生模块仅在加载阶段可用(也就是说,对于宏,不适用于规则实施)。属性会忽略 None 值,并将其视为未设置的属性。
您还可以使用以下函数:

成员

existing_rule

unknown native.existing_rule(name)

返回一个类似于字典的不可变对象,该对象描述在此线程的软件包中实例化的规则的属性;如果不存在具有该名称的规则实例,则返回 None

在这里,“类字典的不可变对象”是指支持类似字典的迭代 xlen(x)name in xx[name]x.get(name)x.items()x.keys()x.values() 的深度不可变对象。

如果设置了 --noincompatible_existing_rules_immutable_view 标志,则改为返回具有相同内容的新可变字典。

结果包含每个属性的条目,但私有属性(其名称不以字母开头)和一些无法表示的旧版属性类型除外。此外,字典还包含规则实例的 namekind 条目(例如 'cc_binary')。

结果的值表示属性值,如下所示:

  • str、int 和 bool 类型的属性按原样表示。
  • 对于同一软件包中的目标,标签转换为以下形式的字符串:':foo';对于其他软件包中的目标,转换为 '//pkg:name' 形式的字符串。
  • 列表以元组表示,而字典会转换为新的可变字典。它们的元素以相同的方式进行递归转换。
  • 系统会返回 select 值及其内容(如上所述)。
  • 未在规则实例化期间指定任何值,并且已计算默认值的属性会从结果中排除。(直到分析阶段才能计算计算出的默认值。)

请尽可能避免使用此函数。这会使 BUILD 文件变得脆弱并且依赖于顺序。另请注意,它与规则属性值的其他两个从内部形式转换为 Starlark 存在细微区别:一个由计算默认值使用,另一个由 ctx.attr.foo 使用。

参数

参数 说明
name 必需
目标的名称。

existing_rules

unknown native.existing_rules()

返回一个不可变的类似字典的对象,该对象描述到目前为止已在此线程的软件包中实例化的规则。类似字典的对象的每个条目都会将规则实例的名称映射到 existing_rule(name) 将返回的结果。

在这里,“类字典的不可变对象”是指支持类似字典的迭代 xlen(x)name in xx[name]x.get(name)x.items()x.keys()x.values() 的深度不可变对象。

如果设置了 --noincompatible_existing_rules_immutable_view 标志,则改为返回具有相同内容的新可变字典。

注意:请尽可能避免使用此函数。这会使 BUILD 文件变得脆弱并且依赖于顺序。此外,如果设置了 --noincompatible_existing_rules_immutable_view 标志,此函数的开销可能会很高,尤其是在循环中调用时。

exports_files

None native.exports_files(srcs, visibility=None, licenses=None)

指定属于此软件包并导出到其他软件包的文件的列表。

参数

参数 说明
srcs sequence of strings; 必需
要导出的文件的列表。
visibility sequence; or None; 默认 = 无
可以指定可见性声明。这些文件对指定目标可见。如果未指定可见性,则文件将对每个软件包可见。
licenses sequence of strings; or None; 默认 = 无
要指定的许可。

glob

sequence native.glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

Glob 会返回一个可变的新列表,其中包含当前软件包中符合以下条件的每个文件:
  • 匹配 include 中的至少一个模式。
  • exclude 中的任何模式都不匹配(默认值为 [])。
。 如果 exclude_directories 参数已启用(设为 1),则结果中将忽略类型为“目录”的文件类型(默认为 1)。

参数

参数 说明
include sequence of strings; 默认值 = []
要包含的 glob 模式的列表。
exclude sequence of strings; 默认值 = []
要排除的 glob 模式的列表。
exclude_directories 默认值 = 1
是否排除目录的标志。
allow_empty 默认值 = 未绑定
我们是否允许 glob 模式不进行任何匹配。如果 `allow_empty` 为 False,则每个 include 模式必须与某些内容匹配,并且最终结果必须非空(在排除 `exclude` 模式的匹配项之后)。

package_group

None native.package_group(name, packages=[], includes=[])

此函数定义一组软件包,并为这组软件包分配一个标签。可以在 visibility 属性中引用该标签。

参数

参数 说明
name 必需
此规则的唯一名称。
packages sequence of strings; 默认值 = []
此组中软件包的完整枚举。
includes sequence of strings; 默认值 = []
此软件包中包含的其他软件包组。

package_name

string native.package_name()

要评估的软件包的名称。例如,在 BUILD 文件 some/package/BUILD 中,其值为 some/package。如果 BUILD 文件调用 .bzl 文件中定义的函数,package_name() 将与调用方 BUILD 文件软件包匹配。此函数等效于已弃用的变量 PACKAGE_NAME

repository_name

string native.repository_name()

从中调用规则或 build 扩展程序的代码库的名称。例如,在由 WORKSPACE 节 local_repository(name='local', path=...) 调用的软件包中,它将被设置为 @local。在主代码库的软件包中,此属性将设置为 @。此函数等效于已弃用的变量 REPOSITORY_NAME

子软件包

sequence native.subpackages(include, exclude=[], allow_empty=False)

返回当前软件包的每个直接子软件包的新可变列表,而不考虑文件系统目录深度。返回的列表已排序,其中包含子软件包相对于当前软件包的名称。建议您优先使用 bazel_skylib.subpackages 模块中的方法,而不是直接调用此函数。

参数

参数 说明
include sequence of strings; 必需
要包含在子软件包扫描中的 glob 模式的列表。
exclude sequence of strings; 默认值 = []
要从子软件包扫描中排除的 glob 模式列表。
allow_empty 默认值 = False
调用是否失败(如果调用返回空列表)。默认情况下,空列表表示 BUILD 文件中对 subpackages() 的调用可能出错。在这种情况下,设置为 true 可让此函数成功。