muffin-babel 0.6.0

Localization support for the Muffin Framework

Muffin-Babel – an extension to Muffin that adds localization support with help of Babel.

Contents

• Requirements

• Installation

• Usage

  • Jinja2

  • Options

• Commands

  • Extract messages

• Bug tracker

• Contributing

• Contributors

• License

Requirements

• python >= 3.8

Installation

Muffin-Babel should be installed using pip:

pip install muffin-babel

Usage

Initialize and setup the plugin:

import muffin
import muffin_babel

# Create Muffin Application
app = muffin.Application('example')

# Initialize the plugin
# As alternative: babel = muffin_babel.Plugin(app, **options)
babel = muffin_babel.Plugin()
babel.setup(app, template_folders=['src/templates'])

# Use it inside your handlers
@app.route('/')
async def index(request):
    # Get current locale
    assert babel.current_locale
    # Translate a text
    return babel.gettext('Hello World!')

Setup a locale selector function (by default the plugin is parsing accept-language header):

@babel.locale_selector
async def get_locale(request, default_locale='en'):
    """ Return locale either from request.query or from request headers. """
    locale = request.query.get('lang')
    if not locale:
        return await muffin_babel.select_locale_by_request(request, default)
    return locale

Use babel.gettext, babel.pgettext callables in your code:

@app.route('/')
def index(request):
    return babel.gettext('Hello!')

Jinja2

The Muffin-Babel has integration with Muffin-Jinja2, so if you have muffin_jinja2 plugin enabled, the plugin provides gettext and ngettext function inside the Jinja2 templates’ context.

Options

Name	Description (default value)
AUTO_DETECT_LOCALE	Installs a middleware to automatically detect users locales (True)
CONFIGURE_JINJA2	Installs i18n support for jinja2 templates (through muffin-jinja) (True)
DEFAULT_LOCALE	Default locale (en)
DOMAIN	Default localization domain (messages)
SOURCES_MAP	Babel sources map
OPTIONS_MAP	Babel options map

Commands

The plugin adds two commands to your Muffin application.

Extract messages

Extract strings from your application to locales:

$ muffin app_package babel_extract_messages [OPTIONS] appdir

Translate .po files and compile translations:

$ muffin app_package babel_compile_messages [OPTIONS]

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/muffin-babel/issues

Contributing

Development of Muffin-Babel happens at: https://github.com/klen/muffin-babel

Contributors

• klen (Kirill Klenov)

License

Licensed under a MIT license.