config

这是一个用于创建配置转换和 build 设置描述符的顶级模块，用于描述规则属于哪种 build 设置（如果有）。

例如，以下规则通过设置 rule() 函数的 build_setting 参数标记为 build 设置。具体而言，它是一种 int 类型的 build 设置，属于 flag，这意味着此 build 设置可在命令行中调用。

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

成员

• bool
• exec
• int
• 字符串
• string_list

bool

BuildSetting config.bool(flag=False)

一种布尔类型的 build 设置

参数

参数	说明
flag	默认值为 False 此 build 设置是否可在命令行中调用。

exec

ExecTransitionFactory config.exec(exec_group=None)

创建执行过渡。

参数

参数	说明
exec_group	string; or None; default is None 执行组的名称，相应过渡将使用该执行组的执行平台。如果未提供，此执行转换将使用目标的默认执行平台。

int

BuildSetting config.int(flag=False)

整数类型的 build 设置

参数

参数	说明
flag	默认值为 False 此 build 设置是否可在命令行中调用。

字符串

BuildSetting config.string(flag=False, allow_multiple=False)

字符串类型的 build 设置

参数

参数	说明
flag	默认值为 False 此 build 设置是否可在命令行中调用。
allow_multiple	默认值为 False 已弃用，请改用 repeatable = True 的 string_list 设置。如果设置了此标志，则允许在命令行中多次设置此标志。在过渡和 build 设置实现函数中访问的标志值将是字符串列表。插入顺序和重复值都会保留。如果需要不同的行为，可以在 build 设置实现函数中对该列表进行后处理。

string_list

BuildSetting config.string_list(flag=False, repeatable=False)

字符串列表类型的 build 设置。在命令行中，使用以英文逗号分隔的值传递列表，例如 --//my/setting=foo,bar。

参数

参数	说明
flag	默认值为 False 此 build 设置是否可在命令行中调用。
repeatable	默认值为 False 如果设置，则允许在命令行中多次设置此标志，每个单独的值都将视为要添加到列表值中的单个字符串，而不是期望使用英文逗号分隔的值。插入顺序和重复值都会保留。如果需要不同的行为，可以在 build 设置实现函数中对该列表进行后处理。