模板变量信息

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

封装模板变量,即可由 BUILD 文件中的 $(VARIABLE) 等字符串引用、可通过 ctx.expand_make_variables 扩展且在内置规则的某些属性中隐式引用的变量。

可以通过以下方法创建 TemplateVariableInfo:调用其同名构造函数,并将字符串到字符串字典作为指定所提供变量的参数。

示例:platform_common.TemplateVariableInfo({'FOO': 'bar'})

成员

to_json

string TemplateVariableInfo.to_json()

已弃用。此 API 已弃用,很快就会被移除。请勿依赖此功能。在 ---incompatible_struct_has_no_methods 中,此功能处于停用状态。使用此标志可验证您的代码是否与即将移除的 API 兼容。
从结构体参数创建 JSON 字符串。只有当所有结构体元素(递归)均为字符串、整数、布尔值、其他结构体、这些类型的列表或包含这些类型的字符串键和值的字典时,此方法才有效。字符串中的引号和新行会进行转义。示例:
struct(key=123).to_json()
# {"key":123}

struct(key=True).to_json()
# {"key":true}

struct(key=[1, 2, 3]).to_json()
# {"key":[1,2,3]}

struct(key='text').to_json()
# {"key":"text"}

struct(key=struct(inner_key='text')).to_json()
# {"key":{"inner_key":"text"}}

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json()
# {"key":[{"inner_key":1},{"inner_key":2}]}

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json()
# {"key":{"inner_key":{"inner_inner_key":"text"}}}

已废弃:请改用 json.encode(x) 或 json.encode_indent(x),它们适用于结构体以外的值,并且不会污染结构体字段命名空间。

to_proto

string TemplateVariableInfo.to_proto()

已弃用。此 API 已废弃,很快就会被移除。请勿依赖此功能。此选项已通过 ---incompatible_struct_has_no_methods 停用。使用此标记验证您的代码与其即将移除的兼容性兼容。
使用结构体参数创建文本消息。仅当所有结构体元素(以递归方式)都是字符串、整数、布尔值、其他结构体、字典或这些类型的列表时,此方法才有效。字符串中的引号和换行符会被转义。结构体键会按排序顺序迭代。示例:
struct(key=123).to_proto()
# key: 123

struct(key=True).to_proto()
# key: true

struct(key=[1, 2, 3]).to_proto()
# key: 1
# key: 2
# key: 3

struct(key='text').to_proto()
# key: "text"

struct(key=struct(inner_key='text')).to_proto()
# key {
#   inner_key: "text"
# }

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto()
# key {
#   inner_key: 1
# }
# key {
#   inner_key: 2
# }

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto()
# key {
#    inner_key {
#     inner_inner_key: "text"
#   }
# }

struct(foo={4: 3, 2: 1}).to_proto()
# foo: {
#   key: 4
#   value: 3
# }
# foo: {
#   key: 2
#   value: 1
# }

已弃用:请改用 proto.encode_text(x)。

variables

dict TemplateVariableInfo.variables

将此目标定义的 make 变量作为字典返回,其中包含字符串键和字符串值