1. Produtos
  2.   Planilha
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

Biblioteca Rust de código aberto para arquivos Excel XLSX

Gere arquivos Excel 2007+ XLSX com formatação completa, gráficos, fórmulas e imagens via API Rust.

O que é rust_xlsxwriter?

rust_xlsxwriter é um crate de alto desempenho e puro Rust para gerar arquivos Excel XLSX sem exigir o Excel ou dependências externas. Ele permite que desenvolvedores criem planilhas programaticamente com texto, números, datas, fórmulas, gráficos, imagens, células mescladas, formatação condicional, validação de dados e muito mais. Projetado para confiabilidade e velocidade, ele corresponde de perto ao formato de arquivo nativo do Excel e suporta o modo de memória constante para grandes conjuntos de dados. A biblioteca é uma reescrita fiel em Rust da popular biblioteca Python XlsxWriter, com APIs idiomáticas e documentação abrangente.

rust_xlsxwriter foca exclusivamente na escrita de arquivos Excel — sem leitura ou modificação de arquivos existentes. Ele suporta recursos modernos do Excel como arrays dinâmicos, sparklines, caixas de seleção, caixas de texto, tabelas, autofiltros, nomes definidos e temas de pasta de trabalho. Com recursos opcionais como serialização Serde, suporte a datas chrono/jiff e integração com Polars, ele se adapta a diversos ecossistemas Rust. Seu desempenho fica atrás apenas da versão em C, oferecendo execução 3.8× mais rápida que o XlsxWriter do Python. Para detalhes completos, veja o repositório rust_xlsxwriter no GitHub.

Previous Next

Começando com rust_xlsxwriter

rust_xlsxwriter está disponível no crates.io e pode ser instalado via `cargo add rust_xlsxwriter`. Para funcionalidade aprimorada, habilite recursos opcionais como `constant_memory`, `chrono`, `serde` ou `polars`. A biblioteca requer Rust 1.56+ e compila para binários nativos sem dependências externas de tempo de execução além da crate `zip` (por padrão). Está totalmente documentada com um guia do usuário, tutorial e cookbook. Para exemplos detalhados e código‑fonte, visite o repositório rust_xlsxwriter no GitHub.

Instale rust_xlsxwriter via Cargo

cargo add rust_xlsxwriter

Escreva Células Formatadas com Texto, Números e Datas

rust_xlsxwriter fornece uma API simples e intuitiva para escrever conteúdo formatado em células do Excel. Os desenvolvedores podem aplicar formatos personalizados para números, datas, fontes, bordas, alinhamento e cores usando a estrutura `Format`. A biblioteca suporta a escrita de texto simples, valores numéricos, datas, fórmulas e URLs com formatação opcional. Também suporta strings ricas de múltiplos formatos para formatação mista dentro de uma única célula. Isso a torna ideal para gerar relatórios, painéis e exportações de dados onde a clareza visual e a estrutura são essenciais. A API garante alta fidelidade com o mecanismo de formatação nativo do Excel.

Como Escrever Texto, Números e Datas Formatados via Rust?

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

let bold = Format::new().set_bold();
let decimal = Format::new().set_num_format("0.00");
let date_fmt = Format::new().set_num_format("yyyy-mm-dd");

worksheet.write_with_format(0, 0, "Hello", &bold)?;
worksheet.write(1, 0, 123.456)?;
worksheet.write_with_format(2, 0, 789.012, &decimal)?;
let date = ExcelDateTime::from_ymd(2023, 12, 25)?;
worksheet.write_with_format(3, 0, &date, &date_fmt)?;
workbook.save("formatted.xlsx")?;

Crie Gráficos, Sparklines e Imagens

rust_xlsxwriter suporta a geração de gráficos profissionais, sparklines e a incorporação de imagens diretamente em arquivos Excel. Os desenvolvedores podem criar gráficos de barras, linhas, pizza, dispersão e área com eixos, legendas e séries de dados personalizáveis. Sparklines fornecem visualização compacta de tendências dentro das células. Imagens (PNG, JPEG, GIF, BMP) podem ser inseridas e posicionadas com opções de dimensionamento e ancoragem. Esses elementos visuais aprimoram a narrativa de dados e as capacidades de relatórios. A biblioteca garante compatibilidade com Excel 2007+ e preserva a fidelidade de renderização em diferentes plataformas.

Como adicionar um gráfico e uma imagem ao Excel via Rust?

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

// Write sample data
for i in 0..5 {
    worksheet.write_number(i, 0, (i + 1) as f64 * 10.0)?;
}

// Create a chart
let mut chart = Chart::new(ChartType::Column);
chart.add_series().set_values("Sheet1!$A$1:$A$5");
worksheet.insert_chart(0, 2, &chart)?;

// Insert an image
let image = Image::new("logo.png")?;
worksheet.insert_image(5, 2, &image)?;

workbook.save("chart_image.xlsx")?;

Formatação Avançada: Células Mescladas, Tabelas e Formatação Condicional

rust_xlsxwriter permite recursos avançados de formatação do Excel, como intervalos mesclados, tabelas estruturadas, autofiltros e regras de formatação condicional. Os desenvolvedores podem mesclar células para cabeçalhos ou rótulos, aplicar estilos de tabela com linhas/colunas em faixas e definir filtros para interatividade do usuário. A formatação condicional suporta escalas de cores, barras de dados, conjuntos de ícones e fórmulas personalizadas para destacar tendências ou anomalias. Esses recursos melhoram a legibilidade dos dados e a interatividade nas pastas de trabalho geradas. A API abstrai estruturas XML complexas em métodos Rust intuitivos, garantindo manutenibilidade e segurança de tipos.

Como mesclar células e adicionar tabelas com formatação condicional?

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

// Merge cells
let merge_fmt = Format::new()
    .set_border(FormatBorder::Thin)
    .set_align(FormatAlign::Center);
worksheet.merge_range(0, 0, 0, 2, "Report Header", &merge_fmt)?;

// Add table
worksheet.add_table(1, 0, 5, 2, Table::new().set_columns(&[
    ("Item", None),
    ("Value", None),
    ("Status", None),
]))?;

// Conditional formatting
worksheet.conditional_format(
    2, 0, 5, 2,
    ConditionalFormat::new()
        .set_type(ConditionalFormatType::Cell)
        .set_format(&Format::new().set_bg_color("#D8E4BC"))
        .set_formula("=A2>100")
)?;

workbook.save("advanced.xlsx")?;

Otimização de Desempenho e Suporte a Arquivos Grandes

rust_xlsxwriter é otimizado para velocidade e eficiência de memória, especialmente para grandes conjuntos de dados. Ele suporta o modo de memória constante (`constant_memory` feature), que grava os dados incrementalmente no disco, minimizando o uso de heap. Esse modo é ideal para gerar arquivos Excel de vários megabytes sem erros de OOM. Benchmarks mostram que ele roda ~3.8× mais rápido que o XlsxWriter de Python e apenas ~14% mais lento que a biblioteca nativa em C. Recursos opcionais como `zmij` e `zlib` aceleram ainda mais gravações numéricas e compressão. Essas capacidades o tornam adequado para relatórios em lote, pipelines ETL e geração de Excel no lado do servidor.

Como habilitar o modo de memória constante para arquivos grandes?

cargo add rust_xlsxwriter -F constant_memory
use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
workbook.set_constant_memory(true); // Enable constant memory mode

let worksheet = workbook.add_worksheet();
for i in 0..100_000 {
    worksheet.write_number(i, 0, i as f64)?;
}

workbook.save("large_file.xlsx")?;
 Português