測試

Starlark 的輔助方法，可存取測試基礎架構。

成員

• analysis_test
• ExecutionInfo
• TestEnvironment

analysis_test

None testing.analysis_test(name, implementation, attrs={}, fragments=[], toolchains=[], attr_values={})

建立新的分析測試目標。

測試的遞移依附元件數量有限。這項限制是由 --analysis_testing_deps_limit 標記控管。

參數

參數	說明
name	string；必要 目標名稱。這應該是 Starlark ID，符合「[A-Za-z_][A-Za-z0-9_]*」模式。
implementation	function； 必要 實作這項分析測試的 Starlark 函式。這個函式必須只有一個參數：ctx。系統會在分析階段呼叫函式。它可以存取 attrs 宣告的屬性，並透過 attr_values 填入。實作函式可能不會註冊動作。而是必須透過提供 AnalysisTestResultInfo 註冊通過/失敗結果。
attrs	dict；預設為 {} 宣告屬性的字典。請參閱規則呼叫。屬性可使用以 analysis_test_transition 定義的設定轉換。
fragments	字串序列；預設值為 [] 。可供分析測試實作使用的設定片段清單。
toolchains	sequence； 預設為 [] 測試所需的工具鍊集。請參閱規則呼叫。
attr_values	dict of strings；預設值為 {} 要傳遞至實作的屬性值字典。

ExecutionInfo

ExecutionInfo testing.ExecutionInfo

testing.ExecutionInfo provider key/constructor

TestEnvironment

RunEnvironmentInfo testing.TestEnvironment(environment, inherited_environment=[])

已淘汰：請改用 RunEnvironmentInfo。建立新的測試環境供應商。使用這個供應器指定額外的環境變數，在測試執行期間提供。

參數

參數	說明
environment	dict；必要 字串鍵和值的對應，代表環境變數及其值。這些項目會在測試執行期間提供。
inherited_environment	sequence of strings；預設為 [] 環境變數名稱的序列。這些變數會在測試執行期間提供，並從殼層環境中擷取目前值。如果變數同時包含在 environment 和 inherited_environment 中，系統會優先採用從殼層環境繼承的值 (如果已設定)。