测试

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; default = None
声明属性的字典。请参阅规则调用。属性可以使用通过 analysis_test_transition 定义的配置转换。
fragments sequence of strings； default = []
可用于实现分析测试的配置 fragment 的列表。
toolchains sequence; default = []
测试所需的工具链集。请参阅规则调用。
attr_values dict of strings； 默认值 = {}
要传递给实现的属性值的字典。

ExecutionInfo

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

testing.ExecutionInfo 提供程序密钥/构造函数

TestEnvironment

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

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

参数

参数 说明
environment required
表示环境变量及其值的字符串键和值的映射。这些内容将在测试执行期间提供。
inherited_environment sequence of strings； default = []
环境变量的一系列名称。这些变量在测试执行期间可用，其当前值取自 shell 环境。如果 environment 和 inherited_environment 中均包含某个变量，则从 shell 环境继承的值的优先级更高。