
calamine
Biblioteca Rust Pura para Planilhas
Leia XLS, XLSX, XLSM, XLSB, ODS & Mais com Desserialização Zero-Cópia em Rust.
O que é calamine?
calamine é uma biblioteca Rust pura e de alto desempenho para leitura e desserialização de arquivos de planilha Excel e OpenDocument. Ela suporta formatos como XLS, XLSX, XLSM, XLSB, ODS e outros, focando em extração de dados rápida, segura e sem cópias. Projetada para confiabilidade e dependências mínimas, a calamine evita bibliotecas de sistema externas e depende exclusivamente de implementações Rust puras. Sua API permite que desenvolvedores extraiam valores de células, manipulem projetos VBA e analisem fórmulas sem configuração complexa ou sobrecarga em tempo de execução.
A biblioteca se destaca em aplicações críticas de desempenho, oferecendo processamento significativamente mais rápido que alternativas em Python, C# e Go. Com integração nativa ao Serde, a calamine permite o mapeamento fluido de dados de planilhas para structs Rust. Ela suporta carregamento preguiçoso para arquivos grandes, configuração de linha de cabeçalho e recursos opcionais como suporte a datas/horas do chrono e extração de dados de imagens. Seja construindo ferramentas de linha de comando, back‑ends web ou sistemas embarcados, a calamine oferece desempenho robusto e previsível em todas as plataformas.
Começando com calamine
Para começar a usar o calamine, adicione‑o ao seu projeto Rust via Cargo. Você pode instalá‑lo diretamente usando cargo add calamine ou adicionar manualmente a dependência ao seu Cargo.toml. A biblioteca está disponível em crates.io e seu código‑fonte está hospedado no GitHub do calamine. Para uso avançado, habilite recursos opcionais como chrono para suporte a data/hora ou picture para extração de dados de imagem. A biblioteca compila perfeitamente no Rust estável e não requer binários externos ou bibliotecas do sistema.
Instale calamine via Cargo
cargo add calamineDesserialização de Planilhas Baseada em Serde
calamine fornece integração poderosa com Serde para mapear dados de planilhas diretamente para structs Rust. Usando RangeDeserializerBuilder, os desenvolvedores podem definir modelos de dados fortemente tipados e desserializar automaticamente linhas em registros estruturados. A biblioteca inclui funções auxiliares como deserialize_as_f64_or_none e deserialize_as_f64_or_string para lidar graciosamente com colunas de tipos mistos. Essa abordagem garante segurança de tipos, reduz código boilerplate e permite validação em tempo de compilação das estruturas de dados. É especialmente útil para pipelines de dados, ferramentas de relatório e aplicações ETL onde confiabilidade e desempenho são críticos.
Desserialize Linhas de Planilha em Estruturas 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);
} Extração de Projeto VBA e Fórmulas
calamine permite a extração de módulos de projetos VBA e definições de fórmulas de arquivos Excel. Os desenvolvedores podem recuperar o código VBA dos módulos, detectar referências quebradas e inspecionar nomes definidos e suas fórmulas. Essa capacidade é essencial para ferramentas de migração, utilitários de auditoria e análise de sistemas legados. A API fornece acesso estruturado aos metadados VBA e suporta cenários de introspecção de pastas de trabalho simples e complexos. Seja analisando macros por segurança ou convertendo lógica legada do Excel, o calamine oferece acesso preciso e de baixo nível ao conteúdo oculto da pasta de trabalho.
Extrair Código VBA e Nomes Definidos
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);
}Carregamento Preguiçoso e Manipulação de Arquivos Grandes
calamine suporta carregamento preguiçoso para arquivos XLSX e XLSB, permitindo o processamento eficiente de planilhas grandes sem carregar todas as folhas na memória de uma só vez. Ao configurar linhas de cabeçalho e usar iteração baseada em intervalos, os desenvolvedores podem minimizar o consumo de memória e maximizar o throughput. Esse recurso é particularmente valioso para funções serverless, ferramentas de linha de comando (CLI) e implantações embarcadas onde os recursos são limitados. Benchmarks mostram que o calamine lê mais de 1 milhão de linhas com sobrecarga de memória mínima em comparação com alternativas como openpyxl e ClosedXML, tornando‑o ideal para pipelines de ingestão de dados em grande escala.
Processar Grandes Planilhas de Forma Eficiente
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);
}Otimização de Desempenho e Benchmarks
calamine oferece desempenho excepcional, processando 41 milhões de células em menos de 25 segundos—superando bibliotecas Python, C# e Go em até 9,4x. Seu design zero‑copy e alocações mínimas no heap reduzem significativamente o uso de CPU e memória. Benchmarks em um arquivo XLSX de 186 MB mostram o calamine usando apenas 186 MB de leituras de disco, em comparação com 1,5 GB do excelize. O comportamento determinístico de memória da biblioteca e a baixa pressão de GC a tornam adequada para aplicações em tempo real e sensíveis à latência. Os desenvolvedores se beneficiam de uso previsível de recursos e taxa de transferência consistente em cargas de trabalho diversas.
