動作

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

此物件僅供測試之用,也可能是透過動作提供者取得。在規則實作函式中,您通常不需要存取 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