toml-i18n 1.0.8

A lightweight localization module for Python projects

toml_i18n

toml_i18n is a lightweight localization module for Python projects. It provides an easy way to manage and retrieve localized strings using TOML files.

Installation

pip install toml-i18n

Usage

Step 1: Create a Directory for Translations

In your project directory, create a subdirectory for your localization files (e.g., i18n).

Step 2: Add a Translation File

Inside the directory, create a TOML file for your localized strings, such as general.en.toml:

[general]

greeting = "Hello {name}!"

and

general.fr.toml:

[general]

greeting = "Bonjour {name}!"

Step 3: Initialize toml_i18n

Use the `TomlI18n class to set up the module with your desired locales and directory:

from toml_i18n import TomlI18n

TomlI18n.initialize(locale="fr", fallback_locale="en", directory="i18n")

This needs to be done only once when running the project.

Step 4: Retrieve Localized Strings

from toml_i18n import i18n

print(i18n("general.greeting", name="John Doe"))

Step 5: Format Numbers (Optional)

from toml_i18n import i18n_number

print(i18n_number(1234.56, decimals=2))  # Formats according to current locale

Key Features

• Flexible Localization: Load translations from TOML files.
• Fallback Locale: Automatically fall back to a default locale if a key is missing.
• Dynamic Formatting: Use placeholders in your strings for flexible output.
• Singleton Design: Easy setup and global access to translations.