quart-babel

library1.0.7pypypi✓ verified 86d ago

Implements i18n and l10n support for Quart, the async Python web microframework. Current version 1.0.7. Release cadence is irregular, with several breaking changes in recent versions.

web-framework serialization

pip install quart-babel

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · QUART-BABEL

quart-babel

web-frameworkpythonv1.0.7

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Babel

✓ from quart_babel import Babel

✗ from quart_babel.babel import Babel

Babel is exported directly from quart_babel, not a submodule

gettext functions

✓ from quart_babel import gettext, ngettext, lazy_gettext

✗ from quart_babel.utils import gettext

gettext functions are top-level in quart_babel

format_date

✓ from quart_babel import format_date, format_datetime, format_number

✗ from quart_babel.dates import format_date

Format functions are exported directly from quart_babel

Basic Quart-Babel setup with a simple route using gettext.

import os from quart import Quart from quart_babel import Babel, gettext, set_locale app = Quart(__name__) app.config['BABEL_DEFAULT_LOCALE'] = os.environ.get('BABEL_DEFAULT_LOCALE', 'en') babel = Babel(app) @app.route('/') async def index(): return gettext('Hello World') if __name__ == '__main__': app.run()

Debug

Known issues

breakingIn version 1.0.6, the extension was rewritten as a copy of Flask-Babel, removing the ASGI middleware. All functions (gettext, format_date, etc.) are now synchronous, not async. Update your routes and templates accordingly.

fix

Remove 'await' calls from gettext, format_date, etc. Import directly from quart_babel.

affects: >=1.0.6

breakingVersion 1.0.0 introduced ASGI middleware for locale/timezone detection, which broke compatibility with Quart-WTF and other extensions. Version 1.0.6 removed that middleware again.

fix

Upgrade to >=1.0.6, which reverts to Flask-Babel style without middleware.

affects: 1.0.0 - 1.0.5

gotchaQuart-Babel does not automatically detect the browser's language. You must implement your own locale selector (e.g., from request headers).

fix

Pass a locale_selector function when initializing Babel: Babel(app, locale_selector=lambda: request.headers.get('Accept-Language', 'en')[0:2])

affects: All

gotchaLazy gettext (lazy_gettext) cannot be used directly in route decorators because it's evaluated at template rendering time. Use it in form definitions or with callables.

fix

Store lazy_gettext in a lambda or function, or use it only inside templates and forms.

affects: All

Errors

Common errors & fixes

TypeError: can't use async function in non-async context

Using 'await' with gettext/format_date, which are synchronous in versions >=1.0.6.

fix

Remove 'await' from gettext, format_date, etc. They are synchronous functions.

AttributeError: module 'quart_babel' has no attribute 'Babel'

Importing from wrong module (e.g., 'from quart_babel.babel import Babel').

fix

Use 'from quart_babel import Babel'.

RuntimeError: No current application context

Calling gettext outside of a Quart request context (e.g., at module level).

fix

Ensure gettext is called within a route or template, or use lazy_gettext outside context.

ImportError: cannot import name 'format_date' from 'quart_babel'

Trying to import from a submodule like 'quart_babel.dates' in old versions.

fix

Use 'from quart_babel import format_date' directly.

Upgrade

Version history

1.0.7latest on PyPI · released Oct 5, 2024

Audit

Dependencies

QuartrequiredRequired web framework

BabelrequiredCore localization library

python-dotenvoptionalOften used for locale config

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/Quart-Addons/quart-babel ↗

packagehttps://pypi.org/project/quart-babel/ ↗

docshttps://quart-babel.readthedocs.io/en/latest/ ↗