在 ctx.actions.expand_template() 中使用的類似 Args 結構,可在執行階段之前將值評估時間延後。
成員
add
TemplateDict TemplateDict.add(key, value)
參數
參數 | 說明 |
---|---|
key
|
required A String key |
value
|
required A String 值 |
add_joined
TemplateDict TemplateDict.add_joined(key, values, *, join_with, map_each, uniquify=False, format_joined=None, allow_closure=False)
參數
參數 | 說明 |
---|---|
key
|
required A String key |
values
|
depset;
必填 depset 的項目將會加入。 |
join_with
|
必填 用於將套用 map_each 後取得的字串連結在一起的分隔符字串,與 string.join() 的用法相同。
|
map_each
|
callable;
required Starlark 函式,可接受單一引數,並傳回字串、 None 或字串清單。此函式會套用至 values 參數中指定的 Depset 項目
|
uniquify
|
預設為 False 如果為 true,系統會略過從 values 衍生的重複字串。系統只會保留每個字串的第一個出現值。通常不需要這項功能,因為 depset 已略過重複項目,但如果 map_each 為多個項目傳出相同的字串,這項功能就很實用。 |
format_joined
|
string; 或 None ;預設值為 None 這是套用至已彙整字串的選用格式字串模式。格式字串只能有一個「%s」預留位置。 |
allow_closure
|
預設為 False 如果為 true,則可在 map_each 等函式參數中使用閉包。這通常並非必要,而且可能會導致在執行階段保留大量分析階段資料結構。 |