
calamine
Чиста Rust библиотека за електронни таблици
Четете XLS, XLSX, XLSM, XLSB, ODS и други с нулево копираща десериализация в Rust.
Какво е calamine?
calamine е високопроизводителна, чиста Rust библиотека за четене и десериализиране на Excel и OpenDocument файлове за електронни таблици. Тя поддържа формати като XLS, XLSX, XLSM, XLSB, ODS и други, като се фокусира върху бързо, безопасно и нулево копиране при извличане на данни. Проектирана за надеждност и минимални зависимости, calamine избягва външни системни библиотеки и разчита изцяло на чисти Rust реализации. Нейният API позволява на разработчиците ефективно да извличат стойности от клетки, да работят с VBA проекти и да анализират формули без сложна настройка или време за изпълнение.
Библиотеката се отличава в приложения, където производителността е критична, предлагайки значително по-бърза обработка в сравнение с алтернативи на Python, C# и Go. С вградената интеграция на Serde, calamine позволява безпроблемно съпоставяне на данните от електронните таблици към Rust структури. Тя поддържа лениво зареждане за големи файлове, конфигурация на реда с заглавия и опционални функции като поддръжка на дати/време чрез chrono и извличане на данни за изображения. Независимо дали създавате CLI инструменти, уеб бекендове или вградени системи, calamine осигурява стабилна, предвидима производителност на различни платформи.
Започване с calamine
За да започнете да използвате calamine, добавете го към вашия Rust проект чрез Cargo. Можете да го инсталирате директно, като използвате cargo add calamine, или ръчно да добавите зависимостта във вашия Cargo.toml. Библиотеката е достъпна на crates.io и нейният изходен код е хостван в calamine GitHub. За разширено използване, активирайте незадължителните функции като chrono за поддръжка на дата/време или picture за извличане на данни от изображения. Библиотеката се компилира чисто на стабилния Rust и не изисква външни бинарни файлове или системни библиотеки.
Инсталирайте calamine чрез Cargo
cargo add calamineДесериализация на електронни таблици, базирана на Serde
calamine предоставя мощна интеграция със Serde за директно съпоставяне на данни от електронни таблици към Rust структури. С помощта на RangeDeserializerBuilder, разработчиците могат да дефинират силно типизирани модели на данни и автоматично да десериализират редове в структуриран запис. Библиотеката включва помощни функции като deserialize_as_f64_or_none и deserialize_as_f64_or_string, за да се справя с колони със смесени типове по елегантен начин. Този подход осигурява типова безопасност, намалява boilerplate кода и позволява валидиране по време на компилация на структури от данни. Особено полезен е за данни потоци, инструменти за отчитане и 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 позволява извличане на модули от VBA проекти и дефиниции на формули от Excel файлове. Разработчиците могат да извличат 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 поддържа lazy loading за файлове XLSX и XLSB, което позволява ефективна обработка на големи електронни таблици без да се зареждат всички листове в паметта едновременно. Чрез конфигуриране на редовете с заглавия и използване на итерация по диапазони, разработчиците могат да намалят използването на памет и да максимизират пропускателната способност. Тази функция е особено ценна за безсървърни функции, CLI инструменти и вградени внедрявания, където ресурсите са ограничени. Тестовете показват, че calamine чете над 1 млн. реда с минимално натоварване на паметта в сравнение с алтернативи като openpyxl и ClosedXML, което я прави идеална за високоскалови конвейери за вмъкване на данни.
Ефективна обработка на големи електронни таблици
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);
}Оптимизация на производителността и тестове
calamine предоставя изключителна производителност, обработвайки 41 million клетки за по-малко от 25 секунди—надминавайки библиотеките за Python, C# и Go до 9.4x. Нейният zero-copy дизайн и минималните heap алокации значително намаляват използването на CPU и памет. Тестовете върху 186MB XLSX файл показват, че calamine използва само 186MB дискови четения в сравнение с 1.5GB за excelize. Детерминираното поведение на паметта и ниското натоварване на GC правят библиотеката подходяща за приложения в реално време и чувствителни към латентност. Разработчиците се възползват от предвидимо използване на ресурси и постоянен пропускателен капацитет при различни натоварвания.
