這是用於建立設定轉換和建構設定描述符的頂層模組,可說明規則屬於哪種建構設定 (如有)。
例如:下列規則會將 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 如果已設定,則指令列可多次設定此標記,且每個個別值都會視為單一字串,加入至清單值。同時保留廣告訂單和重複的值。如果您希望採用不同的行為,可以透過建構設定實作函式對此清單進行後續處理。 |