Class translator

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__

(inherited documentation)

return info for selected language or dictionary with all
    possible languages info from APP/languages/*.py
args:
    *lang* (str): language
returns:
    if *lang* is defined:
       return tuple(langcode, langname, langfile_mtime,
                    pluraldict_fname, pluraldict_mtime,
                    prules_langcode, nplurals,
                    get_plural_id, construct_plural_form)
                    or None

    if *lang* is NOT defined:
       returns dictionary with all possible languages:
    { langcode(from filename):
        ( langcode,        # language code from !langcode!
          langname,
              # language name in national spelling from !langname!
          langfile_mtime,  # m_time of language file
          pluraldict_fname,# name of plural dictionary file or None (when default.py is not exist)
          pluraldict_mtime,# m_time of plural dictionary file or 0 if file is not exist
          prules_langcode, # code of plural rules language or 'default'
          nplurals,        # nplurals for current language
          get_plural_id,   # get_plural_id() for current language
          construct_plural_form) # construct_plural_form() for current language
    }

get plural form of word for number *n*
    NOTE: *word" MUST be defined in current language
          (T.accepted_language)

    invoked from T()/T.M() in %%{} tag
args:
    word (str): word in singular
    n (numeric): number plural form created for

returns:
    (str): word in appropriate singular/plural form

select language(s) for translation

if a list of languages is passed as a parameter, first language from this list that matches the ones from the possible_languages dictionary will be selected

default language will be selected if none of them matches possible_languages.

user ## to add a comment into a translation string the comment can be useful do discriminate different possible translations for the same string (for example different locations)

T(' hello world ') -> ' hello world ' T(' hello world ## token') -> ' hello world ' T('hello ## world## token') -> 'hello ## world'

the ## notation is ignored in multiline strings and strings that start with ##. this is to allow markmin syntax to be translated

substitute parameters from symbols into message using %. also parse %%{} placeholders for plural-forms processing. returns: string with parameters NOTE: *symbols* MUST BE OR tuple OR dict of parameters!