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, сохраняя полный контроль над структурой и содержимым файлов.

Previous Next

Начало работы с 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")?;
 Русский