text_constant module lets you fetch and format text constants
| Function | Parameters | Return Value | Description |
|---|---|---|---|
cache_clear() |
Clears the text constant cache | ||
get_formatted_text_constant(_id, language=None, **kwargs) |
_id: CONST language: Sprachcode kwargs: Arguments to replace the placeholders in the text constant |
The text constant with the optional arguments formatted into the text | Fetch the text constant and replace placeholders. When no argument was given for a placeholder it is simply ignored. Text constants are only fetched once and then cached. |
get_text_constant(_id, language=None, default=None) |
_id: CONST language: Sprachcode default: A string to return when no text constant with the given id exists |
The text constant | Fetch a text constant. When default is None and no constant exists with that id, a ValueError is raised. Text constants are only fetched once and then cached. |
safe_format(text, **formatting_parameters) |
text: A string with format parameters like 'Hello {user}'formatting_parameters: Arguments to replace the placeholders in the text |
The text with placeholders replaced | Safely format a string, without raising an error when not all placeholders were replaced |
from ppms.text_constant import safe_format
text = "The quick brown {jumpee} jumped over the lazy {animal}"
# If you used text.format() then it would raise a KeyError
formatted_text = safe_format(text, jumpee='fox')
# formatted_text is now "The quick brown fox jumped over the lazy {animal}"