
xlsxwriter-rs
Biblioteca Rust para geração de Excel XLSX
Crie arquivos Excel XLSX totalmente compatíveis com formatação, células mescladas, autofiltros e imagens via API Rust.
O que é xlsxwriter-rs?
xlsxwriter-rs é uma ligação de alto desempenho para Rust da amplamente utilizada biblioteca C libxlsxwriter, permitindo que desenvolvedores gerem arquivos Excel XLSX totalmente compatíveis diretamente a partir de aplicações Rust. Ela suporta formatação abrangente do Excel, incluindo fontes, cores, alinhamento, bordas e formatos numéricos, bem como recursos avançados como células mescladas, autofiltros, validação de dados e imagens PNG/JPEG incorporadas. Projetado para confiabilidade e velocidade, o xlsxwriter-rs é ideal para geração de relatórios no lado do servidor, pipelines de exportação de dados e qualquer cenário que exija a criação programática de arquivos Excel em Rust.
A biblioteca aproveita a segurança de memória e as abstrações de custo zero do Rust para fornecer uma API segura e eficiente para geração de Excel sem exigir Microsoft Excel ou dependências externas como COM. Ela se integra perfeitamente ao Cargo e suporta flags de recursos opcionais para personalizar o comportamento, como desativar somas de verificação MD5 ou usar o zlib do sistema. Com sua interface Rust limpa e idiomática e documentação abrangente, xlsxwriter-rs capacita desenvolvedores a criar ferramentas robustas e multiplataforma de geração de Excel, mantendo controle total sobre a estrutura e o conteúdo dos arquivos.
Começando com xlsxwriter-rs
Para começar a usar o xlsxwriter-rs, adicione‑o ao seu Cargo.toml via cargo add xlsxwriter ou inclua manualmente [dependencies] com xlsxwriter = "0.1". A biblioteca requer LLVM e Clang para a compilação do bindgen. No Windows, instale o Visual Studio e o LLVM, então defina LIBCLANG_PATH para o diretório bin do LLVM. Após a configuração, clone o repositório, execute git submodule update --init --recursive para obter a biblioteca C e compile os exemplos com cargo run --example hello_spreadsheet. A documentação completa e os exemplos estão disponíveis no GitHub do xlsxwriter-rs.
Instale xlsxwriter-rs via Cargo
cargo add xlsxwriterSuporte total à formatação do Excel
xlsxwriter-rs oferece recursos abrangentes de formatação, permitindo que os desenvolvedores personalizem fontes, cores, bordas, alinhamento e formatos numéricos para células individuais ou intervalos. Você pode aplicar negrito, itálico, sublinhado, tamanho da fonte e cores personalizadas ao texto, definir cores de preenchimento de fundo, definir bordas de célula com vários estilos (fina, média, espessa) e controlar o alinhamento horizontal/vertical. Esse nível de controle garante que os arquivos Excel gerados correspondam aos padrões profissionais de relatórios. A formatação é aplicada usando a estrutura Format, que suporta encadeamento de métodos para configuração intuitiva. Esse recurso é essencial para criar relatórios visualmente distintos, dashboards e exportações de dados que melhoram a legibilidade e a experiência do usuário.
Aplicar cor da fonte e alinhamento às células
let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
0, 0,
"Red text",
Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
2, 0,
"Centered green text",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;Células mescladas e intervalos
A biblioteca suporta a mesclagem de intervalos retangulares de células, o que é fundamental para criar cabeçalhos, títulos e seções de dados agrupados em relatórios do Excel. Usando o método merge_range, você pode abranger várias linhas e colunas enquanto aplica formatação a todo o bloco mesclado. Isso garante estilo e layout consistentes em planilhas complexas. Células mescladas são totalmente compatíveis com o mecanismo de renderização do Excel e preservam formatações como alinhamento de texto, bordas e cores de fundo. Esse recurso é especialmente útil para demonstrações financeiras, painéis e formulários onde o agrupamento visual melhora a compreensão dos dados e a qualidade da apresentação.
Mesclar um intervalo com formatação personalizada
sheet1.merge_range(
2, 0,
3, 2,
"Hello, world",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;Auto-filtros e validação de dados
xlsxwriter-rs permite a criação programática de autofiltros e regras de validação de dados, permitindo que os usuários classifiquem, filtrem e validem dados diretamente no Excel. Você pode aplicar um autofiltro a um intervalo de células usando set_autofilter, e definir listas suspensas para entrada do usuário via validação de dados. Isso suporta validação baseada em lista, intervalos numéricos, datas e fórmulas personalizadas. Esses recursos aumentam a interatividade e a integridade dos dados em planilhas, tornando-as adequadas para formulários, modelos e entrada de dados colaborativa. Os arquivos XLSX gerados mantêm funcionalidade completa ao serem abertos no Excel, LibreOffice ou Google Sheets, garantindo ampla compatibilidade.
Aplicar autofiltro e validação de dados
// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;
// Add data validation (drop-down list) in B2
sheet1.data_validation(
"B2",
DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;Incorporar imagens e hyperlinks
Você pode incorporar imagens PNG e JPEG diretamente nas planilhas do Excel usando xlsxwriter-rs, com suporte a posicionamento, dimensionamento e escalonamento. Isso é ideal para adicionar logotipos, gráficos ou indicadores visuais aos relatórios. Além disso, a biblioteca suporta hyperlinks e URLs com formatação personalizável (por exemplo, texto azul e sublinhados), permitindo links clicáveis para sites, documentos ou outras planilhas. Esses recursos tornam o xlsxwriter-rs adequado para criar relatórios e dashboards ricos e interativos que combinam dados, elementos visuais e navegação. Todo o conteúdo incorporado é totalmente compatível com o mecanismo de renderização do Excel e preserva a integridade do layout em todas as plataformas.
Escrever URL e incorporar imagem
// Write a clickable URL
sheet1.write_url(
1, 1,
"https://github.com/informationsea/xlsxwriter-rs",
Some(&Format::new()
.set_font_color(FormatColor::Blue)
.set_underline(FormatUnderline::Single)
)
)?;
// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;