datagsm-server: Skill for Claude Code

Kotest + MockK Testing Guide

Given-When-Then Pattern

Use Kotest DescribeSpec with describe / context / it blocks.

class CreateApiKeyServiceTest : DescribeSpec({
    lateinit var repository: ApiKeyRepository
    lateinit var service: CreateApiKeyService

    beforeEach {
        repository = mockk()
        service = CreateApiKeyServiceImpl(repository)
    }

    describe("CreateApiKeyService 클래스의") {
        describe("execute 메서드는") {
            context("유효한 요청인 경우") {
                it("API 키를 생성하고 반환한다") {
                    // Given
                    val reqDto = CreateApiKeyReqDto(clientId = "test-client")
                    val apiKey = ApiKey(id = 1L, key = "generated-key")
                    every { repository.save(any()) } returns apiKey

                    // When
                    val result = service.execute(reqDto)

                    // Then
                    result shouldNotBe null
                    result.apiKey shouldBe "generated-key"
                    verify(exactly = 1) { repository.save(any()) }
                }
            }
        }
    }
})

MockK Patterns

Mock Creation

private val repository: ApiKeyRepository = mockk()
private val service = ApiKeyService(repository)

Stubbing

// Regular function
every { repository.findById(1L) } returns Optional.of(apiKey)

// Coroutine
coEvery { repository.save(any()) } returns apiKey

// Any matcher
every { repository.save(any()) } returns apiKey

Verification

// Verify call count
verify(exactly = 1) { repository.save(any()) }
verify(atLeast = 1) { repository.findAll() }

// Verify not called
verify(exactly = 0) { repository.delete(any()) }

// Coroutine
coVerify(exactly = 1) { repository.save(any()) }

Argument Capture

val slot = slot<ApiKey>()
every { repository.save(capture(slot)) } returns apiKey

service.execute(reqDto)

slot.captured.key shouldBe "expected-key"

Coroutine Testing