JetBrains Fleet에서 Kotest 테스트 실행하기: Run Configuration 설정 가이드 ::

들어가며: Fleet과 Kotest, 아직은 어색한 사이

JetBrains Fleet은 IntelliJ 기반의 경량 IDE입니다. 다만 기존 IntelliJ IDEA에서 당연하게 쓰던 기능 중 일부는 아직 지원되지 않거나 별도 설정이 필요합니다. 대표적인 예가 Kotest 플러그인의 부재 입니다.

IntelliJ에서는 Kotest 플러그인 덕분에 테스트 클래스나 메서드 옆의 ‘재생’ 버튼을 눌러 손쉽게 테스트를 실행할 수 있었습니다. 하지만 Fleet에서는 이 기능이 기본적으로 작동하지 않아, Kotest 사용자들이 테스트 실행에 불편함을 겪고 있습니다.

이 글에서는 Fleet의 Run Configuration 을 사용해 현재 열려 있는 Kotest 테스트 파일을 실행하는 방법을 정리합니다.

기본 방법: Gradle을 통한 테스트 실행

물론 Gradle을 사용하면 터미널에서 직접 테스트를 실행할 수 있습니다. 프로젝트의 모든 테스트를 실행하려면 다음 명령어를 사용합니다.

gradle test

만약 특정 파일의 테스트만 실행하고 싶다면, --tests 옵션을 사용하여 클래스의 전체 경로(fully qualified name)를 지정해야 합니다. 예를 들어, com.demo.TestFile 클래스의 테스트만 실행하려면 다음과 같이 입력합니다.

gradle test --tests "com.demo.TestFile"

하지만 이 방법은 다음과 같은 한계가 있습니다.

테스트 결과를 한눈에 파악하기 어렵습니다.
실행하려는 테스트 파일이 바뀔 때마다 긴 클래스 경로를 포함한 명령어를 매번 다시 입력해야 하는 번거로움이 있습니다.

해결책: Fleet의 사용자 정의 Run Configuration 사용하기

Fleet은 .fleet/run.json 파일로 사용자 정의 실행 구성을 만들 수 있습니다. 이를 이용해 현재 열려 있는 테스트 파일을 동적으로 실행하는 구성을 만들겠습니다.

1. `run.json` 파일 생성

프로젝트의 루트 디렉터리에 .fleet 폴더를 생성하고, 그 안에 run.json 파일을 만듭니다. 그리고 아래 내용을 붙여넣습니다.

{
    "configurations": [
      {
        "type": "gradle",
        "name": "Run Current Kotest File",
        "tasks": [ "test" ],
        "args": [ "--tests", "$FILE_NAME_NO_EXT$" ],
        "workingDir": "$PROJECT_DIR$"
      }
    ]
}

2. 설정 파일 분석

각 설정 항목의 의미는 다음과 같습니다.

"type": "gradle" 이 실행 구성이 Gradle 을 사용하여 실행됨을 Fleet에 알립니다.
"name": "Run Current Kotest File" Fleet의 실행 메뉴(Run & Debug 패널)에 표시될 이름입니다. 원하는 이름으로 자유롭게 변경할 수 있습니다.
"tasks": [ "test" ] 실행할 Gradle 태스크를 지정합니다. 여기서는 표준 테스트 태스크인 test를 사용합니다.
"args": [ "--tests", "$FILE_NAME_NO_EXT$" ] test 태스크에 전달할 인자를 정의합니다.
- --tests: Gradle에게 특정 테스트만 실행하도록 지시하는 플래그입니다.
- $FILE_NAME_NO_EXT$ : Fleet이 제공하는 동적 변수 로, 현재 에디터에 열려 있는 파일의 전체 경로 이름(패키지 포함, 확장자 제외)으로 자동 치환됩니다. 예를 들어, src/test/kotlin/com/demo/MyTest.kt 파일을 열고 이 구성을 실행하면, 이 변수는 com.demo.MyTest라는 문자열로 바뀝니다.
"workingDir": "$PROJECT_DIR$" 명령어가 실행될 작업 디렉터리를 지정합니다. $PROJECT_DIR$ 변수는 프로젝트의 루트 폴더를 가리킵니다.

3. 사용 방법

설정이 완료되면 다음과 같이 사용할 수 있습니다.

실행하고 싶은 Kotest 테스트 파일(예: MyTest.kt)을 에디터에서 엽니다.
Fleet 우측 상단의 Run & Debug 패널을 엽니다.
드롭다운 메뉴에서 방금 생성한 “Run Current Kotest File” 구성을 선택합니다.
‘재생(Run)’ 버튼을 클릭합니다.

이제 Fleet은 Gradle을 통해 현재 열려 있는 파일의 테스트만 실행하고, 결과를 IDE 안의 테스트 결과 창에 보여줍니다.

마무리

JetBrains Fleet에는 아직 공식 Kotest 플러그인이 없습니다(FL-19204 이슈에서 관련 논의를 확인할 수 있습니다). 그래도 Run Configuration을 사용하면 현재 파일 기준으로 테스트를 실행하는 흐름은 만들 수 있습니다.

플러그인 지원이 들어오기 전까지는 이런 방식으로 필요한 실행 구성을 직접 만들어 쓰면 됩니다.

이 글은 AI의 도움을 받아 교정 및 정리되었습니다.

검색

JetBrains Fleet에서 Kotest 테스트 실행하기: Run Configuration 설정 가이드

들어가며: Fleet과 Kotest, 아직은 어색한 사이 #

기본 방법: Gradle을 통한 테스트 실행 #

해결책: Fleet의 사용자 정의 Run Configuration 사용하기 #

1. run.json 파일 생성 #

2. 설정 파일 분석 #

3. 사용 방법 #

마무리 #