
umya-spreadsheet
XLSX/XLSM 파일을 위한 순수 Rust 라이브러리
외부 의존성 없이 XLSX/XLSM 스프레드시트를 읽고, 쓰고, 스타일링하고, 조작하기.
umya-spreadsheet란 무엇인가요?
umya-spreadsheet은 XLSX 및 XLSM 형식의 Excel 스프레드시트 파일을 읽고 쓰기 위한 고성능 순수 Rust 라이브러리입니다. 안전성과 효율성을 위해 설계되어 unsafe 코드와 외부 종속성을 피하며, 데스크톱 애플리케이션, 서버 측 처리 및 WebAssembly 환경에 이상적입니다. 이 라이브러리는 셀, 행, 열, 스타일, 차트 및 이미지를 접근하기 위한 깔끔하고 관용적인 Rust API를 제공하여 개발자가 Microsoft Office나 COM 인터옵에 의존하지 않고도 견고한 스프레드시트 도구를 구축할 수 있게 합니다.
lazy loading, 비밀번호 보호 및 풍부한 서식을 완벽히 지원함으로써, umya-spreadsheet은 성능과 사용성 사이의 격차를 메워줍니다. CSV 내보내기, 차트 생성, 이미지 삽입 및 이동·복사와 같은 범위 작업을 지원합니다. 이 프로젝트는 활발히 유지 관리되고 문서화가 잘 되어 있으며, 테스트도 충분히 진행되어 최신 Excel 기능에 대한 정확성과 호환성에 중점을 두고 있습니다. 개발자는 Tauri 또는 Axo와 같은 프레임워크를 사용하여 CLI 도구, 웹 백엔드 또는 데스크톱 앱에 이를 통합할 수 있습니다.
umya-spreadsheet 시작하기
umya-spreadsheet를 사용하려면 `umya-spreadsheet = "3.1.1"`을 Cargo.toml에 추가하십시오. WebAssembly 지원을 위해 `js` 기능을 활성화하십시오. 이 라이브러리는 의존성이 적고 빠르게 컴파일됩니다. 설치가 완료되면 `extern crate umya_spreadsheet;`를 통해 가져와 스프레드시트를 읽거나 쓸 수 있습니다. 예제, 테스트 및 문서를 보려면 umya-spreadsheet GitHub을 탐색할 수도 있습니다. 대용량 파일에 대한 지연 로딩을 지원하며 강력한 오류 처리를 제공합니다.
Cargo를 통해 umya-spreadsheet 설치
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
XLSX/XLSM 파일 읽기 및 쓰기
umya-spreadsheet는 XLSX 및 XLMS 파일을 읽고 쓰기 위한 직관적인 API를 제공합니다. `reader::xlsx::read()`를 사용하여 디스크에서 워크북을 로드하거나, `new_file()`로 빈 워크북을 생성합니다. 쓰기도 마찬가지로 간단합니다: 워크북과 대상 경로를 지정하여 `writer::xlsx::write()`를 호출합니다. 이 라이브러리는 대용량 파일에서 성능을 향상시키기 위해 `lazy_read()`를 통한 지연 로딩을 지원하며, 비밀번호 보호된 쓰기 또는 생성 후 비밀번호 설정을 허용합니다. 모든 작업은 가능한 경우 안전하고 제로 복사를 보장하며 외부 바이너리를 사용하지 않습니다.
Rust로 XLSX 파일을 읽고 쓰는 방법은?
use std::path::Path;
// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();
// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();
셀 접근 및 스타일 조작
셀 값을 접근하고 수정하는 것은 간단합니다: 읽기를 위해 `cell("A1")` 또는 `cell((1,1))`를 사용하고, 쓰기를 위해 `cell_mut()`를 사용합니다. 스타일은 `style_mut()`를 통해 관리되며, 배경색, 글꼴, 테두리 및 정렬 변경을 허용합니다. 이 라이브러리는 가능한 경우 불변성 보장을 유지하면서 풍부한 스타일 속성을 제공합니다. 또한 포맷된 값을 가져오고, 조건 로직을 적용하며, 범위 전체에 스타일을 일괄 업데이트할 수 있습니다. 이는 일관된 포맷으로 보고서, 대시보드 또는 데이터 내보내기를 생성하는 데 이상적입니다.
Rust를 사용하여 셀 값 및 스타일을 수정하는 방법?
let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
.unwrap()
.cell_mut("A1")
.set_value("Hello, Rust!");
let mut style = book.sheet_by_name_mut("Sheet1")
.unwrap()
.style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);
차트 및 이미지 지원
umya-spreadsheet는 시리즈 범위와 마커를 정의하여 선형, 막대 및 영역 차트와 같은 차트를 생성하고 편집하는 것을 지원합니다. `Image` 구조체를 사용하여 이미지를 시트에 직접 삽입할 수 있으며, 활성화된 기능에 따라 PNG 및 기타 형식을 지원합니다. 차트와 이미지는 셀 좌표 및 그리기 레이어와 원활하게 통합되어 동적 대시보드 생성을 가능하게 합니다. 일부 고급 그리기 기능은 아직 개발 중이지만, 핵심 기능은 프로덕션에 적합하고 확장 가능합니다.
Rust를 사용하여 스프레드시트에 라인 차트를 추가하는 방법?
let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
umya_spreadsheet::structs::ChartType::LineChart,
from_marker,
to_marker,
series,
);
book.sheet_by_name_mut("Sheet1")
.unwrap()
.add_chart(chart);
범위 작업 및 비밀번호 보호
`move_range()`를 사용하여 범위를 이동, 복사 및 크기 조정과 같은 고급 작업을 수행하여 동적 데이터 재구성을 가능하게 합니다. 이 라이브러리는 비밀번호로 보호된 워크북도 지원합니다: `write_with_password()`로 파일을 작성하거나 `set_password()`를 통해 기존 파일에 비밀번호를 적용합니다. 이러한 기능은 기업 또는 규정 준수에 민감한 애플리케이션에서 안전한 데이터 처리를 위해 필수적입니다. 무의존성 설계와 WASM 호환성을 결합한 umya-spreadsheet는 유연성과 보안을 모두 제공합니다.
Rust를 사용하여 범위를 이동하고 파일을 비밀번호로 보호하는 방법?
// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
.unwrap()
.move_range(range, &10, &2);
// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
&book,
Path::new("./protected.xlsx"),
"mypassword",
).unwrap();
