
umya-spreadsheet
Biblioteca Rust Pura para Arquivos XLSX/XLSM
Leia, Grave, Estilize e Manipule Planilhas XLSX/XLSM sem Dependências Externas.
O que é umya-spreadsheet?
umya-spreadsheet é uma biblioteca Rust pura e de alto desempenho para leitura e escrita de arquivos de planilha Excel nos formatos XLSX e XLSM. Projetada para segurança e eficiência, evita código inseguro e dependências externas, tornando-a ideal para aplicações desktop, processamento no lado do servidor e ambientes WebAssembly. A biblioteca oferece uma API Rust limpa e idiomática para acessar células, linhas, colunas, estilos, gráficos e imagens, permitindo que desenvolvedores criem ferramentas de planilha robustas sem depender do Microsoft Office ou de interop COM.
Com suporte total a carregamento preguiçoso, proteção por senha e formatação avançada, o umya-spreadsheet preenche a lacuna entre desempenho e usabilidade. Ele suporta exportação CSV, geração de gráficos, incorporação de imagens e operações de intervalo como mover e copiar. O projeto é mantido ativamente, bem documentado e testado, com foco na correção e compatibilidade com recursos modernos do Excel. Desenvolvedores podem integrá-lo em ferramentas de linha de comando, back‑ends web ou aplicativos desktop usando frameworks como Tauri ou Axo.
Começando com umya-spreadsheet
Para começar a usar o umya-spreadsheet, adicione-o ao seu Cargo.toml com `umya-spreadsheet = "3.1.1"`. Para suporte a WebAssembly, habilite o recurso `js`. A biblioteca tem poucas dependências e compila rapidamente. Depois de instalado, importe-o via `extern crate umya_spreadsheet;` e comece a ler ou escrever planilhas. Você também pode explorar o GitHub do umya-spreadsheet para exemplos, testes e documentação. Ele suporta carregamento preguiçoso para arquivos grandes e oferece tratamento de erros robusto.
Instale umya-spreadsheet via Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Ler e Gravar Arquivos XLSX/XLSM
umya-spreadsheet fornece APIs intuitivas para leitura e gravação de arquivos XLSX e XLMS. Use `reader::xlsx::read()` para carregar uma pasta de trabalho do disco, ou `new_file()` para criar uma em branco. A gravação é igualmente simples: chame `writer::xlsx::write()` com a pasta de trabalho e o caminho de destino. A biblioteca suporta carregamento preguiçoso via `lazy_read()` para melhorar o desempenho em arquivos grandes, e permite gravação protegida por senha ou definição de senhas após a criação. Todas as operações são seguras, zero-copy quando possível, e evitam binários externos.
Como Ler e Gravar um Arquivo XLSX via Rust?
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();
Acesso a Células e Manipulação de Estilos
Acessar e modificar valores de células é simples: use `cell("A1")` ou `cell((1,1))` para leitura, e `cell_mut()` para gravação. Estilos são gerenciados via `style_mut()`, permitindo alterações de cor de fundo, fonte, bordas e alinhamento. A biblioteca expõe um conjunto rico de propriedades de estilo enquanto mantém garantias de imutabilidade quando possível. Você também pode recuperar valores formatados, aplicar lógica condicional e atualizar estilos em lote em intervalos. Isso a torna ideal para gerar relatórios, painéis ou exportações de dados com formatação consistente.
Como modificar o valor e o estilo de uma célula via 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);
Suporte a Gráficos e Imagens
umya-spreadsheet suporta a criação e edição de gráficos—incluindo gráficos de linha, barra e área—definindo intervalos de séries e marcadores. Você pode incorporar imagens diretamente nas planilhas usando a estrutura `Image`, com suporte a PNG e outros formatos dependendo dos recursos habilitados. Gráficos e imagens se integram perfeitamente com coordenadas de células e camadas de desenho, permitindo a geração dinâmica de dashboards. Embora alguns recursos avançados de desenho ainda estejam evoluindo, a funcionalidade central está pronta para produção e é extensível.
Como adicionar um gráfico de linhas a uma planilha via 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);
Operações de Intervalo e Proteção por Senha
Execute operações avançadas como mover, copiar e redimensionar intervalos usando `move_range()`, permitindo a reorganização dinâmica de dados. A biblioteca também suporta pastas de trabalho protegidas por senha: escreva arquivos com `write_with_password()` ou aplique senhas a arquivos existentes via `set_password()`. Esses recursos são críticos para o manuseio seguro de dados em aplicações empresariais ou sensíveis a conformidade. Combinado com um design sem dependências e compatibilidade WASM, o umya-spreadsheet oferece tanto flexibilidade quanto segurança.
Como mover um intervalo e proteger um arquivo com senha via 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();
