
xlsxwriter-rs
Библиотека Rust для генерации Excel XLSX
Создавайте полностью совместимые файлы Excel XLSX с форматированием, объединёнными ячейками, автофильтрами и изображениями через API Rust.
Что такое xlsxwriter-rs?
xlsxwriter-rs — это высокопроизводительная привязка Rust к широко используемой библиотеке libxlsxwriter на C, позволяющая разработчикам генерировать полностью совместимые файлы Excel XLSX непосредственно из приложений на Rust. Она поддерживает всестороннее форматирование Excel, включая шрифты, цвета, выравнивание, границы и числовые форматы, а также расширенные возможности, такие как объединённые ячейки, автофильтры, проверка данных и встраивание изображений PNG/JPEG. Разработанный с учётом надёжности и скорости, xlsxwriter-rs идеален для серверной генерации отчётов, конвейеров экспорта данных и любых сценариев, требующих программного создания файлов Excel в Rust.
Библиотека использует безопасность памяти Rust и абстракции без накладных расходов, чтобы предоставить безопасный и эффективный API для генерации Excel без необходимости установки Microsoft Excel или внешних зависимостей, таких как COM. Она бесшовно интегрируется с Cargo и поддерживает необязательные флаги функций для настройки поведения, например отключение контрольных сумм MD5 или использование системного zlib. Благодаря чистому, идиоматическому интерфейсу Rust и обширной документации, xlsxwriter-rs позволяет разработчикам создавать надёжные кроссплатформенные инструменты генерации Excel, сохраняя полный контроль над структурой и содержимым файлов.
Начало работы с xlsxwriter-rs
Чтобы начать использовать xlsxwriter-rs, добавьте его в ваш Cargo.toml через cargo add xlsxwriter или вручную включите [dependencies] с xlsxwriter = \"0.1\". Библиотека требует LLVM и Clang для компиляции bindgen. Для Windows установите Visual Studio и LLVM, затем задайте LIBCLANG_PATH в каталог bin LLVM. После настройки клонируйте репозиторий, выполните git submodule update --init --recursive, чтобы получить C-библиотеку, и соберите примеры с помощью cargo run --example hello_spreadsheet. Полная документация и примеры доступны на GitHub проекта xlsxwriter-rs.
Установите xlsxwriter-rs через Cargo
cargo add xlsxwriterПолная поддержка форматирования Excel
xlsxwriter-rs предоставляет комплексные возможности форматирования, позволяя разработчикам настраивать шрифты, цвета, границы, выравнивание и числовые форматы для отдельных ячеек или диапазонов. Вы можете применять полужирный, курсив, подчеркивание, размер шрифта и пользовательские цвета к тексту, задавать цвета заливки фона, определять границы ячеек с различными стилями (тонкая, средняя, толстая) и управлять горизонтальным/вертикальным выравниванием. Такой уровень контроля гарантирует, что сгенерированные файлы Excel соответствуют профессиональным стандартам отчетности. Форматирование применяется с использованием структуры Format, которая поддерживает цепочку вызовов методов для интуитивной настройки. Эта функция необходима для создания визуально различимых отчетов, панелей мониторинга и экспорта данных, улучшающих читаемость и пользовательский опыт.
Примените цвет шрифта и выравнивание к ячейкам
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)
)
)?;Объединённые ячейки и диапазоны
Библиотека поддерживает объединение прямоугольных диапазонов ячеек, что критически важно для создания заголовков, титулов и сгруппированных разделов данных в отчетах Excel. С помощью метода merge_range вы можете охватывать несколько строк и столбцов, одновременно применяя форматирование к всему объединённому блоку. Это обеспечивает единообразный стиль и макет в сложных электронных таблицах. Объединённые ячейки полностью совместимы с механизмом рендеринга Excel и сохраняют форматирование, такое как выравнивание текста, границы и фоновые цвета. Эта функция особенно полезна для финансовой отчётности, панелей мониторинга и форм, где визуальное группирование улучшает понимание данных и качество представления.
Объединить диапазон с пользовательским форматированием
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)
)
)?;Автофильтры и проверка данных
xlsxwriter-rs позволяет программно создавать автофильтры и правила проверки данных, позволяя пользователям сортировать, фильтровать и проверять данные непосредственно в Excel. Вы можете применить автофильтр к диапазону ячеек, используя set_autofilter, и определить выпадающие списки для ввода пользователем через проверку данных. Это поддерживает проверку на основе списков, числовые диапазоны, даты и пользовательские формулы. Эти функции повышают интерактивность и целостность данных в электронных таблицах, делая их подходящими для форм, шаблонов и совместного ввода данных. Сгенерированные файлы XLSX сохраняют полную функциональность при открытии в Excel, LibreOffice или Google Sheets, обеспечивая широкую совместимость.
Применить автофильтр и проверку данных
// 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"])
)?;Встраивание изображений и гиперссылок
Вы можете встраивать изображения PNG и JPEG непосредственно в листы Excel с помощью xlsxwriter-rs, поддерживая позиционирование, изменение размеров и масштабирование. Это идеально подходит для добавления логотипов, диаграмм или визуальных индикаторов в отчёты. Кроме того, библиотека поддерживает гиперссылки и URL с настраиваемым форматированием (например, синий текст и подчёркивание), позволяя создавать кликабельные ссылки на веб‑сайты, документы или другие листы. Эти возможности делают xlsxwriter-rs подходящей для создания насыщенных, интерактивных отчётов и панелей управления, которые объединяют данные, визуальные элементы и навигацию. Всё встроенное содержимое полностью совместимо с движком рендеринга Excel и сохраняет целостность макета на разных платформах.
Записать URL и встроить изображение
// 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")?;