轉換

回報問題 查看來源

代表依附元件邊緣的設定轉換。舉例來說，如果 //package:foo 依附於設定轉換的 //package:bar，則這兩個目標的設定將有所不同：根據轉換物件所定義的函式，//package:bar 的轉換作業將由 //package:foo 決定。

成員

轉換

transition transition(implementation, inputs, outputs)

一種轉場效果，會讀取一組輸入建構設定，並寫入一組輸出建構設定。

範例：

def _transition_impl(settings, attr):
    # This transition just reads the current CPU value as a demonstration.
    # A real transition could incorporate this into its followup logic.
    current_cpu = settings["//command_line_option:cpu"]
    return {"//command_line_option:compilation_mode": "dbg"}

build_in_debug_mode = transition(
    implementation = _transition_impl,
    inputs = ["//command_line_option:cpu"],
    outputs = ["//command_line_option:compilation_mode"],
)

如需更多詳情，請按這裡。

參數

參數 說明
implementation 必要
實作這項轉換作業的函式。這個函式一律具有兩個參數：settings 和 attr。settings 參數是一個字典，其中的索引鍵由輸入參數定義。因此，針對每個建構設定 --//foo=bar，如果 inputs 包含 //foo，settings 就會有 settings['//foo']='bar' 項目。

attr 參數是 ctx.attr 的參照。這麼做可讓實作函式存取規則屬性，以便執行屬性參數化轉換作業。

這個函式必須從建構設定 ID 傳回 dict，才能建構設定值；這代表設定轉換：針對傳回的 dict 中的每個項目，轉換會更新設定到新的值。所有其他設定則維持不變。若是分割轉換，這個函式也可以傳回 dict 的 list 或 dict 的 dict。
inputs sequence 字串；必要
這項轉換作業可讀取的建構設定清單。這會成為實作函式參數設定參數的索引鍵組合。
outputs sequence 字串；必要
可由這項轉換作業寫入的建構設定清單。這個屬性必須是這項轉換作業傳回的字典索引鍵集超集。