1. Produtos
  2.   Planilha
  3.   Rust
  4.   umya-spreadsheet

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.

Previous Next

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();
 Português