Pdfje

------------------

- 🐍 Official Python 3.12 compatibility

------------------

**Added**

- 🧮 Paragraphs can be optimally typeset using the Knuth-Plass line
breaking algorithm. Use the ``optimal`` argument for this.
- 🛟 Paragraphs support automatically avoiding orphaned lines with
``avoid_orphans`` argument.

**Breaking**

- 📊 In the rare case that a paragraphs contains different text sizes,
all lines now rendered with the same leading.
This is more consistent and allows for faster layouting.

**Fixed**

- 🐍 Fix compatibility with Python 3.8 and 3.9

------------------

**Breaking**

- 🪆 Expose most classes from submodules instead of root
(e.g. ``pdfje.Rect`` becomes ``pdfje.draw.Rect``).
The new locations can be found in the API documentation.
- 🏷️ ``Rule`` ``padding`` attribute renamed to ``margin``.

**Added**

- 📰 Support for horizontal alignment and justification of text.
- 🫸 Support for indenting the first line of a paragraph.
- ✂️ Automatic hyphenation of text.

------------------

A big release with lots of new features and improvements.
Most importantly, the page layout engine is now complete and
can be used to create multi-page/column documents.

**Added**

- 📖 Automatic layout of multi-style text into lines, columns, and pages
- 🔬 Automatic kerning for supported fonts
- 🖌️ Support for drawing basic shapes
- 🎨 Additional text styling options
- 📦 Make fonttools dependency optional
- 📏 Horizontal rule element

**Documentation**

- 🧑‍🏫 Add a tutorial and examples
- 📋 Polished docstrings in public API

**Performance**

- ⛳️ Document pages and fonts are now written in one efficient pass

**Breaking**

- 🌅 Drop Python 3.7 support

------------------

**Added**

- 🍰 Documents can be created directly from string input
- 🪜 Support for explicit newlines in text
- 📢 ``Document.write()`` supports paths, file-like objects and iterator output
- ✅ Improved PDF spec compliance

**Changed**

- 📚 Text is now positioned automatically within a page

------------------

**Added**

- 🖌️ Different builtin fonts can be selected
- 📥 Truetype fonts can be embedded
- 🌏 Support for non-ASCII text
- 📐 Pages can be rotated
- 🤏 Compression is applied to keep filesize small