genpdf-rs

A user-friendly PDF generator written in pure Rust.

genpdf is a high-level PDF generator built ontop of [printpdf][] and [rusttype][]. It takes care of the page layout and text alignment and renders a document tree into a PDF document. All of its dependencies are written in Rust, so you don’t need any pre-installed libraries or tools.

rust // Create a document and set the default font family let mut doc = genpdf::Document::new("./fonts", "Liberation") .expect("Failed to create PDF document"); // Change the default settings doc.set_margins(10); doc.set_title("Demo document"); // Add one or more elements doc.push(genpdf::elements::Paragraph::new("This is a demo document.")); // Render the document and write it to a file doc.render_to_file("output.pdf").expect("Failed to write PDF file");

For a complete example with all supported elements, see the [examples/demo.rs][] file that generates this PDF document.

For more information, see the API documentation.

Features

PDF generation in pure Rust
Text rendering with support for setting the font family, style and size as well as the text color and text effects (bold or italic)
Text wrapping at word boundaries
Layout of elements sequentially or in tables
Rudimentary support for shapes

Roadmap

These features are currently not supported but planned for future versions: - Improved support for drawing shapes - Images - Advanced text formatting - Hyphenation - Easier font lookup

Alternatives

[printpdf][] is the low-level PDF library used by genpdf. It provides more control over the generated document, but you have to take care of all details like calculating the width and height of the rendered text, arranging the elements and distributing them on multiple pages.
[latex][] generates LaTeX documents from Rust. It requires a LaTex installation to generate the PDF files. Also, escaping user input is a non-trivial problem and not supported by the crate.
[tectonic][] is a TeX engine based on XeTeX. It is partly written in C and has some non-Rust dependencies.
[wkhtmltopdf][] generates PDF documents from HTML using the wkhtmltox library. It requires a pre-installed library and does not support custom elements.

Minimum Supported Rust Version

This crate supports at least Rust 1.40.0 or later.

Contributing

Contributions to this project are welcome! Please submit patches to the mailing list ~ireas/public-inbox@lists.sr.ht (archive) using the [PATCH genpdf-rs] subject prefix. For more information, see the Contributing Guide.

Contact

For bug reports, feature requests and other messages, please send a mail to ~ireas/public-inbox@lists.sr.ht (archive) using the [genpdf-rs] prefix in the subject.

License

This project is dual-licensed under the Apache-2.0 and MIT licenses. The documentation and examples contained in this repository are licensed under the Creative Commons Zero license. You can find a copy of the license texts in the LICENSES directory.

genpdf-rs complies with version 3.0 of the REUSE specification.