测试

用于访问测试基础架构的 Starlark 辅助方法。

成员

• analysis_test
• ExecutionInfo
• TestEnvironment

analysis_test

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

创建新的分析测试目标。

测试的传递依赖项数量有限。此限制由 --analysis_testing_deps_limit 标志控制。

参数

参数	说明
name	字符串； 必需 目标的名称。它应该是 Starlark 标识符，与模式 '[A-Za-z_][A-Za-z0-9_]*' 匹配。
implementation	函数； 必需 实现此分析测试的 Starlark 函数。它必须有且只有一个参数：ctx。该函数在分析阶段调用。它可以访问由 attrs 声明并通过 attr_values 填充的属性。实现函数可能不会注册操作。相反，它必须通过提供 AnalysisTestResultInfo 来注册通过/失败结果。
attrs	dict； 默认值为 {} 用于声明属性的字典。请参阅规则调用。允许属性使用通过 analysis_test_transition 定义的配置转换。
fragments	字符串的序列；默认值为 [] 可供分析测试实现使用的配置 fragment 列表。
toolchains	序列； 默认值为 [] 测试所需的工具链集。请参阅规则调用。
attr_values	包含 string 的 dict；默认值为 {} 要传递给实现的属性值字典。

ExecutionInfo

ExecutionInfo testing.ExecutionInfo

testing.ExecutionInfo 提供方键/构造函数

TestEnvironment

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

已弃用：请改用 RunEnvironmentInfo。创建新的测试环境提供程序。使用此提供程序指定在测试执行期间可用的额外环境变量。

参数

参数	说明
environment	dict； 必需 一个字符串键值对映射，表示环境变量及其值。这些变量将在测试执行期间提供。
inherited_environment	字符串的序列；默认值为 [] 环境变量名称的序列。这些变量在测试执行期间可用，其当前值取自 shell 环境。如果某个变量同时包含在 environment 和 inherited_environment 中，则从 shell 环境继承的值（如果已设置）将优先。