在規則分析期間建立的動作。
這個物件可供測試,可從 Actions
供應器取得。一般來說,您不需要在規則的實作函式中存取 Action
物件或其欄位。您可以參閱規則頁面,進一步瞭解如何在定義自訂規則時使用動作,或是參閱API 參考資料,瞭解如何建立動作。
這個物件的部分欄位僅適用於特定類型的動作。不適用的欄位會設為 None
。
成員
args
sequence Action.args這是凍結的 Args 物件清單,內含動作引數的相關資訊。這些物件包含正確的引數資訊,包括涉及展開動作輸出目錄的引數。不過,在分析階段無法讀取 Args 物件。如要取得分析階段可用的引數,但不需太精確,請參閱 argv。
請注意,某些類型的動作尚不支援公開這個欄位。對於這類動作類型,則為 None
。可能會傳回 None
。
argv
sequence Action.argv針對由 ctx.actions.run() 或 ctx.actions.run_shell() 建立的動作,這是指令列要執行的引數不變清單。請注意,對於殼層動作,前兩個引數會是殼層路徑和
"-c"
。可能會傳回 None
。
內容
string Action.content如果是透過 ctx.actions.write() 或 ctx.actions.expand_template() 建立的動作,則為要寫入的檔案內容 (如果這些內容可以在分析階段計算)。如果內容必須在執行階段才能確定,例如需要展開 Args 物件中的目錄時,值就會是
None
。
可能會傳回 None
。env
dict Action.env此動作的「固定」環境變數。這包括僅由動作定義明確設定的環境設定,因此會省略只在執行環境中預先設置的設定。
輸入
depset Action.inputs此動作的一組輸入檔案。
助憶鍵
string Action.mnemonic此動作的助憶法。
輸出
depset Action.outputs這個動作的一組輸出檔案。
substitutions
dict Action.substitutions針對 ctx.actions.expand_template() 建立的動作,此為不可變動的字典,其中保留替代對應。 可能會傳回
None
。