betty.locale.localizable package

Submodules

Module contents

The localizable API allows objects to be localized at the point of use.

class betty.locale.localizable.Localizable[source]

Bases: ABC

A localizable object.

Objects of this type can convert themselves to localized strings at the point of use.

abstract localize(localizer: Localizer) str[source]

Localize self to a human-readable string.

betty.locale.localizable.ShorthandStaticTranslations: TypeAlias = collections.abc.Mapping[str, str] | str

StaticTranslations or a string which is the translation for the undetermined locale. See betty.locale.localizable.assertion.assert_static_translations().

betty.locale.localizable.StaticTranslations

Keys are locales, values are translations. See betty.locale.localizable.assertion.assert_static_translations().

alias of Mapping[str, str]

class betty.locale.localizable.StaticTranslationsLocalizable[source]

Bases: _FormattableLocalizable

Provide a betty.locale.Localizable backed by static translations.

__init__(translations: Mapping[str, str] | str)[source]
localize(localizer: Localizer) str[source]

Localize self to a human-readable string.

betty.locale.localizable.call(call: Callable[[Localizer], str]) Localizable[source]

Create a new localizable that outputs the callable’s return value.

betty.locale.localizable.format(localizable: Localizable, *format_args: str | Localizable, **format_kwargs: str | Localizable) Localizable[source]

Perform string formatting.

The arguments are identical to those of :py:meth:str.format.

betty.locale.localizable.gettext(message: str) _GettextLocalizable[source]

Like gettext.gettext().

Positional arguments are identical to those of gettext.gettext(). Keyword arguments are identical to those of :py:met:`str.format`, except that any betty.locale.Localizable will be localized before string formatting.

betty.locale.localizable.ngettext(message_singular: str, message_plural: str, n: int) _GettextLocalizable[source]

Like gettext.ngettext().

Positional arguments are identical to those of gettext.ngettext(). Keyword arguments are identical to those of :py:met:`str.format`, except that any betty.locale.Localizable will be localized before string formatting.

betty.locale.localizable.npgettext(context: str, message_singular: str, message_plural: str, n: int) _GettextLocalizable[source]

Like gettext.npgettext().

Positional arguments are identical to those of gettext.npgettext(). Keyword arguments are identical to those of :py:met:`str.format`, except that any betty.locale.Localizable will be localized before string formatting.

betty.locale.localizable.pgettext(context: str, message: str) _GettextLocalizable[source]

Like gettext.pgettext().

Positional arguments are identical to those of gettext.pgettext(). Keyword arguments are identical to those of :py:met:`str.format`, except that any betty.locale.Localizable will be localized before string formatting.

betty.locale.localizable.static(translations: Mapping[str, str] | str) Localizable[source]

Create a new localizable that outputs the given static translations.