Kola

ApiHug 测试框架 Kola

开始使用 Kola 进行契约优先、DSL 风格的测试。

它是什么

Kola 是 ApiHug 的 DSL 测试层,用来把测试场景和契约设计放在更接近的位置,而不是把测试拆散到一堆难以协作的手写脚本里。

适用场景

当你希望:

  • 用 BDD 风格描述 API 场景
  • 让测试跟着 proto 模块一起演进
  • 用 ApiHug 工具链生成并运行契约相关测试

就应该考虑使用 Kola。

前置条件

开始之前请确认:

  1. 项目已经升级到支持 Kola 的 ApiHug SDK 版本
  2. 使用当前可用的 IntelliJ 插件版本
  3. 项目构建配置中已经启用 Kola 相关任务

操作步骤

  1. gradle/libs.versions.toml 中升级 ApiHug 版本。
  2. 在 proto 模块的构建配置里启用 Kola。
  3. 在 proto 模块测试资源目录下创建 Kola 场景文件。
  4. 编写第一个 Kola DSL 场景。
  5. 执行测试任务:
Terminal
./gradlew.bat {proto_module}:kolaTest --stacktrace

示例

Groovy
package contracts

import hope.kola.contract.Feature

Feature.make {
    priority 100
    name("Customer login, place order, and check balance")
    Scenario "001 Try login", {
        Given {
            api("UserService", "Login")
        }
        When {
            body {
                set('name', "same")
                set('student.age', 22)
            }
        }
        And {
            booleanAssert("user.live", {
                isTrue()
            })
        }
    }
}

结果

你会得到一套更贴近契约、也更适合团队协作的测试入口,而不是一堆零散的接口测试脚本。

相关页面

  1. Kola 是什么
  2. Kola 工具链
Copyright © 2026 ApiHug·AI-native Enterprise Architecture Factory