Kotlin Notebook에 의존성 추가하기

Kotlin Notebook에 의존성 추가하기 (Add dependencies to your Kotlin Notebook)

노트북이 생겼으니 이제 본격적으로 라이브러리를 불러오는 법을 배울 차례예요. Kotlin Notebook에서 의존성을 추가하는 다양한 방법과, 대표적인 데이터 분석 라이브러리를 실제로 넣어 보는 과정까지 살펴볼게요.

출처: Add dependencies to your Kotlin Notebook

본문

노트

IntelliJ IDEA 2026.2부터 Kotlin Notebook은 IDE에 번들로 포함되지 않고 JetBrains의 공식 지원도 받지 않게 돼요. 소스 코드는 GitHub에 계속 공개됩니다.

자세한 내용은 블로그 포스트에서 확인하세요.

첫 번째 Kotlin Notebook을 이미 만들었죠! 이제 고급 기능을 쓸 수 있게 라이브러리에 의존성을 추가하는 방법을 배워볼게요.

노트

Kotlin 표준 라이브러리는 기본으로 사용할 수 있어서 따로 import할 필요가 없어요.

Maven 저장소의 어떤 라이브러리든 코드 셀에서 Gradle스러운 문법으로 좌표(coordinates)를 지정해 불러올 수 있어요. 다만 Kotlin Notebook에는 인기 있는 라이브러리를 간단하게 불러오는 방법이 따로 있는데, 바로 %use 문이에요.

// Replace libraryName with the library dependency you want to add
%use libraryName
// Specify a version, if required
%use libraryName(version)
// Add v= to trigger autocomplete
%use libraryName(v=version)
// Example: kotlinx.datetime:0.7.1
%use datetime(v=0.7.1)

또한 Kotlin Notebook의 자동 완성 기능을 사용해서 사용 가능한 라이브러리에 빠르게 접근할 수도 있어요.

[이미지: Autocompletion feature in Kotlin Notebook]

노트

Kotlin Notebook에는 딥러닝부터 HTTP 네트워킹까지 다양한 작업을 위한 통합 라이브러리 세트가 있어요. 지원되는 라이브러리 가져오기를 참고하세요.

아직 Kotlin Notebook에 통합되지 않은 라이브러리를 추가해 사용할 수도 있어요. 새 라이브러리 통합을 참고하세요.

Kotlin Notebook에 Kotlin DataFrame과 Kandy 라이브러리 추가하기

Kotlin Notebook에 인기 있는 Kotlin 라이브러리 의존성 두 개를 추가해 볼게요.

Kotlin DataFrame 라이브러리는 Kotlin 프로젝트에서 데이터를 다룰 수 있는 힘을 줘요. API, SQL 데이터베이스, 그리고 CSV·JSON 같은 다양한 파일 형식에서 데이터를 가져오는 데 쓸 수 있어요.
Kandy 라이브러리는 차트를 만들기 위한 강력하고 유연한 DSL을 제공해요.

이 라이브러리들을 추가하려면 이렇게 해요.

Add Code Cell을 클릭해 새 코드 셀을 만드세요.
코드 셀에 다음 코드를 입력하세요.

// Ensures that the latest available library versions are used
%useLatestDescriptors

// Imports the Kotlin DataFrame library
%use dataframe

// Imports the Kotlin Kandy library
%use kandy

코드 셀을 실행하세요.

%use 문을 실행하면 라이브러리 의존성을 다운로드하고 노트북에 기본 import를 추가해요.

노트 %use libraryName 줄이 있는 코드 셀은 해당 라이브러리를 사용하는 다른 코드 셀을 실행하기 전에 먼저 실행해야 해요.

Kotlin DataFrame 라이브러리로 CSV 파일에서 데이터를 가져오려면 새 코드 셀에서 .read() 함수를 사용하세요.

// Creates a DataFrame by importing data from the "netflix_titles.csv" file.
val rawDf = DataFrame.read("netflix_titles.csv")

// Displays the raw DataFrame data
rawDf

팁 이 예제 CSV는 Kotlin DataFrame 예제 GitHub 저장소에서 다운로드할 수 있어요. 프로젝트 디렉터리에 추가하세요.

새 코드 셀에서 .plot 메서드로 DataFrame에 있는 TV 쇼와 영화의 분포를 시각화해 보세요.

rawDf
    // Counts the occurrences of each unique value in the column named "type"
    .valueCounts(sort = false) { type }
    // Visualizes data in a bar chart specifying the colors
    .plot {
        bars {
            x(type)
            y("count")
            fillColor(type) {
                scale = categorical(range = listOf(Color.hex("#00BCD4"), Color.hex("#009688")))
            }
        }

        // Configures the layout of the chart and sets the title
        layout {
            title = "Count of TV Shows and Movies"
            size = 900 to 550
        }
    }

결과 차트는 이렇게 나와요.

[이미지: Visualization using the Kandy library]

이렇게 Kotlin Notebook에 라이브러리를 추가하고 활용해 봤어요. Kotlin Notebook과 지원 라이브러리로 무엇을 할 수 있는지 맛을 보는 것에 불과해요.

무엇을 더 배울까

Kotlin Notebook을 공유하는 방법 배우기
Kotlin Notebook에 의존성을 추가하는 더 자세한 내용
Kotlin DataFrame 라이브러리를 다루는 더 포괄적인 가이드: 파일에서 데이터 가져오기
Kotlin에서 데이터 과학·분석에 쓸 수 있는 도구와 리소스의 전체 개요: Kotlin과 Java 데이터 분석 라이브러리