Module trans_real

django.utils.translation.trans_real

Translation helper functions.

source link

Classes

class DjangoTranslation
Set up the GNUTranslations context with regard to output charset.
class TranslationCatalog
Simulate a dict for DjangoTranslation._catalog so as multiple catalogs with different plural equations are kept separate.

Functions

▷ def activate(language)
Fetch the translation object for a given language and install it as the current translation object for the current thread.
source link
▷ def all_locale_paths()
Return a list of paths to user-provides languages files.
source link
▷ def catalog()
Return the current active catalog for further processing. This can be used if you need to modify the catalog or want to access the whole message catalog instead of just translating one string.
source link
▶ def check_for_language(lang_code) @functools.lru_cache(maxsize=1000)
Check whether there is a global language file for the given language code. This is used to decide whether a user-provided language is available.
@functools.lru_cache(maxsize=1000)
def check_for_language(lang_code)
source link
```
lru_cache should have a maxsize to prevent from memory exhaustion attacks,
as the provided language codes are taken from the HTTP request. See also
<https://www.djangoproject.com/weblog/2007/oct/26/security-fix/>.
```
▷ def deactivate()
Uninstall the active translation object so that further _() calls resolve to the default translation object.
source link
▷ def deactivate_all()
Make the active translation object a NullTranslations() instance. This is useful when we want delayed translations to appear as the original string for some reason.
source link
▷ def do_ntranslate(singular, plural, number, translation_function)
source link
▷ def get_language()
Return the currently selected language.
source link
▶ def get_language_bidi()
Return selected language's BiDi layout.
source link
```
* False = left-to-right layout
* True = right-to-left layout
```

▶ def get_language_from_path(path, strict=False)

Return the language code if there's a valid language code found in `path`.

source link

If `strict` is False (the default), look for a country-specific variant
when neither the language code nor its generic variant is found.

▶ def get_language_from_request(request, check_path=False)

Analyze the request to find what language the user wants the system to

source link

show. Only languages listed in settings.LANGUAGES are taken into account.
If the user requests a sublanguage where we have a main language, we send
out the main language.

If check_path is True, the URL path prefix will be checked for a language
code, otherwise this is skipped for backwards compatibility.

▷ def get_languages() @functools.lru_cache()
Cache of settings.LANGUAGES in a dictionary for easy lookups by key.
@functools.lru_cache()
def get_languages()
source link

▶ def get_supported_language_variant(lang_code, strict=False) @functools.lru_cache(maxsize=1000)

Return the language code that's listed in supported languages, possibly selecting a more generic variant. Raise LookupError if nothing is found.

@functools.lru_cache(maxsize=1000)
def get_supported_language_variant(

lang_code,

strict=False,

)

source link

If `strict` is False (the default), look for a country-specific variant
when neither the language code nor its generic variant is found.

lru_cache should have a maxsize to prevent from memory exhaustion attacks,
as the provided language codes are taken from the HTTP request. See also
<https://www.djangoproject.com/weblog/2007/oct/26/security-fix/>.

▷ def gettext(message)
Translate the 'message' string. It uses the current thread to find the translation object to use. If no current translation is activated, the message will be run through the default translation object.
source link

▶ def gettext_noop(message)

Mark strings for translation but don't translate them now. This can be

source link

used to store strings in global variables that should stay in the base
language (because they might be used externally) and will be translated
later.

▷ def ngettext(singular, plural, number)
Return a string of the translation of either the singular or plural, based on the number.
source link
▷ def npgettext(context, singular, plural, number)
source link
▶ def parse_accept_lang_header(lang_string) @functools.lru_cache(maxsize=1000)
Parse the lang_string, which is the body of an HTTP Accept-Language header, and return a tuple of (lang, q-value), ordered by 'q' values.
@functools.lru_cache(maxsize=1000)
def parse_accept_lang_header(lang_string)
source link
```
Return an empty tuple if there are any format errors in lang_string.
```
▷ def pgettext(context, message)
source link
▷ def reset_cache(**kwargs) @receiver(setting_changed)
Reset global state when LANGUAGES setting has been changed, as some languages should no longer be accepted.
@receiver(setting_changed)
def reset_cache(**kwargs)
source link
▷ def translation(language)
Return a translation object in the default 'django' domain.
source link

Django

Module trans_real

Classes

Functions