xlsxwriter-rs

 
 

Бібліотека Rust для генерації Excel XLSX

Створюйте повністю сумісні файли Excel XLSX з форматуванням, об’єднаними клітинками, автопідфільтрами та зображеннями за допомогою Rust API.

Що таке 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")?;
 Українська