#excel #xlsx #ffi

sys libxlsxwriter-sys

Rust binding of libxlsxwriter

7 releases (stable)

1.1.4 Aug 19, 2022
1.1.1 Jul 13, 2021
1.0.6 Jun 20, 2021
1.0.2 Apr 18, 2021
0.8.7 Nov 17, 2019

#342 in Cryptography

Download history 1786/week @ 2022-08-15 1818/week @ 2022-08-22 1861/week @ 2022-08-29 1829/week @ 2022-09-05 2047/week @ 2022-09-12 1678/week @ 2022-09-19 1879/week @ 2022-09-26 1620/week @ 2022-10-03 1189/week @ 2022-10-10 1482/week @ 2022-10-17 1984/week @ 2022-10-24 1905/week @ 2022-10-31 1926/week @ 2022-11-07 2148/week @ 2022-11-14 1808/week @ 2022-11-21 1723/week @ 2022-11-28

7,648 downloads per month
Used in 8 crates (via xlsxwriter)

MIT license

2MB
42K SLoC

C 41K SLoC // 0.2% comments Shell 425 SLoC // 0.2% comments Perl 235 SLoC // 0.2% comments Python 209 SLoC // 0.2% comments Rust 115 SLoC // 0.0% comments Automake 34 SLoC

xlsxwriter-rs

Build GitHub GitHub top language Crates.io Docs.rs

Rust binding of libxlsxwriter

Supported Features

  • 100% compatible Excel XLSX files.
  • Full Excel formatting.
  • Merged cells.
  • Autofilters.
  • Data validation and drop down lists.
  • Worksheet PNG/JPEG images.

Coming soon

  • Charts.

Feature Flags

  • no-md5: Disable image de-duplication and remove md5 function. (See upstream document to learn more).
  • use-openssl-md5: Use OpenSSL implementation of md5 function. (See upstream document to learn more).
  • system-zlib: Use system zlib instead of included zlib.

Build requirements

  • LLVM and clang

How to build on windows

  1. Install Visual Studio
  2. Install LLVM
  3. Set environment variable LIBCLANG_PATH as C:\Program Files\LLVM\bin
  4. Run build

Example

Result Image

let workbook = Workbook::new("target/simple1.xlsx");
let format1 = workbook.add_format().set_font_color(FormatColor::Red);

let format2 = workbook
    .add_format()
    .set_font_color(FormatColor::Blue)
    .set_underline(FormatUnderline::Single);

let format3 = workbook
    .add_format()
    .set_font_color(FormatColor::Green)
    .set_align(FormatAlignment::CenterAcross)
    .set_align(FormatAlignment::VerticalCenter);

let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(0, 0, "Red text", Some(&format1))?;
sheet1.write_number(0, 1, 20., None)?;
sheet1.write_formula_num(1, 0, "=10+B1", None, 30.)?;
sheet1.write_url(
    1,
    1,
    "https://github.com/informationsea/xlsxwriter-rs",
    Some(&format2),
)?;
sheet1.merge_range(2, 0, 3, 2, "Hello, world", Some(&format3))?;

sheet1.set_selection(1, 0, 1, 2);
sheet1.set_tab_color(FormatColor::Cyan);
workbook.close()?;

Run Example with Cargo

You can explore this example locally following the steps below:

  1. Install LLVM and set LIBCLANG_PATH if you are using windows. (see bindgen doc for details)
  2. clone or fork this repository
  3. git submodule update --init --recursive
    • The above command downloads the required C library so we can compile
  4. cargo run --example hello_spreadsheet

You should then see the example in target/simple1.xlsx. Enjoy!

No runtime deps