Translatable-Enums is an i18n tool which uses built-in Enums as a convenient way to store translation keys.
- No dependencies except the Python's standard library. Based on built-in enums & gettext
- Powerful utility for extracting translation-keys
- Easy-to-Use
You can use PIP:
pip install translatable-enumsOr Poetry:
poetry add translatable-enumsfrom i18n import (
TranslatableEnum,
set_domain,
set_language,
language
)
class Messages(TranslatableEnum):
HELLO = 'Hello,'
WORLD = 'World!'
set_domain('app', './resources/languages')
set_language('en_US')
print(Messages.HELLO, Messages.WORLD) # Hello, World!
set_language('uk_UA')
print(Messages.HELLO, Messages.WORLD) # Привіт, Світ!
set_language('fr_FR')
print(Messages.HELLO, Messages.WORLD) # Bonjour le monde!
print(Messages.HELLO.language('uk'), Messages.WORLD.language('en')) # Привіт, World!
with language('uk_UA'):
print(Messages.HELLO, Messages.WORLD) # Привіт, Світ!
print(Messages.HELLO, Messages.WORLD) # Bonjour le monde!To extract the translation-keys from application:
python -m i18n main.py application.potYou will obtain a .pot file like this:
msgid ""
msgstr ""
"Project-Id-Version: \n"
"POT-Creation-Date: \n"
"Last-Translator: \n"
"Language-Team: \n"
"Language: \n"
"MIME-Version: \n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
# Messages.WORLD
msgid "World!"
msgstr ""
# Messages.HELLO
msgid "Hello,"
msgstr ""
python -m i18n main.py application.pot --key-format "{enum}.{name}.{value}"Default: "{value}"
- enum - enum name
- name - attribute name
- value - attribute value
Examples:
{enum}.{name}.{value}
# Messages.WORLD
msgid "Messages.WORLD.World!"
msgstr ""
{enum}.{name}
# Messages.WORLD
msgid "Messages.WORLD"
msgstr ""
{value}
# Messages.WORLD
msgid "World!"
msgstr ""
See /examples for more examples.
0.0.6 - RELEASED
Translatable-Enums is released under the MIT License. See the bundled LICENSE file for details.
