config

回報問題 查看來源 Nightly

這是用於建立設定轉換作業和建構設定描述元的頂層模組，用於說明規則的建構設定類型 (如有)。

例如：透過設定 rule() 函式的 build_setting 參數，將下列規則標示為建構設定。具體來說，這是 int 類型的建構設定，且為 flag，表示該建構設定可透過指令列呼叫。

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

成員

bool

BuildSetting config.bool(flag=False)

布林值類型的建構設定

參數

參數 說明
flag bool；預設值為 False
。指定是否可透過指令列呼叫這項建構設定。

exec

ExecTransitionFactory config.exec(exec_group=None)

建立執行轉換。

參數

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

int

BuildSetting config.int(flag=False)

整數類型的建構設定

參數

參數 說明
flag bool；預設值為 False
。指定是否可透過指令列呼叫這項建構設定。

字串

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

字串類型的建構設定

參數

參數 說明
flag bool；預設值為 False
。指定是否可透過指令列呼叫這項建構設定。
allow_multiple bool；預設值為 False
已淘汰，請改用含有 repeatable = True 的 string_list 設定。如果設定此旗標，則可在指令列中多次設定此標記。在轉換和建構設定實作函式中存取的旗標值，將是字串清單。同時保留廣告訂單和重複的值。如果需要其他行為，可以在建構設定實作函式中對這份清單進行後續處理。

string_list

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

字串清單類型的建構設定。在指令列中傳送使用半形逗號分隔值的清單，例如 --//my/setting=foo,bar。

參數

參數 說明
flag bool；預設值為 False
。指定是否可透過指令列呼叫這項建構設定。
repeatable bool；預設值為 False
。如果設定這個值，而非預期使用半形逗號分隔值，可以在指令列上多次設定這個標記，並將每個個別值視為一個字串並新增至清單值。同時保留廣告訂單和重複的值。如果需要其他行為，可以在建構設定實作函式中對這份清單進行後續處理。

目標

transition config.target()

建立目標轉場效果。這個免人工管理的轉換程序適用於需要轉換物件，但不想實際變更任何項目的情況。等同於 attr.label() 中的 cfg = "target"。