1. 제품
  2.   스프레드시트
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Excel XLSX 생성을 위한 Rust 라이브러리

Rust API를 통해 서식, 병합 셀, 자동 필터 및 이미지를 포함한 완전 호환 Excel XLSX 파일을 생성합니다.

xlsxwriter-rs란 무엇인가요?

xlsxwriter-rs는 널리 사용되는 libxlsxwriter C 라이브러리에 대한 고성능 Rust 바인딩으로, 개발자가 Rust 애플리케이션에서 직접 완전 호환되는 Excel XLSX 파일을 생성할 수 있게 합니다. 글꼴, 색상, 정렬, 테두리 및 숫자 형식을 포함한 포괄적인 Excel 서식을 지원하며, 병합 셀, 자동 필터, 데이터 유효성 검사 및 PNG/JPEG 이미지 삽입과 같은 고급 기능도 제공합니다. 신뢰성과 속도를 위해 설계된 xlsxwriter-rs는 서버 측 보고서 생성, 데이터 내보내기 파이프라인 및 Rust에서 프로그래밍 방식으로 Excel 파일을 생성해야 하는 모든 상황에 이상적입니다.

이 라이브러리는 Rust의 메모리 안전성과 제로 코스트 추상화를 활용하여 Microsoft Excel이나 COM과 같은 외부 종속성을 필요로 하지 않는 안전하고 효율적인 Excel 생성 API를 제공합니다. Cargo와 원활하게 통합되며, MD5 체크섬 비활성화 또는 시스템 zlib 사용과 같은 동작을 맞춤 설정할 수 있는 선택적 기능 플래그를 지원합니다. 깔끔하고 관용적인 Rust 인터페이스와 포괄적인 문서를 통해 xlsxwriter-rs는 개발자가 파일 구조와 내용을 완전히 제어하면서 견고하고 크로스 플랫폼 Excel 생성 도구를 구축하도록 돕습니다.

Previous Next

xlsxwriter-rs 시작하기

xlsxwriter-rs를 사용하려면, cargo add xlsxwriter를 통해 Cargo.toml에 추가하거나 [dependencies]에 xlsxwriter = "0.1"를 수동으로 포함하십시오. 이 라이브러리는 bindgen 컴파일을 위해 LLVM과 Clang이 필요합니다. Windows의 경우 Visual Studio와 LLVM을 설치한 후 LIBCLANG_PATH를 LLVM bin 디렉터리로 설정하십시오. 설정이 완료되면 저장소를 클론하고 git submodule update --init --recursive를 실행하여 C 라이브러리를 가져온 다음 cargo run --example hello_spreadsheet로 예제를 빌드하십시오. 전체 문서와 예제는 xlsxwriter-rs GitHub에서 확인할 수 있습니다.

Cargo를 통해 xlsxwriter-rs 설치

cargo add xlsxwriter

전체 Excel 서식 지원

xlsxwriter-rs는 포괄적인 서식 기능을 제공하여 개발자가 개별 셀이나 범위에 대해 글꼴, 색상, 테두리, 정렬 및 숫자 형식을 사용자 지정할 수 있게 합니다. 굵게, 기울임꼴, 밑줄, 글자 크기 및 사용자 정의 색상을 텍스트에 적용하고, 배경 채우기 색상을 설정하며, 다양한 스타일(얇게, 중간, 두껍게)의 셀 테두리를 정의하고, 가로/세로 정렬을 제어할 수 있습니다. 이러한 수준의 제어를 통해 생성된 Excel 파일이 전문적인 보고 표준에 부합하도록 보장합니다. 서식은 Format 구조체를 사용하여 적용되며, 직관적인 구성을 위해 메서드 체이닝을 지원합니다. 이 기능은 가독성과 사용자 경험을 향상시키는 시각적으로 구별된 보고서, 대시보드 및 데이터 내보내기를 만드는 데 필수적입니다.

셀에 글꼴 색상 및 정렬 적용

let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
    0, 0, 
    "Red text", 
    Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
    2, 0, 
    "Centered green text", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

병합된 셀 및 범위

이 라이브러리는 셀의 직사각형 범위를 병합하는 기능을 지원하며, 이는 Excel 보고서에서 헤더, 제목 및 그룹화된 데이터 섹션을 만드는 데 필수적입니다. merge_range 메서드를 사용하면 여러 행과 열에 걸쳐 병합 블록 전체에 서식을 적용할 수 있습니다. 이를 통해 복잡한 스프레드시트 전반에 걸쳐 일관된 스타일링과 레이아웃을 보장합니다. 병합된 셀은 Excel의 렌더링 엔진과 완전히 호환되며 텍스트 정렬, 테두리 및 배경 색상과 같은 서식을 유지합니다. 이 기능은 재무 보고서, 대시보드 및 시각적 그룹화가 데이터 이해와 프레젠테이션 품질을 향상시키는 양식에 특히 유용합니다.

사용자 지정 서식으로 범위 병합

sheet1.merge_range(
    2, 0, 
    3, 2, 
    "Hello, world", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

자동 필터 및 데이터 유효성 검사

xlsxwriter-rs는 자동 필터와 데이터 유효성 검사 규칙을 프로그래밍 방식으로 생성할 수 있게 하여 사용자가 Excel에서 직접 데이터를 정렬, 필터링 및 검증할 수 있도록 합니다. set_autofilter를 사용하여 셀 범위에 자동 필터를 적용하고, 데이터 유효성 검사를 통해 사용자 입력을 위한 드롭다운 목록을 정의할 수 있습니다. 이는 목록 기반 검증, 숫자 범위, 날짜 및 사용자 정의 수식을 지원합니다. 이러한 기능은 스프레드시트의 상호 작용성과 데이터 무결성을 향상시켜 양식, 템플릿 및 협업 데이터 입력에 적합합니다. 생성된 XLSX 파일은 Excel, LibreOffice 또는 Google Sheets에서 열었을 때 전체 기능을 유지하여 광범위한 호환성을 보장합니다.

자동 필터 및 데이터 유효성 검사 적용

// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;

// Add data validation (drop-down list) in B2
sheet1.data_validation(
    "B2", 
    DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;

이미지 및 하이퍼링크 삽입

xlsxwriter-rs를 사용하여 PNG 및 JPEG 이미지를 Excel 워크시트에 직접 삽입할 수 있으며, 위치 지정, 크기 조정 및 스케일링을 지원합니다. 이는 보고서에 로고, 차트 또는 시각적 표시기를 추가하는 데 이상적입니다. 또한 이 라이브러리는 하이퍼링크와 URL을 사용자 정의 형식(예: 파란색 텍스트와 밑줄)으로 지원하여 웹사이트, 문서 또는 다른 시트에 대한 클릭 가능한 링크를 만들 수 있습니다. 이러한 기능 덕분에 xlsxwriter-rs는 데이터, 시각 자료 및 탐색을 결합한 풍부하고 인터랙티브한 보고서와 대시보드를 만드는 데 적합합니다. 삽입된 모든 콘텐츠는 Excel의 렌더링 엔진과 완전히 호환되며 플랫폼 간 레이아웃 무결성을 유지합니다.

URL 작성 및 이미지 삽입

// Write a clickable URL
sheet1.write_url(
    1, 1,
    "https://github.com/informationsea/xlsxwriter-rs",
    Some(&Format::new()
        .set_font_color(FormatColor::Blue)
        .set_underline(FormatUnderline::Single)
    )
)?;

// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;
 한국인