相约 2023 年 BazelCon 将于 10 月 24 日至 25 日在 Google 慕尼黑举办!了解详情

测试

报告问题 查看源代码

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

会员

分析测试

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; default = {}
传递给实现的属性值的字典。

ExecutionInfo

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

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

测试环境

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

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

参数

参数 说明
environment 必需
表示环境变量及其值的字符串键和值的映射。这些将在测试执行期间提供。
inherited_environment sequence of strings; default = []
环境变量名称序列。这些变量在测试执行期间是可用的,它们的当前值是从 shell 环境中获取的。如果 environmentinherited_environment 中均包含变量,则从 shell 环境继承的值(如果设置后)的优先级更高。