Fluent Telegrinder

Fluent i18n implementation for telegrinder

💖 Part of Awesome Telegrinder

Usage

pip install fluent-telegrinder

CLI

# Pre-compile .ftl files into .ftlc (pickled AST) for faster startup:
ftl-compile locales/

# Write compiled files to a separate directory:
ftl-compile locales/ --output locales_compiled/

# Force overwrite existing .ftlc files:
ftl-compile locales/ --force

Then enable compiled loading in your config:

config = FluentConfig(
    folder="locales/",
    source=DefaultLocaleSource,
    use_compiled=True,  # loads .ftlc files, falls back to .ftl if absent
)

from telegrinder import API, Message, Telegrinder, Token

from fluent_telegrinder import (
    DefaultLocaleSource,  # / UserLanguageSource 
    FluentConfig,
    Translator,
    TextEquals,
)

config = FluentConfig(
    folder="locales/",
    source=DefaultLocaleSource, # any node that returns str - source for locale
    default_locale="ru",
    replace_underscore=True, # i_love_telegrinder -> i-love-telegrinder
)
Translator.configure(config)

bot = Telegrinder(API(Token.from_env()))

@bot.on.message(TextEquals("hello", ignore_case=True)) # hello - i18n key (hello, привет)
async def on_hello(msg: Message, _: Translator):
    await msg.reply(_.hello_answer(user=msg.from_user.first_name))

bot.run_forever(skip_updates=True)

License

Fluent Telegrinder is MIT licensed.