tabletest
为Java开发者提供基于表格的数据驱动测试框架。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:tabletest。 它的用途是:为Java开发者提供基于表格的数据驱动测试框架。 完整的 Skill 内容见:https://321skill.com/skills/tabletest/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我为这个判断闰年的方法写一个 TableTest 测试,覆盖不能被4整除、能被4整除但不能被100整除、能被100整除但不能被400整除、能被400整除,以及边界情况0和负数年份。”,它会生成一个包含完整 `@TableTest` 注解和测试方法体的代码片段,表格清晰列出了各种场景、输入年份和预期结果。
介绍
TableTest 是一款针对 Java 开发者的 JUnit 5 扩展,旨在解决传统参数化测试代码冗长、可读性差的问题。它允许开发者使用清晰、结构化的表格格式来定义测试数据和预期结果,将多组测试用例直观地呈现在一个注解中,极大提升了测试代码的可读性和可维护性。
使用方式非常直接:在测试方法上添加 @TableTest 注解,并在其中以文本块的形式编写表格。表格的第一行是表头,后续每一行代表一组测试数据。框架会自动将每行数据转换为测试方法的参数并执行测试,支持单值、列表、集合、映射等多种数据格式的自动类型转换。
这个 Skill 非常适合需要进行大量数据驱动测试的 Java 开发者和测试工程师,尤其是在编写业务规则验证、边界条件测试或需要向非技术成员展示测试用例的场景下,其表格化的表现形式具有天然优势。
建议在 Java 8+ 和 JUnit 5.11+ 的环境中使用。对于 Java 15 及以上版本,推荐使用文本块语法以获得最佳的表格排版体验。同时,安装 IntelliJ IDEA 或 VS Code 的官方插件可以获得语法高亮、自动格式化等增强支持,进一步提升开发效率。
核心特点
与 JUnit 原生参数化测试相比,TableTest 的核心优势在于其极佳的可读性和简洁性:测试数据以直观的表格形式内嵌在注解中,无需编写复杂的参数源方法或外部文件解析逻辑,使测试用例本身成为自解释的文档。
注意事项
主要面向 Java/JVM 生态的单元测试,不适用于其他编程语言或端到端集成测试场景。
常见问题
TableTest 和 JUnit 的 @ParameterizedTest 有什么区别?
TableTest 是基于 @ParameterizedTest 的封装,核心区别是提供了更简洁、可读性更强的表格语法来定义测试数据,无需手动编写 ArgumentsProvider。
支持哪些数据格式?
支持单值、列表([])、集合({})、映射([key: value])及其嵌套结构,并能自动转换为方法参数类型。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/tabletest/raw/index.md 读取 tabletest 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/tabletest/raw/index.md(查看排版版本)