測試

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

成員

analysis_test

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

實驗功能。此 API 仍在實驗階段,隨時可能變更。請勿仰賴這項功能。你可以透過設定「--+experimental_analysis_test_call
建立新的分析測試目標,然後採用實驗模式。

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

參數

參數 說明
name 必要
目標名稱。它應該是 Starlark 識別碼,符合模式「[A-Za-z_][A-Za-z0-9_]*」。
implementation 必要
實作這項分析測試的 Starlark 函式。此變數僅能包含一個參數:ctx。系統會在分析階段呼叫函式。它可以存取 attrs 宣告的屬性,並透過 attr_values 填入。實作函式可能無法登錄動作。而是必須透過提供 AnalysisTestResultInfo 註冊通過/失敗結果。
attrs dict; or None; 預設值 = 無
用來宣告屬性的字典。請參閱 rule 呼叫。屬性可使用 analysis_test_transition 定義的設定轉換。
fragments sequence of strings; 預設 = []
可供實作分析測試的設定片段清單。
toolchains sequence; 預設 = []
測試所需的工具鍊組合。請參閱 rule 呼叫。
attr_values dict of strings; default = {}
要傳遞至實作的屬性值字典。

ExecutionInfo

ExecutionInfo testing.ExecutionInfo(requirements={}, exec_group='test')

testing.ExecutionInfo 提供者金鑰/建構函式

TestEnvironment

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

已淘汰:請改用 RunEnvironmentInfo。建立新的測試環境提供者。使用這個提供者指定測試執行期間可用的額外環境變數。

參數

參數 說明
environment 必要
字串鍵/值對應,代表環境變數及其值。測試執行期間將會提供這些資產。
inherited_environment sequence of strings; 預設 = []
環境變數的名稱序列。您可以在測試執行期間使用這些變數,其目前值取自殼層環境中。如果 environmentinherited_environment 中都含有變數,系統會優先採用從殼層環境沿用的值。