mirror of
https://github.com/aiogram/aiogram.git
synced 2025-12-09 09:22:03 +00:00
84 lines
2.6 KiB
Python
84 lines
2.6 KiB
Python
"""
|
|
Internalize your bot
|
|
|
|
Step 1: extract texts
|
|
# pybabel extract i18n_example.py -o locales/mybot.pot
|
|
|
|
Some useful options:
|
|
- Extract texts with pluralization support
|
|
# -k __:1,2
|
|
- Add comments for translators, you can use another tag if you want (TR)
|
|
# --add-comments=NOTE
|
|
- Disable comments with string location in code
|
|
# --no-location
|
|
- Set project name
|
|
# --project=MySuperBot
|
|
- Set version
|
|
# --version=2.2
|
|
|
|
Step 2: create *.po files. For e.g. create en, ru, uk locales.
|
|
# echo {en,ru,uk} | xargs -n1 pybabel init -i locales/mybot.pot -d locales -D mybot -l
|
|
Step 3: translate texts
|
|
Step 4: compile translations
|
|
# pybabel compile -d locales -D mybot
|
|
|
|
Step 5: When you change the code of your bot you need to update po & mo files.
|
|
Step 5.1: regenerate pot file:
|
|
command from step 1
|
|
Step 5.2: update po files
|
|
# pybabel update -d locales -D mybot -i locales/mybot.pot
|
|
Step 5.3: update your translations
|
|
Step 5.4: compile mo files
|
|
command from step 4
|
|
"""
|
|
|
|
from pathlib import Path
|
|
|
|
from aiogram import Bot, Dispatcher, executor, types
|
|
from aiogram.contrib.middlewares.i18n import I18nMiddleware
|
|
|
|
TOKEN = 'BOT TOKEN HERE'
|
|
I18N_DOMAIN = 'mybot'
|
|
|
|
BASE_DIR = Path(__file__).parent
|
|
LOCALES_DIR = BASE_DIR / 'locales'
|
|
|
|
bot = Bot(TOKEN, parse_mode=types.ParseMode.HTML)
|
|
dp = Dispatcher(bot)
|
|
|
|
# Setup i18n middleware
|
|
i18n = I18nMiddleware(I18N_DOMAIN, LOCALES_DIR)
|
|
dp.middleware.setup(i18n)
|
|
|
|
# Alias for gettext method
|
|
_ = i18n.gettext
|
|
|
|
|
|
@dp.message_handler(commands=['start'])
|
|
async def cmd_start(message: types.Message):
|
|
# Simply use `_('message')` instead of `'message'` and never use f-strings for translatable texts.
|
|
await message.reply(_('Hello, <b>{user}</b>!').format(user=message.from_user.full_name))
|
|
|
|
|
|
@dp.message_handler(commands=['lang'])
|
|
async def cmd_lang(message: types.Message, locale):
|
|
await message.reply(_('Your current language: <i>{language}</i>').format(language=locale))
|
|
|
|
# If you care about pluralization, here's small handler
|
|
# And also, there's and example of comments for translators. Most translation tools support them.
|
|
|
|
# Alias for gettext method, parser will understand double underscore as plural (aka ngettext)
|
|
__ = i18n.gettext
|
|
|
|
# Some pseudo numeric value
|
|
TOTAL_LIKES = 0
|
|
|
|
@dp.message_handler(commands=['like'])
|
|
async def cmd_like(message: types.Message, locale):
|
|
TOTAL_LIKES += 1
|
|
|
|
# NOTE: This is comment for a translator
|
|
await message.reply(__('Aiogram has {number} like!', 'Aiogram has {number} likes!', TOTAL_LIKES).format(number=TOTAL_LIKES))
|
|
|
|
if __name__ == '__main__':
|
|
executor.start_polling(dp, skip_updates=True)
|