config

回報問題 查看原始碼 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

這是用於建立設定轉換和建構設定描述符的頂層模組,可說明規則屬於哪種建構設定 (如有)。

例如:設定 rule() 函式的 build_setting 參數,即可將下列規則標示為建構設定。具體來說,這是 int 類型的建構設定,也是 flag,表示這個建構設定可在指令列上呼叫。

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

成員

bool

BuildSetting config.bool(flag=False)

布林型建構設定

參數

參數 說明
flag 預設值為 False
是否可以在指令列上呼叫這項建構設定。

exec

ExecTransitionFactory config.exec(exec_group=None)

建立執行轉換。

參數

參數 說明
exec_group string; 或 None;預設值為 None
執行這項轉換作業的執行平台 exec 群組名稱。如果未提供,這個執行轉換作業會使用目標的預設執行平台。

int

BuildSetting config.int(flag=False)

整數型建構設定

參數

參數 說明
flag 預設值為 False
是否可以在指令列上呼叫這項建構設定。

字串

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

字串類型的建構設定

參數

參數 說明
flag 預設值是 False
是否可透過指令列呼叫這項建構設定。
allow_multiple 預設為 False
已淘汰,請改用 string_list 設定搭配 repeatable = True。如果設定此旗標,則可在指令列中多次設定此標記。在轉換和建構設定實作函式中存取的旗標值,將是字串清單。廣告訂單和重複值都會保留。如果您希望採用不同的行為,可以透過建構設定實作函式對此清單進行後續處理。

string_list

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

字串清單型態的建構設定。在指令列上傳遞清單,並使用 --//my/setting=foo,bar 等逗號分隔的值。

參數

參數 說明
flag 預設值為 False
是否可以在指令列上呼叫這項建構設定。
repeatable 預設為 False
如果已設定,則指令列可多次設定此標記,且每個個別值都會視為單一字串,加入至清單值。同時保留廣告訂單和重複的值。如果您希望採用不同的行為,可以透過建構設定實作函式對此清單進行後續處理。