
rust_xlsxwriter
Бібліотека Rust з відкритим кодом для Excel XLSX файлів
Генеруйте Excel 2007+ XLSX файли з повним форматуванням, діаграмами, формулами та зображеннями за допомогою Rust API.
Що таке rust_xlsxwriter?
rust_xlsxwriter — це високопродуктивний, чистий Rust‑crate для створення файлів Excel XLSX без потреби у Excel або зовнішніх залежностях. Він дозволяє розробникам програмно створювати електронні таблиці з текстом, числами, датами, формулами, діаграмами, зображеннями, об’єднаними клітинками, умовним форматуванням, перевіркою даних та іншим. Розроблений для надійності та швидкості, він точно відповідає рідному формату файлів Excel і підтримує режим постійної пам’яті для великих наборів даних. Бібліотека є вірним Rust‑переписом популярної Python‑бібліотеки XlsxWriter, з ідіоматичними API та всебічною документацією.
rust_xlsxwriter зосереджений виключно на записі файлів Excel — без читання чи модифікації існуючих файлів. Він підтримує сучасні функції Excel, такі як динамічні масиви, спарклайни, прапорці, текстові поля, таблиці, автфільтри, визначені імена та теми книги. Завдяки додатковим можливостям, таким як серіалізація Serde, підтримка дат chrono/jiff та інтеграція з Polars, він адаптується до різноманітних екосистем Rust. Його продуктивність є другою після C‑версії, забезпечуючи виконання в 3,8× швидше, ніж XlsxWriter для Python. Для повних деталей перегляньте репозиторій rust_xlsxwriter на GitHub.
Початок роботи з rust_xlsxwriter
rust_xlsxwriter доступний на crates.io і його можна встановити за допомогою `cargo add rust_xlsxwriter`. Для розширеної функціональності увімкніть необов’язкові можливості, такі як `constant_memory`, `chrono`, `serde` або `polars`. Бібліотека вимагає Rust 1.56+ і компілюється у нативні бінарники без зовнішніх залежностей виконання, окрім крейту `zip` (за замовчуванням). Вона повністю задокументована за допомогою посібника користувача, підручника та збірника рецептів. Для докладних прикладів і вихідного коду відвідайте репозиторій rust_xlsxwriter на GitHub.
Встановлення rust_xlsxwriter через Cargo
cargo add rust_xlsxwriterЗапис форматованих клітинок з текстом, числами та датами
rust_xlsxwriter надає простий і інтуїтивний API для запису форматованого вмісту у клітинки Excel. Розробники можуть застосовувати власні формати для чисел, дат, шрифтів, меж, вирівнювання та кольорів за допомогою структури `Format`. Бібліотека підтримує запис простого тексту, числових значень, дат, формул і URL‑адрес з необов’язковим форматуванням. Вона також підтримує багатоформатні рядки для змішаного форматування в одній клітинці. Це робить її ідеальною для створення звітів, панелей інструментів та експорту даних, де важливі візуальна чіткість і структура. API забезпечує високу точність відповідності нативному механізму форматування Excel.
Як записувати форматований текст, числа та дати за допомогою 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")?;Створення діаграм, спарклайнів та зображень
rust_xlsxwriter підтримує створення професійних діаграм, спарклайнів та вбудовування зображень безпосередньо у файли Excel. Розробники можуть створювати стовпчикові, лінійні, кругові, точкові та площинні діаграми з налаштовуваними осями, легендами та серіями даних. Спарклайни забезпечують компактну візуалізацію тенденцій у клітинках. Зображення (PNG, JPEG, GIF, BMP) можна вставляти та розташовувати з параметрами масштабування та прив’язки. Ці візуальні елементи підвищують розповідь даних та можливості звітування. Бібліотека забезпечує сумісність з Excel 2007+ та зберігає точність відтворення на різних платформах.
Як додати діаграму та зображення до Excel за допомогою 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")?;Розширене форматування: об’єднані клітинки, таблиці та умовне форматування
rust_xlsxwriter надає розширені можливості форматування Excel, такі як об’єднані діапазони, структуровані таблиці, автфільтри та правила умовного форматування. Розробники можуть об’єднувати клітинки для заголовків або міток, застосовувати стилі таблиць з чергуванням рядків/стовпців та визначати фільтри для взаємодії користувачів. Умовне форматування підтримує кольорові шкали, смуги даних, набори іконок та власні формули для виділення тенденцій або аномалій. Ці функції покращують читабельність даних та інтерактивність у згенерованих робочих книгах. API абстрагує складні XML‑структури в інтуїтивні методи Rust, забезпечуючи підтримуваність та типову безпеку.
Як об’єднати клітинки та додати таблиці з умовним форматуванням?
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")?;Оптимізація продуктивності та підтримка великих файлів
rust_xlsxwriter оптимізовано для швидкості та ефективності використання пам’яті, особливо для великих наборів даних. Він підтримує режим постійної пам’яті (`constant_memory` feature), який записує дані поступово на диск, мінімізуючи використання heap. Цей режим ідеальний для створення багатомегабайтових Excel‑файлів без помилок OOM. Бенчмарки показують, що він працює приблизно ~3.8× швидше, ніж Python’s XlsxWriter і лише ~14% повільніше, ніж рідна бібліотека на C. Додаткові функції, такі як `zmij` і `zlib`, ще більше прискорюють запис чисел та стиснення. Ці можливості роблять його придатним для пакетної звітності, ETL‑конвеєрів та серверного генерування Excel.
Як увімкнути режим постійної пам’яті для великих файлів?
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")?;