UnoGenerator

Description

UnoGenerator is a powerful Python module designed to generate LibreOffice documents (ODT and ODS) programmatically with high performance and professional aesthetics.

Key features include:

Professional Defaults: Automatic text wrapping (word_wrap=True) and vertical centering for professional-looking reports out of the box.
High Performance: Optimized for large datasets. Inserting 10,000 rows with default formatting takes less than 0.3 seconds.
Rich Exports: Easy export to .xlsx, .docx, and .pdf.
Advanced Helpers: Flexible totals generation, automatic column width calculation, and complex data block handling.
Multilingual Support: Built-in support for translations and localized document generation.

It uses the LibreOffice UNO module, requiring a LibreOffice installation on your system.

Installation

Only Linux is supported. See the installation guide for detailed instructions on main Linux distributions.

Architecture

UnoGenerator follows a clean, template-based architecture:

ODS/ODT: Generic base classes for document manipulation.
ODS_Standard / ODT_Standard: Optimized subclasses that use the built-in professional templates, providing specific styles (like "Normal", "BoldCenter") and optimized row heights.

ODT 'Hello World' example

Create a professional ODT document with just a few lines:

from unogenerator import ODT_Standard

with ODT_Standard() as doc:
    doc.addParagraph("Hello World", "Heading 1")
    doc.addParagraph("Easy, isn't it", "Standard")
    doc.save("hello_world.odt")
    doc.export_docx("hello_world.docx")
    doc.export_pdf("hello_world.pdf")

ODS 'Hello World' example

Generate a styled spreadsheet with automatic wrapping and alignment:

from unogenerator import ODS_Standard

with ODS_Standard() as doc:
    # word_wrap and vertical alignment are enabled by default
    doc.addCellMergedWithStyle("A1:E1", "Sales Report 2026", style="BoldCenter")
    doc.addRowWithStyle("A2", ["Product", "Quantity", "Price", "Total"])
    doc.save("sales_report.ods")
    doc.export_xlsx("sales_report.xlsx")

Advanced Features: Totals and Formulas

UnoGenerator provides advanced helpers to generate calculations quickly:

from unogenerator import helpers

# Generates both row and column totals with a custom formula template
helpers.cross_totals_from_range(doc, "B2:D10", key="=SUM({}*1.21)")

Unogenerator scripts

The package includes several useful CLI tools:

unogenerator_monitor

Monitors your LibreOffice server instances and their status.

unogenerator_translation

Translate multiple ODT files using standard .pot and .po files. unogenerator_translation --from_language es --to_language en --input original.odt --output_directory "translated"

unogenerator_demo

Generate comprehensive example files and perform performance benchmarks on your system.

Documentation

Full technical documentation is available in the doc directory, created using UnoGenerator itself.

Development links

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unogenerator-1.5.0.tar.gz (867.1 kB view details)

Uploaded Aug 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

unogenerator-1.5.0-py3-none-any.whl (890.6 kB view details)

Uploaded Aug 7, 2026 Python 3

File details

Details for the file unogenerator-1.5.0.tar.gz.

File metadata

Download URL: unogenerator-1.5.0.tar.gz
Upload date: Aug 7, 2026
Size: 867.1 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.4.1 CPython/3.14.6 Linux/7.1.6-gentoo

File hashes

Hashes for unogenerator-1.5.0.tar.gz
Algorithm	Hash digest
SHA256	`d1b76a58a6ccef7a514827b7f1c96f8f503a7efbe15435a569b9ed7446c1bd7e`
MD5	`ff73f50e207c615fa4a9fa05346a0e28`
BLAKE2b-256	`5cb30fd62042fd2422297f52c81d32a4061421d07b7b393b87aaf33101d0c4d6`

See more details on using hashes here.

File details

Details for the file unogenerator-1.5.0-py3-none-any.whl.

File metadata

Download URL: unogenerator-1.5.0-py3-none-any.whl
Upload date: Aug 7, 2026
Size: 890.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.4.1 CPython/3.14.6 Linux/7.1.6-gentoo

File hashes

Hashes for unogenerator-1.5.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`02d31bcf097d302fee63532e1fa4e6276e72b1d0b02db5951fb97da94899fd92`
MD5	`69e5ca69ce328017f240bd2c4d88579d`
BLAKE2b-256	`0ca9bbfeab9dfd07973c3bcaac7e06a2a47ee377857c3a5dd405706c799517d6`