xlsxwriter-rs

 
 

Rust библиотека за генериране на Excel XLSX

Създайте напълно съвместими Excel XLSX файлове с форматиране, слети клетки, автоматични филтри и изображения чрез Rust API.

Какво е xlsxwriter-rs?

xlsxwriter-rs е високопроизводителна Rust обвивка за широко използваната C библиотека libxlsxwriter, позволяваща на разработчиците да генерират напълно съвместими 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 позволява програменo създаване на автоматични филтри и правила за валидиране на данни, като дава възможност на потребителите да сортират, филтрират и валидират данни директно в 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")?;
 Български