office-toolkit

A pure-Rust library to create, read, and modify Microsoft Office documents in the modern Open XML format (.docx, .xlsx, .pptx).

This is the facade crate: the single entry point most consumers should depend on. It re-exports word-ooxml, excel-ooxml, and powerpoint-ooxml (each behind its own same-named Cargo feature, all three enabled by default) plus the drawing/chart crates shared across all three formats, and adds filesystem convenience (open, OpenFile, SaveToFile) on top of them.

Status: active development. Word, Excel, and PowerPoint are functional today through this crate.

Usage

[dependencies]
office-toolkit = "1.0"

use office_toolkit::prelude::*;
use office_toolkit::SaveToFile;

// `Document`/`Paragraph` come straight from the prelude; `save_to_file`
// needs its own `SaveToFile` trait imported, like any trait method.
let document = Document::new().with_paragraph(Paragraph::with_text("Hello, world!"));
document.save_to_file("hello.docx")?;

// Open any .docx/.xlsx/.pptx without knowing its format ahead of time.
let opened = office_toolkit::open("hello.docx")?;
# Ok::<(), office_toolkit::Error>(())

Only need one format? Opt out of the other two to trim the build:

office-toolkit = { version = "1.0", default-features = false, features = ["excel"] }

Documentation

For the full per-feature API reference (what to call for bold text, cell formatting, chart building, table styles, and everything else) and an explanation of how this crate's feature flags and prelude are put together, see the workspace docs — Architecture.md and API_Reference_docx.md/_xlsx.md/_pptx.md.

See the workspace README for the full project goals and crate layout.

License

Licensed under the MIT license.