用途
ProBat Testing 技能用于在 TLPP 项目中编写和运行测试。ProBat 是 tlppCore 的原生单元、功能与集成测试引擎,仅与 TLPP(.tlpp)源文件配合使用,即使被测代码是旧版 .prw 也同样适用。
当用户需要创建新的 ProBat 测试夹具、为某个例程添加测试方法、设置 setup/teardown 逻辑,或了解 ProBat 如何发现并执行测试时,可启用此技能。
主要能力
该技能覆盖以下内容:
- 必需的
#include "tlpp-probat.th"引入方式。 test.<module>命名空间约定。- 完整注解集:
@TestFixture、@Test、@Setup、@TearDown、@OneTimeSetUp、@OneTimeTearDown、@Skip、@ErrorLog。 tlpp.probat断言函数。- 基于类的执行生命周期。
- 用于条件跳过断言的
SKIPASSERT。
使用方式
测试的发现与执行可通过 REST API 或 VSCode 扩展完成。具体的测试编写模板与可适配的模式位于同级的 patterns 文件中(patterns-unit-tests.md)。
适用场景
- 创建新的 ProBat 测试夹具。
- 为某个例程添加测试方法以覆盖其行为。
- 设置 setup/teardown 逻辑。
- 理解 ProBat 如何发现并执行测试。
限制
该技能不涵盖以下内容:
- 生成被测的生产 TLPP 代码(参见 advpl-code-generation)。
- 测试之外的代码质量审查(参见 advpl-code-review)。
- 测试夹具中使用的嵌入式 SQL(参见 embedded-sql)。
参考文件
- reference.md:始终阅读,包含 includes、命名空间约定、注解、断言函数参考、执行生命周期以及测试如何运行。
- patterns-unit-tests.md:在编写具体 ProBat 测试夹具并需要可直接适配的模板/模式时阅读。