動作

在規則分析期間建立的動作。

這個物件會顯示以供測試，並可從動作供應商取得。一般來說，您不需要在規則的實作函式中存取 Action 物件或其欄位。如要瞭解如何定義自訂規則時使用動作，請參閱規則頁面，如要建立動作，請參閱 API 參考資料。

這個物件的部分欄位僅適用於特定類型的動作。不適用的欄位會設為 None。

成員

args

sequence Action.args

凍結 Args 物件的清單，內含動作引數的相關資訊。這些物件包含正確的引數資訊，包括涉及擴展動作輸出目錄的引數。不過，Args 物件在分析階段無法讀取。如要瞭解分析階段提供的引數，請參閱 argv。

請注意，部分類型的動作目前不支援顯示這個欄位。如果是這類動作類型，則為 None。 可能會傳回 None。

argv

sequence Action.argv

如果是透過 ctx.actions.run() 或 ctx.actions.run_shell() 建立的動作，則為要執行的指令列引數不可變更的清單。請注意，如果是 Shell 動作，前兩個引數會是 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。