# Testing

> 새로운 테스트 코드를 작성할 때 사용. Kotest DescribeSpec 스타일과 100% 커버리지 요구사항을 따름. Use when this capability is needed.

- Skill: `tomevault-io/testing-8` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/testing-8`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/testing-8/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/testing-8

---


# 테스트 가이드라인

모든 테스트는 **Kotest DescribeSpec** 스타일로 작성합니다.

## 기본 구조

`describe`로 그룹화하고 `it`으로 개별 테스트 케이스를 작성합니다.

```kotlin
@Import(TestcontainersConfiguration::class)
@SpringBootTest
class ExampleTests : DescribeSpec() {
    init {
        extension(SpringExtension())

        describe("FeatureName") {
            it("should do something") {
                // 테스트 코드
            }

            context("when some condition") {
                it("should behave differently") {
                    // 테스트 코드
                }
            }
        }
    }
}
```

## 핵심 포인트

- `DescribeSpec`을 기본 클래스로 사용
- Spring 통합 테스트에는 `SpringExtension()` 등록
- `describe`로 기능/클래스별 관련 테스트 그룹화
- `context`로 조건별 시나리오 구분
- `it`으로 개별 테스트 케이스 작성
- Kotest assertion 사용 (`shouldBe`, `shouldThrow` 등)

## 테스트 명령어

```bash
# 전체 테스트 실행
./gradlew test

# 단일 테스트 클래스 실행
./gradlew test --tests "com.mkroo.termbase.TermbaseApplicationTests"

# 단일 테스트 메서드 실행
./gradlew test --tests "com.mkroo.termbase.TermbaseApplicationTests.contextLoads"

# 테스트 커버리지 확인
./gradlew jacocoTestReport

# 커버리지 최소 임계값(100%) 검증
./gradlew jacocoTestCoverageVerification
```

## 커버리지 요구사항

- 새 코드의 모든 브랜치, 엣지 케이스, 에러 시나리오를 커버하는 테스트 작성
- 100% 커버리지 달성 필수
- `./gradlew jacocoTestCoverageVerification` 통과 필수

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/mkroo) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->