範本變數資訊

回報問題 查看原始碼 Nightly · 8.0 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停用。使用這個標記,確認您的程式碼與即將移除的標記相容。
使用結構體參數建立 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 變數,做為字串鍵和字串值的字典