config

报告问题 查看源代码

这是一个顶级模块,用于创建配置转换和构建设置描述符,用于描述规则的类型(如果有)。

例如:通过设置 rule() 函数的 build_setting 形参,以下规则被标记为 build 设置。具体而言,它是一个 int 类型的 build 设置,并且是一个 flag,这意味着此构建设置可在命令行中调用。

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

成员

bool

BuildSetting config.bool(flag=False)

布尔值类型的 build 设置

参数

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

exec

ExecTransitionFactory config.exec(exec_group=None)

创建执行过渡。

参数

参数 说明
exec_group string;或 None;默认值为 None
此转换将使用的执行平台所属的执行组的名称。如果未提供,此执行转换将使用目标的默认执行平台。

int

BuildSetting config.int(flag=False)

整数类型的 build 设置

参数

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

string

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

字符串类型的 build 设置

参数

参数 说明
flag 默认值为 False
此构建设置是否可在命令行中调用。
allow_multiple 默认值为 False
已弃用,请改用 string_list 设置,并指定 repeatable = True。如果已设置此标志,则可以在命令行中多次设置此标志。在过渡和构建设置实现函数中访问的标志值将是一个字符串列表。系统会保留广告订单值和重复值。如果需要不同的行为,可以在 build 设置实现函数中对此列表进行后处理。

string_list

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

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

参数

参数 说明
flag 默认值为 False
此构建设置是否可在命令行中调用。
repeatable 默认值为 False
如果已设置,则可以在命令行中多次设置此标志,而不要求使用逗号分隔值,并将每个单独的值视为要添加到列表值的单个字符串。系统会保留广告订单值和重复值。如果需要不同的行为,可以在 build 设置实现函数中对此列表进行后处理。