Kotest para Kotlin: guía completa con ejemplos

Introducción a Kotest: qué es y para qué sirve

Kotest (anteriormente conocido como KotlinTest) es una potente y flexible biblioteca para escribir pruebas en el lenguaje Kotlin. Proporciona a los desarrolladores un rico conjunto de herramientas para pruebas unitarias, de integración y funcionales. A diferencia de JUnit estándar, Kotest ofrece múltiples estilos de escritura de pruebas (desde el clásico "xUnit" hasta Behavior-Driven Development), soporte integrado para property-based testing, potentes matchers (assertions) e integración con frameworks populares como Spring Boot, MockK y Arrow.

¿Para qué sirve Kotest? En el desarrollo moderno con Kotlin, las pruebas no son solo una verificación del código, sino la base de la calidad. Kotest resuelve varias tareas clave:

\n
• Flexibilidad de estilos: Puedes escribir pruebas en estilo "String Spec", "Fun Spec", "Behavior Spec" y otros, eligiendo el más conveniente para tu equipo.
\n
• Potentes matchers: Las funciones de verificación integradas (shouldBe, shouldContain, shouldThrow) hacen que el código de las pruebas sea legible y conciso.
\n
• Property-based testing: Permite generar miles de datos de prueba aleatorios, verificando los invariantes de tu código, no solo valores específicos.
\n
• Integración con corrutinas: Kotest funciona excelentemente con las corrutinas de Kotlin, permitiendo probar código asíncrono sin boilerplate innecesario.
\n
• Extensibilidad: Puedes crear tus propios matchers, listeners y extensiones.
\n

Instalación de Kotest

Kotest se distribuye a través de Maven Central. Para instalarlo, debes agregar las dependencias en el archivo build.gradle.kts (para Gradle) o pom.xml (para Maven).

Instalación mediante Gradle (build.gradle.kts)

// En la sección dependencies\ndependencies {\n    // Módulo principal (incluye matchers básicos y estilos)\n    testImplementation("io.kotest:kotest-runner-junit5:5.9.1")\n    // Módulo para property-based testing\n    testImplementation("io.kotest:kotest-property:5.9.1")\n    // Módulo para trabajar con frameworks (ej. Spring)\n    testImplementation("io.kotest:kotest-extensions-spring:5.9.1")\n}

Instalación mediante Maven (pom.xml)

<dependency>\n    <groupId>io.kotest</groupId>\n    <artifactId>kotest-runner-junit5</artifactId>\n    <version>5.9.1</version>\n    <scope>test</scope>\n</dependency>\n<dependency>\n    <groupId>io.kotest</groupId>\n    <artifactId>kotest-property</artifactId>\n    <version>5.9.1</version>\n    <scope>test</scope>\n</dependency>

Nota: La versión 5.9.1 es la actual al momento de escribir este artículo. Siempre verifica la última versión en MVNRepository.

Inicio rápido con un ejemplo de código

Escribamos una prueba simple para una clase calculadora, usando el estilo "Fun Spec", uno de los más populares e intuitivos.

// Clase que vamos a probar\nclass Calculator {\n    fun add(a: Int, b: Int): Int = a + b\n    fun divide(a: Int, b: Int): Int {\n        if (b == 0) throw ArithmeticException("División por cero")\n        return a / b\n    }\n}\n\n// Clase de prueba\nimport io.kotest.core.spec.style.FunSpec\nimport io.kotest.matchers.shouldBe\nimport io.kotest.matchers.shouldThrow\n\nclass CalculatorTest : FunSpec({\n    // Inicialización del objeto a probar\n    val calculator = Calculator()\n\n    test("suma de dos números positivos") {\n        val result = calculator.add(2, 3)\n        result shouldBe 5\n    }\n\n    test("división por cero debe lanzar una excepción") {\n        shouldThrow<ArithmeticException> {\n            calculator.divide(10, 0)\n        }\n    }\n})

Este ejemplo