规则属性

报告问题 查看源代码 每夜 build · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

有关应用于某个方面规则的属性的信息。

成员

• attr
• exec_groupsexec_groups
• 可执行文件
• file
• 文件
• 种类
• 工具链

属性

struct rule_attributes.attr

用于访问属性值的结构体。这些值由用户提供（如果未提供，则使用默认值）。结构体的属性及其值的类型对应于提供给 rule 函数的 attrs 字典的键和值。查看使用示例。

exec_groups

ExecGroupCollection rule_attributes.exec_groups

适用于应用该方面到规则的规则的执行组的集合，按名称编入索引。

可执行文件

struct rule_attributes.executable

包含标签类型属性中定义的标记为 executable=True 的可执行文件的 struct。结构体字段与属性名称相对应。结构体中的每个值都是 File 或 None。如果规则中未指定可选属性，则相应的结构体值为 None。如果标签类型未标记为 executable=True，则系统不会生成相应的结构体字段。查看使用示例。

文件

struct rule_attributes.file

包含标签类型属性中定义的文件（标记为 allow_single_file）的 struct。结构体字段与属性名称相对应。结构体值始终为 File 或 None。如果规则中未指定可选属性，则相应的结构体值为 None。如果标签类型未标记为 allow_single_file，则不会生成相应的结构体字段。它是以下操作的快捷方式：

list(ctx.attr.<ATTR>.files)[0]

换句话说，应使用 file 访问依赖项的（单数）默认输出。查看使用示例。

文件

struct rule_attributes.files

包含标签或标签列表类型属性中定义的文件的 struct。结构体字段与属性名称相对应。结构体值为 File 的 list。此快捷键适用于：

[f for t in ctx.attr.<ATTR> for f in t.files]

换句话说，使用 files 可访问依赖项的 默认输出。查看使用示例。

kind

string rule_attributes.kind

规则的类型，例如“cc_library”

工具链

ToolchainContext rule_attributes.toolchains

要应用该方面到哪个规则的默认执行组的工具链。