Class translator

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

Overrides: object.__init__

(inherited documentation)

Returns info for selected language or dictionary with all
possible languages info from `APP/languages/*.py`
It Returns:

- a tuple containing::

        langcode, langname, langfile_mtime,
        pluraldict_fname, pluraldict_mtime,
        prules_langcode, nplurals,
        get_plural_id, construct_plural_form

        or None

- if *lang* is NOT defined a 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
    }

Args:
    lang (str): language

Gets plural form of word for number *n*
invoked from T()/T.M() in `%%{}` tag

Args:
    word (str): word in singular
    n (numeric): number plural form created for

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

Note:
    "word" MUST be defined in current language (T.accepted_language)

Selects language(s) for translation

if a list of languages is passed as a parameter, the 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.

Use ## 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 needed to allow markmin syntax to be translated

Substitutes 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!