動作

回報問題 查看來源

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

此物件僅供測試使用,並可由 Actions 提供者取得。通常不需要在規則實作函式中存取 Action 物件或其欄位,如果想瞭解定義自訂規則時如何使用動作,請參閱 規則頁面;若要定義動作,請參閱 API 參考資料

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

成員

args

sequence Action.args

凍結的 Args 物件清單,其中包含動作引數的相關資訊。這些物件含有正確的引數資訊,包括與展開動作輸出目錄相關的引數。不過,分析階段無法讀取 Args 物件。關於在分析階段取得的引數準確度較低,請參閱 argv

請注意,部分動作類型目前尚未支援顯示這個欄位。針對這類動作類型,此為 None。 可能傳回 None

引數

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