pox-convert

Convert .po (gettext) files to Excel spreadsheets and back. Supports fuzzy entries and multiple plural forms.

Usage

PO to Excel

uvx pox-convert export path/to/messages.po

Use globbing to convert multiple files at once:

uvx pox-convert export locales/**/django.po

Options:

-o, --outdir      Output directory (default: current directory)
-f, --filename    Filename template using {lang} and {date} variables
                  (default: translations_{lang}.xlsx)
-l, --language    Override the language metadata from the PO file
--fuzzy           How to handle fuzzy entries: stop, ignore, include (default: stop)

Excel to PO

uvx pox-convert import path/to/translations.xlsx

Options:

-o, --outdir      Output directory (default: current directory)
-f, --filename    Filename template using {lang} variable (default: {lang}.po)

Spreadsheet format

The generated Excel file has the following structure:

• Empty translations are highlighted in yellow with a black border
• The header row is frozen for easy scrolling
• Alternating row stripes improve readability
• Plural forms get additional translation columns
• Language metadata is stored as a custom document property

Django integration

pox-convert ships with a Django management command that wraps makemessages to skip fuzzy matching:

python manage.py makemessages_nofuzzy -l de

Add pox.contrib.django.pox to your INSTALLED_APPS to use it.

Changelog

1.1.0

• Programmatic plural hint generation using a safe formula parser.
• Improved CI coverage reporting.
• 100% test coverage.

1.0.1

• Unified CLI with pox-convert entry point.
• Added Excel-to-PO reverse conversion (xop).
• Redesigned spreadsheet styles and column headers.
• Added MIT license, README, and GitHub Actions CI workflow.
• Full type annotations and stricter linting.

1.0.0

• Initial release with PO-to-Excel conversion.