
umya-spreadsheet
Biblioteca de Rust puro para archivos XLSX/XLSM
Leer, escribir, dar estilo y manipular hojas de cálculo XLSX/XLSM sin dependencias externas.
¿Qué es umya-spreadsheet?
umya-spreadsheet es una biblioteca de Rust puro, de alto rendimiento, para leer y escribir archivos de hoja de cálculo Excel en formatos XLSX y XLSM. Diseñada para la seguridad y la eficiencia, evita código inseguro y dependencias externas, lo que la hace ideal para aplicaciones de escritorio, procesamiento del lado del servidor y entornos WebAssembly. La biblioteca ofrece una API de Rust limpia e idiomática para acceder a celdas, filas, columnas, estilos, gráficos e imágenes, permitiendo a los desarrolladores crear herramientas de hoja de cálculo robustas sin depender de Microsoft Office o de la interoperabilidad COM.
Con soporte completo para carga diferida, protección con contraseña y formato avanzado, umya-spreadsheet cierra la brecha entre rendimiento y usabilidad. Soporta exportación a CSV, generación de gráficos, incrustación de imágenes y operaciones de rango como mover y copiar. El proyecto se mantiene activamente, está bien documentado y probado, con un enfoque en la corrección y la compatibilidad con las funciones modernas de Excel. Los desarrolladores pueden integrarlo en herramientas CLI, backends web o aplicaciones de escritorio usando frameworks como Tauri o Axo.
Comenzando con umya-spreadsheet
Para comenzar a usar umya-spreadsheet, agréguelo a su Cargo.toml con `umya-spreadsheet = "3.1.1"`. Para soporte WebAssembly, habilite la característica `js`. La biblioteca es ligera en dependencias y compila rápidamente. Una vez instalado, impórtelo mediante `extern crate umya_spreadsheet;` y comience a leer o escribir hojas de cálculo. También puede explorar el GitHub de umya-spreadsheet para ejemplos, pruebas y documentación. Soporta carga diferida para archivos grandes y ofrece un manejo de errores robusto.
Instalar umya-spreadsheet vía Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Leer y escribir archivos XLSX/XLSM
umya-spreadsheet proporciona APIs intuitivas para leer y escribir archivos XLSX y XLMS. Use `reader::xlsx::read()` para cargar un libro de trabajo desde el disco, o `new_file()` para crear uno en blanco. Escribir es igualmente simple: llame a `writer::xlsx::write()` con el libro de trabajo y la ruta de destino. La biblioteca admite carga diferida mediante `lazy_read()` para mejorar el rendimiento en archivos grandes, y permite escritura protegida con contraseña o establecer contraseñas después de la creación. Todas las operaciones son seguras, sin copias cuando sea posible, y evitan binarios externos.
¿Cómo leer y escribir un archivo XLSX mediante 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();
Acceso a celdas y manipulación de estilo
Acceder y modificar los valores de las celdas es sencillo: use `cell("A1")` o `cell((1,1))` para leer, y `cell_mut()` para escribir. Los estilos se gestionan mediante `style_mut()`, lo que permite cambiar el color de fondo, la fuente, los bordes y la alineación. La biblioteca expone un conjunto amplio de propiedades de estilo mientras mantiene garantías de inmutabilidad cuando sea posible. También puede obtener valores formateados, aplicar lógica condicional y actualizar estilos en lote a través de rangos. Esto lo hace ideal para generar informes, paneles de control o exportaciones de datos con un formato coherente.
¿Cómo modificar el valor y el estilo de una celda mediante 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);
Soporte de gráficos e imágenes
umya-spreadsheet admite la creación y edición de gráficos—incluidos gráficos de líneas, de barras y de áreas—definiendo rangos de series y marcadores. Puedes incrustar imágenes directamente en las hojas usando la estructura `Image`, con soporte para PNG y otros formatos según las funciones habilitadas. Los gráficos y las imágenes se integran sin problemas con las coordenadas de celdas y las capas de dibujo, lo que permite la generación dinámica de paneles. Aunque algunas funciones de dibujo avanzadas aún están evolucionando, la funcionalidad principal está lista para producción y es extensible.
¿Cómo agregar un gráfico de líneas a una hoja de cálculo mediante 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);
Operaciones de rango y protección con contraseña
Realiza operaciones avanzadas como mover, copiar y redimensionar rangos usando `move_range()`, lo que permite la reorganización dinámica de datos. La biblioteca también admite libros de trabajo protegidos con contraseña: escribe archivos con `write_with_password()` o aplica contraseñas a archivos existentes mediante `set_password()`. Estas funciones son críticas para el manejo seguro de datos en aplicaciones empresariales o sensibles a cumplimiento. Combinado con un diseño sin dependencias y compatibilidad WASM, umya-spreadsheet ofrece tanto flexibilidad como seguridad.
¿Cómo mover un rango y proteger un archivo con contraseña mediante 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();
