
rust_xlsxwriter
Biblioteca Rust de código abierto para archivos Excel XLSX
Genera archivos Excel 2007+ XLSX con formato completo, gráficos, fórmulas e imágenes mediante la API Rust.
¿Qué es rust_xlsxwriter?
rust_xlsxwriter es una crate de Rust de alto rendimiento y puro para generar archivos Excel XLSX sin requerir Excel ni dependencias externas. Permite a los desarrolladores crear hojas de cálculo de forma programática con texto, números, fechas, fórmulas, gráficos, imágenes, celdas fusionadas, formato condicional, validación de datos y más. Diseñada para la fiabilidad y la velocidad, coincide estrechamente con el formato nativo de Excel y admite el modo de memoria constante para grandes conjuntos de datos. La biblioteca es una reescritura fiel en Rust de la popular biblioteca Python XlsxWriter, con API idiomáticas y documentación completa.
rust_xlsxwriter se centra exclusivamente en escribir archivos Excel—sin lectura ni modificación de archivos existentes. Soporta características modernas de Excel como matrices dinámicas, sparklines, casillas de verificación, cuadros de texto, tablas, autofiltros, nombres definidos y temas de libro. Con funciones opcionales como serialización Serde, soporte de fechas chrono/jiff e integración con Polars, se adapta a diversos ecosistemas Rust. Su rendimiento es solo superado por la versión en C, ofreciendo una ejecución 3.8× más rápida que XlsxWriter de Python. Para obtener más detalles, consulte el repositorio de rust_xlsxwriter en GitHub.
Comenzando con rust_xlsxwriter
rust_xlsxwriter está disponible en crates.io y se puede instalar mediante `cargo add rust_xlsxwriter`. Para una funcionalidad mejorada, habilite características opcionales como `constant_memory`, `chrono`, `serde` o `polars`. La biblioteca requiere Rust 1.56+ y se compila en binarios nativos sin dependencias externas de tiempo de ejecución más allá del crate `zip` (por defecto). Está totalmente documentada con una guía de usuario, tutorial y recetario. Para ejemplos detallados y código fuente, visite el repositorio de rust_xlsxwriter en GitHub.
Instalar rust_xlsxwriter vía Cargo
cargo add rust_xlsxwriterEscribir celdas con formato con texto, números y fechas
rust_xlsxwriter proporciona una API simple e intuitiva para escribir contenido formateado en celdas de Excel. Los desarrolladores pueden aplicar formatos personalizados para números, fechas, fuentes, bordes, alineación y colores usando la estructura `Format`. La biblioteca admite escribir texto plano, valores numéricos, fechas, fórmulas y URL con formato opcional. También admite cadenas de formato múltiple enriquecidas para formato mixto dentro de una sola celda. Esto lo hace ideal para generar informes, paneles de control y exportaciones de datos donde la claridad visual y la estructura son esenciales. La API garantiza una alta fidelidad con el motor de formato nativo de Excel.
¿Cómo escribir texto, números y fechas con formato mediante 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")?;Crear gráficos, sparklines e imágenes
rust_xlsxwriter admite la generación de gráficos profesionales, sparklines e inserción de imágenes directamente en archivos de Excel. Los desarrolladores pueden crear gráficos de barras, líneas, pastel, dispersión y de áreas con ejes, leyendas y series de datos personalizables. Los sparklines proporcionan visualización compacta de tendencias dentro de las celdas. Las imágenes (PNG, JPEG, GIF, BMP) pueden insertarse y posicionarse con opciones de escalado y anclaje. Estos elementos visuales mejoran la narración de datos y las capacidades de generación de informes. La biblioteca garantiza la compatibilidad con Excel 2007+ y preserva la fidelidad de renderizado en todas las plataformas.
¿Cómo agregar un gráfico e imagen a Excel mediante 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")?;Formato avanzado: celdas combinadas, tablas y formato condicional
rust_xlsxwriter permite funciones avanzadas de formato en Excel, como rangos combinados, tablas estructuradas, autofiltros y reglas de formato condicional. Los desarrolladores pueden combinar celdas para encabezados o etiquetas, aplicar estilos de tabla con filas/columnas con bandas y definir filtros para la interactividad del usuario. El formato condicional admite escalas de color, barras de datos, conjuntos de iconos y fórmulas personalizadas para resaltar tendencias o anomalías. Estas funciones mejoran la legibilidad de los datos y la interactividad en los libros de trabajo generados. La API abstrae estructuras XML complejas en métodos intuitivos de Rust, garantizando mantenibilidad y seguridad de tipos.
¿Cómo fusionar celdas y agregar tablas con formato 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")?;Optimización de rendimiento y soporte para archivos grandes
rust_xlsxwriter está optimizado para la velocidad y la eficiencia de memoria, especialmente para conjuntos de datos grandes. Soporta el modo de memoria constante (`constant_memory` característica), que escribe los datos de forma incremental en disco, minimizando el uso del heap. Este modo es ideal para generar archivos Excel de varios megabytes sin errores OOM. Las pruebas de rendimiento muestran que funciona ~3.8× más rápido que XlsxWriter de Python y solo ~14% más lento que la biblioteca nativa en C. Características opcionales como `zmij` y `zlib` aceleran aún más la escritura numérica y la compresión. Estas capacidades lo hacen adecuado para la generación de informes por lotes, pipelines ETL y generación de Excel del lado del servidor.
¿Cómo habilitar el modo de memoria constante para archivos grandes?
cargo add rust_xlsxwriter -F constant_memoryuse 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")?;