calamine

 
 

스프레드시트를 위한 순수 Rust 라이브러리

Rust에서 제로 카피 역직렬화를 통해 XLS, XLSX, XLSM, XLSB, ODS 등 다양한 형식을 읽어보세요.

Calamine이란 무엇인가요?

calamine은 Excel 및 OpenDocument 스프레드시트 파일을 읽고 역직렬화하기 위한 고성능 순수 Rust 라이브러리입니다. XLS, XLSX, XLSM, XLSB, ODS 등과 같은 형식을 지원하며, 빠르고 안전하며 제로 복사 데이터 추출에 중점을 둡니다. 신뢰성과 최소한의 의존성을 위해 설계된 calamine은 외부 시스템 라이브러리를 피하고 순수 Rust 구현만을 사용합니다. API를 통해 개발자는 복잡한 설정이나 런타임 오버헤드 없이 셀 값을 효율적으로 추출하고, VBA 프로젝트를 처리하며, 수식을 파싱할 수 있습니다.

이 라이브러리는 성능이 중요한 애플리케이션에서 뛰어나며, Python, C#, Go 대안보다 훨씬 빠른 처리를 제공합니다. 내장된 Serde 통합을 통해 calamine은 스프레드시트 데이터를 Rust 구조체에 원활하게 매핑할 수 있게 합니다. 대용량 파일에 대한 지연 로딩, 헤더 행 구성, 그리고 chrono 날짜/시간 지원 및 이미지 데이터 추출과 같은 선택적 기능을 지원합니다. CLI 도구, 웹 백엔드, 임베디드 시스템을 구축하든, calamine은 플랫폼 전반에 걸쳐 견고하고 예측 가능한 성능을 제공합니다.

Previous Next

Calamine 시작하기

calamine을 사용하려면 Cargo를 통해 Rust 프로젝트에 추가하십시오. 직접 cargo add calamine을 사용해 설치하거나 Cargo.toml에 수동으로 의존성을 추가할 수 있습니다. 이 라이브러리는 crates.io에서 제공되며 소스 코드는 calamine GitHub에 호스팅됩니다. 고급 사용을 위해 날짜/시간 지원을 위한 chrono 또는 이미지 데이터 추출을 위한 picture와 같은 선택적 기능을 활성화하십시오. 이 라이브러리는 안정적인 Rust에서 문제없이 컴파일되며 외부 바이너리나 시스템 라이브러리를 필요로 하지 않습니다.

Cargo를 통해 Calamine 설치

cargo add calamine

Serde 기반 스프레드시트 역직렬화

calamine은 스프레드시트 데이터를 Rust 구조체에 직접 매핑하기 위한 강력한 Serde 통합을 제공합니다. RangeDeserializerBuilder를 사용하면 개발자는 강타입 데이터 모델을 정의하고 행을 자동으로 구조화된 레코드로 역직렬화할 수 있습니다. 이 라이브러리에는 deserialize_as_f64_or_none 및 deserialize_as_f64_or_string와 같은 헬퍼 함수가 포함되어 있어 혼합 타입 열을 우아하게 처리합니다. 이 접근 방식은 타입 안전성을 보장하고 보일러플레이트를 줄이며 데이터 구조에 대한 컴파일 타임 검증을 가능하게 합니다. 신뢰성과 성능이 중요한 데이터 파이프라인, 보고 도구 및 ETL 애플리케이션에 특히 유용합니다.

스프레드시트 행을 Rust 구조체로 역직렬화

use calamine::{deserialize_as_f64_or_none, open_workbook, RangeDeserializerBuilder, Reader, Xlsx};
use serde::Deserialize;

#[derive(Deserialize)]
struct Record {
    metric: String,
    #[serde(deserialize_with = "deserialize_as_f64_or_none")]
    value: Option,
}

let mut excel: Xlsx<_> = open_workbook("file.xlsx")?;
let range = excel.worksheet_range("Sheet1")?;
let iter = RangeDeserializerBuilder::with_headers(&["metric", "value"]).from_range(&range)?;
for result in iter {
    let record: Record = result?;
    println!("{:?}", record);
}

VBA 프로젝트 및 수식 추출

calamine은 Excel 파일에서 VBA 프로젝트 모듈 및 수식 정의를 추출할 수 있게 합니다. 개발자는 모듈에서 VBA 코드를 가져오고, 깨진 참조를 감지하며, 정의된 이름과 해당 수식을 검사할 수 있습니다. 이 기능은 마이그레이션 도구, 감사 유틸리티 및 레거시 시스템 분석에 필수적입니다. API는 VBA 메타데이터에 구조화된 접근을 제공하고, 단순 및 복잡한 워크북 내부 조사 시나리오를 모두 지원합니다. 보안 목적의 매크로 분석이든 레거시 Excel 로직 변환이든, calamine은 숨겨진 워크북 콘텐츠에 대한 정확하고 저수준의 접근을 제공합니다.

VBA 코드와 정의된 이름 추출

use calamine::{open_workbook_auto, Reader};

let mut workbook = open_workbook_auto("file.xlsx")?;
if let Ok(Some(vba)) = workbook.vba_project() {
    let module = vba.get_module("Module1").unwrap();
    println!("{}", module);
    for ref in vba.get_references() {
        if ref.is_missing() { println!("Broken: {}", ref.name); }
    }
}
for (name, formula) in workbook.defined_names() {
    println!("{}: {}", name, formula);
}

지연 로딩 및 대용량 파일 처리

calamine은 XLSX 및 XLSB 파일에 대한 지연 로딩을 지원하여 모든 시트를 한 번에 메모리로 로드하지 않고도 대용량 스프레드시트를 효율적으로 처리할 수 있게 합니다. 헤더 행을 설정하고 범위 기반 반복을 사용함으로써 개발자는 메모리 사용량을 최소화하고 처리량을 극대화할 수 있습니다. 이 기능은 리소스가 제한된 서버리스 함수, CLI 도구 및 임베디드 배포 환경에서 특히 유용합니다. 벤치마크에 따르면 calamine은 openpyxl 및 ClosedXML과 같은 대안에 비해 최소한의 메모리 오버헤드로 100만 행 이상을 읽어들여, 고규모 데이터 수집 파이프라인에 이상적입니다.

대용량 스프레드시트를 효율적으로 처리

use calamine::{open_workbook, Reader, Xlsx};

let mut excel: Xlsx<_> = open_workbook("large.xlsx")?;
let range = excel
    .worksheet_range("Sheet1")?
    .expect("Sheet not found");

for row in range.rows() {
    // Process row without loading entire file
    process_row(row);
}

Performance Optimization and Benchmarks

calamine은 뛰어난 성능을 제공하여 4,100만 셀을 25초 미만에 처리하며, Python, C#, Go 라이브러리보다 최대 9.4배 빠릅니다. 제로 복사 설계와 최소 힙 할당으로 CPU와 메모리 사용량을 크게 줄입니다. 186MB XLSX 파일에 대한 벤치마크에서 calamine은 excelize의 1.5GB에 비해 186MB 디스크 읽기만 사용함을 보여줍니다. 라이브러리의 결정론적 메모리 동작과 낮은 GC 압력은 실시간 및 지연 민감 애플리케이션에 적합합니다. 개발자는 예측 가능한 자원 사용과 다양한 워크로드에서 일관된 처리량을 얻을 수 있습니다.

 한국인