JUnit 5에서 Kotlin과 통합하는 방법은?

Q1: JUnit 5를 Kotlin 프로젝트에 어떻게 추가하나요?
A1: Gradle 예시:
```kotlin
dependencies {
testImplementation("org.junit.jupiter:junit-jupiter:5.9.3")
}
```
그리고 테스트 태스크에서 JUnit 플랫폼 사용을 명시합니다:
```kotlin
tasks.test {
useJUnitPlatform()
}
```

Q2: Kotlin에서 JUnit 5 테스트 클래스를 어떻게 작성하나요?
A2: Kotlin 파일에서 `@Test` 어노테이션을 사용합니다. 예:
```kotlin
import org.junit.jupiter.api.Test
import kotlin.test.assertEquals

class MyTests {
@Test
fun testAddition() {
assertEquals(4, 2 + 2)
}
}
```

Q3: JUnit 5와 Kotlin을 사용할 때 테스트 함수에 특별한 규칙이 있나요?
A3: 테스트 함수는 `fun`으로 선언하고, 반환 타입은 생략하거나 `Unit`입니다. 반드시 `public`일 필요는 없습니다 (Kotlin 기본 가시성은 public). 함수명에 공백 대신 카멜케이스 또는 백틱(``` ` ```)을 활용할 수 있습니다. 예:
```kotlin
@Test
fun `2 더하기 2는 4이다`() {
assertEquals(4, 2 + 2)
}
```

Q4: JUnit 5의 어노테이션 중 Kotlin과 호환되는 것은?
A4: 모든 기본 JUnit 5 어노테이션 (`@Test`, `@BeforeEach`, `@AfterEach`, `@BeforeAll`, `@AfterAll`, `@DisplayName`, `@Nested`, `@ParameterizedTest` 등)은 Kotlin에서 동일하게 사용 가능합니다.

Q5: Kotlin에서 JUnit 5 테스트의 ‘BeforeAll’, ‘AfterAll’ 메서드는 어떻게 만드나요?
A5: Kotlin에서는 ‘BeforeAll’과 ‘AfterAll’ 메서드를 `companion object` 안에 `@JvmStatic`으로 선언해야 합니다:
```kotlin
companion object {
@JvmStatic
@BeforeAll fun setupAll() {
// 초기화 코드
}
}
```

Q6: 파라미터라이즈드 테스트는 Kotlin에서 어떻게 작성하나요?
A6: JUnit 5 `@ParameterizedTest`와 함께 Kotlin 컬렉션을 사용할 수 있습니다. 예:
```kotlin
@ParameterizedTest
@ValueSource(strings = ["a", "b", "c"])
fun testWithParams(input: String) {
assertTrue(input.isNotEmpty())
}
```

Q7: Kotlin의 확장 함수로 JUnit 5 테스트를 만들 수 있나요?
A7: 일반 테스트는 클래스 내에 함수로 만들지만, 확장 함수로 테스트하는 것은 권장되지 않습니다. 대신 표준 테스트 메서드를 작성하세요.

Q8: JUnit 5와 Kotlin에서 테스트가 실패할 때 디버그는 어떻게 하나요?
A8: IntelliJ, Eclipse 등에서 Kotlin 테스트를 디버깅할 때 일반 Java 테스트 디버깅과 동일합니다. 스탭(Board)별로 중단점을 세우고 디버거를 실행하면 됩니다.

Q9: AssertJ나 Kotest같은 Kotlin 친화적인 테스트 라이브러리와 함께 JUnit 5를 어떻게 사용하나요?
A9: JUnit 5를 테스트 플랫폼으로 사용하고, Kotest 또는 AssertJ를 어설션 라이브러리로 추가해 결합합니다.
```kotlin
dependencies {
testImplementation("org.junit.jupiter:junit-jupiter:5.9.3")
testImplementation("io.kotest:kotest-assertions-core:5.6.2")
}
```
테스트 코드 내에서 Kotest 어설션을 JUnit 5 테스트 함수 안에 사용 가능.

Q10: Kotlin의 코루틴을 JUnit 5 테스트에서 어떻게 사용할 수 있나요?
A10: `runBlocking`이나 JUnit 5 코루틴 지원 확장을 사용합니다. 기본적으로:
```kotlin
import kotlinx.coroutines.runBlocking

@Test
fun testCoroutine() = runBlocking {
val result = someSuspendFunction()
assertEquals(expected, result)
}
```

---

요약: JUnit 5는 Kotlin과 완벽히 호환되며, 주로 어노테이션 사용법, `companion object` 내 `@BeforeAll` 선언 방법, 코루틴 처리법, 그리고 빌드 설정에서 플랫폼 활성화가 핵심 포인트입니다.

JUnit 5를 Kotlin과 함께 사용하는 것은 비교적 간단하며, Kotlin의 코틀린 특성들을 살려 테스트 코드를 더 깔끔하고 직관적으로 작성할 수 있습니다.

JUnit 5는 모듈화되고 확장성이 좋은 테스트 프레임워크로, Kotlin과도 매우 잘 맞습니다.

아래에 JUnit 5를 Kotlin과 통합하는 방법에 대해 단계별로 자세히 설명하겠습니다.

1. Gradle(또는 Maven) 의존성 설정 먼저, 프로젝트에 JUnit 5 의존성을 추가해야 합니다.

Kotlin 프로젝트에서 Gradle을 사용하는 경우 `build.gradle.kts` (Kotlin DSL) 파일에 다음과 같이 설정할 수 있습니다.

```kotlin plugins { kotlin("jvm") version "1.8.20" // Kotlin 버전은 필요에 맞게 설정 } repositories { mavenCentral() } dependencies { testImplementation("org.junit.jupiter:junit-jupiter-api:5.9.2") testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.9.2") // Kotlin stdlib (필요시) implementation(kotlin("stdlib")) } ``` - `junit-jupiter-api`는 JUnit 5의 테스트 API를 의미합니다.

- `junit-jupiter-engine`은 실제 테스트를 실행하는 엔진입니다.

- `testImplementation`과 `testRuntimeOnly`로 구분하여 추가합니다.

Gradle 빌드가 끝나면 JUnit 5를 사용할 수 있습니다.

---

2. Kotlin으로 테스트 클래스 작성하기 JUnit 5에서는 기존 JUnit 4보다 훨씬 간결하고 간편한 애너테이션을 사용합니다.

기본 테스트 클래스 예제 ```kotlin import org.junit.jupiter.api.Assertions.assertEquals import org.junit.jupiter.api.Test class CalculatorTest { @Test fun `덧셈이 제대로 동작하는지 테스트`() { val calculator = Calculator() val result = calculator.add(3,

4) assertEquals(7, result) } } ``` - `@Test` 애너테이션을 메서드 위에 붙이면 해당 함수가 테스트 함수가 됩니다.

- Kotlin의 함수 이름을 백틱(``` ` ```)으로 감싸면 공백 포함 여러 표현이 가능해서 가독성이 뛰어납니다.

- JUnit의 `Assertions` 클래스 메서드들을 사용해 결과를 검증합니다.

---

3. Kotlin의 특징과 JUnit 5의 시너지 - 백틱 함수명 : 함수명을 백틱으로 감싸 공백, 한글, 특수문자 등이 들어간 함수명을 작성하여 테스트 케이스명을 자연어처럼 적을 수 있습니다.

```kotlin @Test fun `두 수를 더했을 때 결과가 올바른지 검사한다`() { ... } ``` - 널 안정성 : Kotlin의 널 안정성 덕분에 테스트 중에 불필요한 널 체크를 줄일 수 있습니다.

- 코틀린 DSL 스타일 : JUnit 5 자체는 코틀린 DSL 형태를 제공하지는 않지만, Kotlin의 람다와 확장 함수 등을 활용해 테스트 환경을 좀 더 자연스럽게 구성할 수도 있습니다.

---

4. JUnit 5 확장 및 어노테이션 활용하기 JUnit 5는 다양한 애너테이션과 기능을 제공합니다.

- `@BeforeEach` / `@AfterEach`: 각 테스트 함수 실행 전에/후에 실행되는 메서드 - `@BeforeAll` / `@AfterAll`: 클래스 내 모든 테스트 전후에 한 번 실행되는 메서드 (`companion object` 내부에서 `@JvmStatic`을 함께 사용해야 함) - `@DisplayName`: 테스트 함수나 클래스에 사람이 읽기 좋은 이름을 붙일 때 사용 ```kotlin import org.junit.jupiter.api.* @TestInstance(TestInstance.Lifecycle.PER_CLASS) @DisplayName("계산기 테스트") class CalculatorTest { private lateinit var calculator: Calculator @BeforeAll fun setup() { calculator = Calculator() } @Test @DisplayName("3 + 4는 7이다") fun addition_is_correct() { val result = calculator.add(3,

4) Assertions.assertEquals(7, result) } } ``` - Kotlin에서 `@BeforeAll`이나 `@AfterAll`을 사용할 때는 `@TestInstance(TestInstance.Lifecycle.PER_CLASS)` 애너테이션을 클래스에 붙여야, `companion object` 없이 인스턴스 메서드로 실행할 수 있습니다.

그렇지 않으면 `companion object` 내부의 `@JvmStatic` 메서드에 붙여야 합니다.

---

5. Parameterized Tests (매개변수화 테스트) JUnit 5는 매개변수화 테스트를 공식 지원합니다.

Kotlin과 함께 사용하면 반복 코드 없이 다양한 입력값을 테스트할 수 있습니다.

의존성 추가: ```kotlin testImplementation("org.junit.jupiter:junit-jupiter-params:5.9.2") ``` 예시: ```kotlin import org.junit.jupiter.params.ParameterizedTest import org.junit.jupiter.params.provider.CsvSource import org.junit.jupiter.api.Assertions.assertEquals class CalculatorTest { private val calculator = Calculator() @ParameterizedTest @CsvSource( "1, 1, 2", "2, 3, 5", "10, 5, 15" ) fun `덧셈 테스트`(a: Int, b: Int, expected: Int) { val result = calculator.add(a, b) assertEquals(expected, result) } } ``` ---

6. Kotlin과 JUnit 5를 함께 쓸 때 유용한 팁 - `assertThrows` 사용하기 ```kotlin import org.junit.jupiter.api.assertThrows @Test fun `예외가 발생하는 경우 테스트`() { val exception = assertThrows { calculator.divide(10, 0) } assertEquals("0으로 나눌 수 없습니다", exception.message) } ``` - Kotlin의 `assertThrows` 확장 함수 덕분에 체감이 매우 좋습니다.

- 코틀린 테스트 프레임워크와 함께 사용하기 Kotest, Spek 같은 Kotlin 전용 테스트 프레임워크도 있지만, JUnit 5가 가장 널리 쓰이고 도구 지원도 뛰어납니다.

--- 요약 - 의존성 추가 : `junit-jupiter-api`, `junit-jupiter-engine` 및 필요 시 `junit-jupiter-params`를 build.gradle.kts에 추가 - 테스트 클래스 : Kotlin 클래스로 작성 후 JUnit 5 애너테이션(`@Test`) 활용 - Kotlin 특성 활용 : 백틱 함수명, 널 안전성, 확장 함수 및 람다 사용 - JUnit 5 기능 활용 : `@BeforeEach`, `@AfterEach`, `@DisplayName`, 파라미터화 테스트 등 자유롭게 사용 - 팁 : `@TestInstance(TestInstance.Lifecycle.PER_CLASS)` 설정으로 `@BeforeAll`을 인스턴스 메서드로 작성 가능, Kotlin-friendly `assertThrows` 활용 이렇게 하면 Kotlin에서 JUnit 5를 활용해 깔끔하고 강력한 테스트 코드를 작성할 수 있습니다.