Various routines that help with validation of translations.
Present Since | |
version 0.9 | |
Unknown Field: copyright | |
| |
Unknown Field: license | |
BSD, see LICENSE for more details. |
Variable | checkers |
Undocumented |
Function | _find_checkers |
Undocumented |
Function | _validate_format |
No summary |
Function | num_plurals |
Verify the number of plurals in the translation. |
Function | python_format |
Verify the format string placeholders in the translation. |
Variable | _string_format_compatibilities |
Undocumented |
Test format string alternative
against format
. format
can be the
msgid of a message and alternative
one of the msgstr
s. The two
arguments are not interchangeable as alternative
may contain less
placeholders if format
uses named placeholders.
The behavior of this function is undefined if the string does not use string formattings.
If the string formatting of alternative
is compatible to format
the
function returns None
, otherwise a TranslationError
is raised.
Examples for compatible format strings:
>>> _validate_format('Hello %s!', 'Hallo %s!') >>> _validate_format('Hello %i!', 'Hallo %d!')
Example for an incompatible format strings:
>>> _validate_format('Hello %(name)s!', 'Hallo %s!') Traceback (most recent call last): ... TranslationError: the format strings are of different kinds
This function is used by the python_format
checker.
Parameters | |
format | The original format string |
alternative | The alternative format string that should be checked against format |
Raises | |
TranslationError | on formatting errors |