Truthish：Kotlin 多平台单元测试库指南

---

项目介绍

Truthish 是一个受 Google Truth 启发并完全使用 Kotlin 重写的多平台单元测试库。它旨在允许开发者在 Kotlin 的多平台项目中享受流畅的断言风格进行测试。该库通过提供易于阅读且产生清晰错误信息的断言方式，增强测试代码的可读性和调试效率。

项目快速启动

要开始使用 Truthish，在您的 Kotlin 多平台项目中添加以下依赖至 build.gradle.kts 文件：

repositories {
    mavenCentral()
}
kotlin {
    jvm()
    js(IR).browser()
    // 根据你的需求添加其他平台支持
}
sourceSets["commonMain"].dependencies {
    implementation("com.varabyte.truthish:truthish:1.0.1")
    implementation(kotlin("test"))
}

然后，在你的测试文件中，你可以像这样写断言：

import com.varabyte.truthish.*

@Test
fun testExample() {
    assertThat(2 + 2).isEqualTo(4)
    assertThat(listOf(1, 2, 3)).containsExactlyInAnyOrder(1, 2, 3)
}

确保配置对应的测试运行器以执行这些测试。

应用案例和最佳实践

流畅断言体验

Truthish 提供的断言方法使得测试逻辑更贴近自然语言，如下面的示例展示的是如何验证一个列表是否按预期排序：

@Test
fun testSortedList() {
    val numbers = listOf(1, 2, 3, 4, 5)
    assertThat(numbers).isSorted()
}

自定义错误消息

为了提高测试结果的可读性，推荐使用 assertWithMessage 来附加有意义的上下文信息：

@Test
fun testCustomErrorMessage() {
    val numbers = listOf(1, 3, 2)
    assertWithMessage("Numbers list should be sorted.")
        .that(numbers).isSorted()
}

典型生态项目集成

虽然 Truthish 主要作为测试辅助工具，并不直接与其他特定生态项目集成，但它可以在任何使用Kotlin的多平台项目中无缝工作，无论是配合Ktor构建服务端应用，还是在Android开发中作为单元测试框架的一部分。它的设计保证了与Kotlin的原生兼容性，因此容易融入到基于Kotlin的持续集成（CI）流程中，比如Jenkins或GitHub Actions中的Gradle构建任务。

记得在实施到具体项目时，利用其提供的丰富API来构建健壮的测试套件，并关注库的更新日志以获取新功能和改进。

---

以上就是关于Truthish的基本使用教程，通过这个强大而简洁的库，您可以大幅提升Kotlin多平台项目中单元测试的质量和维护性。