Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/informationsea/xlsxwriter-rs
Excel file writer for Rust
https://github.com/informationsea/xlsxwriter-rs
libxlsxwriter rust spreadsheet xlsx xlsx-files xlsxwriter
Last synced: 21 days ago
JSON representation
Excel file writer for Rust
- Host: GitHub
- URL: https://github.com/informationsea/xlsxwriter-rs
- Owner: informationsea
- License: apache-2.0
- Created: 2019-11-16T15:03:31.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-18T20:00:08.000Z (6 months ago)
- Last Synced: 2024-12-29T12:16:58.441Z (about 1 month ago)
- Topics: libxlsxwriter, rust, spreadsheet, xlsx, xlsx-files, xlsxwriter
- Language: Rust
- Homepage: https://crates.io/crates/xlsxwriter
- Size: 292 KB
- Stars: 268
- Watchers: 8
- Forks: 47
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-list - informationsea/xlsxwriter-rs - rs?style=social"/> : Excel file writer for Rust. [crates.io/crates/xlsxwriter](https://crates.io/crates/xlsxwriter) (File Processing)
- awesome-rust-list - informationsea/xlsxwriter-rs - rs?style=social"/> : Excel file writer for Rust. [crates.io/crates/xlsxwriter](https://crates.io/crates/xlsxwriter) (File Processing)
README
xlsxwriter-rs
=============
[](https://github.com/informationsea/xlsxwriter-rs/actions)
[](https://crates.io/crates/xlsxwriter)
[](https://docs.rs/xlsxwriter)
Rust binding of [libxlsxwriter](https://github.com/jmcnamara/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](https://github.com/jmcnamara/libxlsxwriter/blob/dcf8d418dba726d2ee123fb111a3174e67b15f6b/docs/src/getting_started.dox#L639) to learn more).
* `use-openssl-md5`: Use OpenSSL implementation of md5 function. (See [upstream document](https://github.com/jmcnamara/libxlsxwriter/blob/dcf8d418dba726d2ee123fb111a3174e67b15f6b/docs/src/getting_started.dox#L629) 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](https://llvm.org/)
3. Set environment variable `LIBCLANG_PATH` as `C:\Program Files\LLVM\bin`
4. Run build
Example
-------
```rust
let workbook = Workbook::new("simple1.xlsx")?;
let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(0, 0, "Red text", Some(&Format::new().set_font_color(FormatColor::Red)))?;
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(&Format::new().set_font_color(FormatColor::Blue).set_underline(FormatUnderline::Single)),
)?;
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)))?;
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](https://rust-lang.github.io/rust-bindgen/requirements.html#clang) 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!