i18n-tools

Version française (lecteur français et francophones)

English reader and ROW

Description

The i18n-tools project aims to simplify and modernize translation management in Python applications. It introduces a new flexible translation file format, independent of any dominant language, designed to coexist with existing standards such as gettext (.po/.mo files) and i18next.

The goal is to provide a modular, adaptable, and language-agnostic solution, with native support for translation variants, multiple plurals, and transparent language fallback management.

Roadmap

The project follows a progression by deliverable value. Each version is independently usable.

Features

Installation

pip install pyi18t-tools

This installs everything needed to load, format, and save .i18t files: Message, Book, Corpus, Encyclopaedia, formatter.publish(), and the CLI (validate/info/sync/repl) with a .yaml/.json settings file.

Author and translator management (Config/Repository author/translator methods, translator API URL validation, or a .toml settings file) additionally requires the api extra:

pip install pyi18t-tools[api]

Calling one of these methods without the extra installed raises a clear ModuleNotFoundError naming the missing package and this install command, rather than a bare import failure (DD-41).

Why This Project?

• Flexibility: a format designed to adapt to all translation needs, without linguistic constraints — no language is dominant.
• Expressiveness: native support for contextual variants (gender, register, context) and business plurals beyond CLDR rules.
• Extensibility: layered architecture enabling conversion to existing standards (gettext, i18next) without modifying the models.
• Interoperability: bridge with the Babel ecosystem for progressive compatibility with existing tools.

License

See the license.md file.

Contact

For any questions or contributions, open a GitHub issue.