i21y 0.4.1

The simple library for i18n support.

i21y

i21y (a.k.a internationalization.py) is library for support i18n in Python. It is easy to use.

Features:

• Zero dependencies by default
• Simple design
• Utilities to simplify keys

Installation

• Normal: pip install i21y
• YAML support: pip install i21y[yaml]
• Fast JSON (by orjson) support: pip install i21y[fast-json]

Example

Basic

from i21y import Translator
from i21y.loaders.json import Loader

t = Translator(Loader("locale"))

assert t("main.responses.not_found", locale="ja") == "見つからなかった。"

Advanced

from i21y import locale_str

LONG_KEY = locale_str("very.long.locale.key.yeah_so_long")
print(LONG_KEY.but_easy_to_use) # very.long.locale.key.yeah_so_long.but_easy_to_use

assert t(LONG_KEY.but_easy_to_use, locale="ja") == "とても長いキーでも簡単に使える。"
assert t(LONG_KEY + "but_easy_to_use", locale="ja") == "とても長いキーでも簡単に使える。"

Documentation

See the documentation for usage and details.

License

This project is licensed under the MIT License.

Contributing Guide

This project is managed by the package manager uv.
In coding, please use Ruff as a code formatter and pyright for type checking. The configuration is described in pyproject.toml.
Please write what you have done in a complete sentence and use the original form of the verb. e.g. Fix that locale_str can't join.