CLI 도구

SheetKit은 터미널에서 Excel (.xlsx) 파일을 직접 다룰 수 있는 커맨드라인 도구를 포함합니다. CLI를 통해 코드를 작성하지 않고도 일반적인 워크북 작업을 빠르게 수행할 수 있습니다.

설치

cli feature를 활성화하여 소스에서 빌드합니다:

cargo install sheetkit --features cli

또는 로컬에서 빌드합니다:

cargo build --release --package sheetkit --features cli

바이너리는 target/release/sheetkit 경로에 생성됩니다.

명령어

info

시트 이름, 활성 시트, 문서 속성 등 워크북 정보를 표시합니다.

sheetkit info report.xlsx

출력 예시:

File: report.xlsx
Sheets: 3
  1: Summary (active)
  2: Data
  3: Charts
Creator: John Smith
Modified: 2025-01-15T10:30:00Z

sheets

워크북의 모든 시트 이름을 한 줄에 하나씩 출력합니다.

sheetkit sheets report.xlsx

출력 예시:

Summary
Data
Charts

스크립팅에 활용할 수 있습니다:

for sheet in $(sheetkit sheets report.xlsx); do
  sheetkit convert report.xlsx -f csv -o "${sheet}.csv" --sheet "$sheet"
done

read

시트 데이터를 읽어서 표시합니다. 기본적으로 활성 시트를 탭 구분 형식으로 출력합니다.

# 활성 시트를 테이블로 읽기
sheetkit read report.xlsx

# 특정 시트 읽기
sheetkit read report.xlsx --sheet Data

# CSV 형식으로 출력
sheetkit read report.xlsx --format csv

옵션:

플래그	단축	설명
--sheet <name>	-s	읽을 시트 (기본값: 활성 시트)
--format <fmt>	-f	출력 형식: table (기본값) 또는 csv

get

단일 셀 값을 가져옵니다.

sheetkit get report.xlsx Sheet1 A1

셀 값이 stdout으로 출력됩니다. 빈 셀은 출력이 없습니다. 정수인 숫자 값은 소수점 없이 표시됩니다. 불리언 값은 TRUE 또는 FALSE로 표시됩니다.

set

셀 값을 설정하고 새 파일로 저장합니다.

sheetkit set report.xlsx Sheet1 A1 "New Title" -o updated.xlsx

값은 자동으로 해석됩니다:

• TRUE / FALSE (대소문자 무관)는 불리언으로 저장됩니다.
• 유효한 숫자는 숫자 값으로 저장됩니다.
• 그 외의 값은 문자열로 저장됩니다.

옵션:

플래그	단축	설명
--output <path>	-o	출력 파일 경로 (필수)

convert

시트를 다른 형식으로 변환합니다.

# 활성 시트를 CSV로 변환
sheetkit convert report.xlsx -f csv -o output.csv

# 특정 시트를 변환
sheetkit convert report.xlsx -f csv -o data.csv --sheet Data

옵션:

플래그	단축	설명
--format <fmt>	-f	대상 형식: csv (필수)
--output <path>	-o	출력 파일 경로 (필수)
--sheet <name>	-s	변환할 시트 (기본값: 활성 시트)

종료 코드

코드	의미
0	성공
1	오류 (잘못된 파일, 존재하지 않는 시트, 잘못된 셀 참조 등)

오류 메시지는 stderr로 출력됩니다.

사용 예시

# 알 수 없는 스프레드시트를 빠르게 확인
sheetkit info data.xlsx
sheetkit sheets data.xlsx
sheetkit read data.xlsx | head -5

# 스크립트에서 특정 값 추출
total=$(sheetkit get data.xlsx Summary B10)
echo "Total: $total"

# 셀을 업데이트하고 내보내기
sheetkit set template.xlsx Report A1 "Q4 2025" -o report.xlsx
sheetkit convert report.xlsx -f csv -o report.csv

# 모든 시트를 CSV로 내보내기
for sheet in $(sheetkit sheets workbook.xlsx); do
  sheetkit convert workbook.xlsx -f csv -o "${sheet}.csv" --sheet "$sheet"
done