01. Introdução ao Kotest Framework

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

curl https://start.spring.io/starter.tgz \
  -d type=gradle-project-kotlin \
  -d language=kotlin \
  -d javaVersion=21 \
  -d groupId=com.testwithspring.master \
  -d artifactId=kotest-spring-demo \
  -d name=kotest-spring-demo \
  -d description="Projeto de introdução ao Kotest 6 e BDD com Spring" \
  -d packageName=com.testwithspring.master \
  -d dependencies=web \
  -d baseDir=kotest-spring-demo | tar -xzvf -

cd kotest-spring-demo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

val kotestVersion = "6.2.6"
val kotestSpringExtensionVersion = "1.3.0"
val mockkVersion = "1.14.0"

dependencies {
    // Dependências da aplicação Spring Boot
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("org.jetbrains.kotlin:kotlin-reflect")

    // Starter de testes do Spring Boot
    testImplementation("org.springframework.boot:spring-boot-starter-test")

    // Kotest 6: Runner JUnit 5 e Asserções Core
    testImplementation("io.kotest:kotest-runner-junit5:$kotestVersion")
    testImplementation("io.kotest:kotest-assertions-core:$kotestVersion")

    // Extensão Spring para Kotest
    testImplementation("io.kotest.extensions:kotest-extensions-spring:$kotestSpringExtensionVersion")

    // MockK: Mocks idiomáticos para Kotlin
    testImplementation("io.mockk:mockk:$mockkVersion")
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

tasks.withType<Test> {
    // 1. Obrigatório: Instrui o Gradle a utilizar o JUnit Platform para descobrir a engine do Kotest
    useJUnitPlatform()

    // 2. Formatação detalhada de logs no terminal
    testLogging {
        events("passed", "skipped", "failed")
        showExceptions = true
        showCauses = true
        showStackTraces = true
        exceptionFormat = org.gradle.api.tasks.testing.logging.TestExceptionFormat.FULL
    }

    // 3. Parâmetros recomendados para o Kotest Runner
    systemProperty("kotest.framework.dump.config", "false")
    systemProperty("kotest.framework.parallelism", "1") // Defina > 1 para execução concorrente
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

package com.testwithspring.master

import org.springframework.stereotype.Service

@Service
class GreetingService {

    fun buildGreeting(name: String?): String {
        val trimmed = name?.trim().orEmpty()
        return if (trimmed.isBlank()) {
            "Olá, Visitante!"
        } else {
            "Olá, $trimmed!"
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

package com.testwithspring.master

import io.kotest.core.spec.style.DescribeSpec
import io.kotest.matchers.shouldBe
import io.kotest.matchers.string.shouldEndWith
import io.kotest.matchers.string.shouldStartWith

class GreetingServiceSpec : DescribeSpec({

    val greetingService = GreetingService()

    describe("GreetingService - geração de saudações") {

        describe("quando um nome válido é fornecido") {
            it("deve retornar saudação personalizada com o nome") {
                val resultado = greetingService.buildGreeting("Maria")
                resultado shouldBe "Olá, Maria!"
            }

            it("deve remover espaços em branco no início e no final do nome") {
                val resultado = greetingService.buildGreeting("   Carlos   ")
                resultado shouldBe "Olá, Carlos!"
            }

            it("deve iniciar a mensagem com o prefixo 'Olá,'") {
                val resultado = greetingService.buildGreeting("João")
                resultado shouldStartWith "Olá,"
                resultado shouldEndWith "João!"
            }
        }

        describe("quando o nome não é fornecido ou contém apenas espaços") {
            it("deve retornar mensagem para visitante quando o argumento for null") {
                val resultado = greetingService.buildGreeting(null)
                resultado shouldBe "Olá, Visitante!"
            }

            it("deve retornar mensagem para visitante quando a string for vazia") {
                val resultado = greetingService.buildGreeting("")
                resultado shouldBe "Olá, Visitante!"
            }

            it("deve retornar mensagem para visitante quando a string contiver apenas espaços") {
                val resultado = greetingService.buildGreeting("    ")
                resultado shouldBe "Olá, Visitante!"
            }
        }
    }
})

1

./gradlew test

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

> Task :test

GreetingServiceSpec > GreetingService - geração de saudações > quando um nome válido é fornecido > deve retornar saudação personalizada com o nome PASSED
GreetingServiceSpec > GreetingService - geração de saudações > quando um nome válido é fornecido > deve remover espaços em branco no início e no final do nome PASSED
GreetingServiceSpec > GreetingService - geração de saudações > quando um nome válido é fornecido > deve iniciar a mensagem com o prefixo 'Olá,' PASSED
GreetingServiceSpec > GreetingService - geração de saudações > quando o nome não é fornecido ou contém apenas espaços > deve retornar mensagem para visitante quando o argumento for null PASSED
GreetingServiceSpec > GreetingService - geração de saudações > quando o nome não é fornecido ou contém apenas espaços > deve retornar mensagem para visitante quando a string for vazia PASSED
GreetingServiceSpec > GreetingService - geração de saudações > quando o nome não é fornecido ou contém apenas espaços > deve retornar mensagem para visitante quando a string contiver apenas espaços PASSED

BUILD SUCCESSFUL in 1s

1

./gradlew test --tests "com.testwithspring.master.GreetingServiceSpec"