✂️ truncate

Укорачивает строку до максимальной длины, добавляя многоточие, если пришлось обрезать.

from raito.utils.helpers.truncate import truncate

truncate("Hello, world!", 8)            # "Hello..."
truncate("short", 8)                     # "short"        (unchanged)
truncate("Hello, world!", 8, ellipsis="…")  # "Hello, …"

Сигнатура: truncate(text, max_length, ellipsis="..."). Когда text длиннее max_length, строка обрезается так, чтобы text вместе с ellipsis уложился в лимит.

Raito использует её внутри, чтобы удерживать описания команд и вывод справки в пределах длины Telegram. Берите её всякий раз, когда выводите пользовательский или конфигурационный текст в интерфейс фиксированной ширины.

Примечание

Оставляйте max_length запас под многоточие. Если лимит меньше самого многоточия, результат может превысить max_length, поэтому подбирайте лимит под ваш интерфейс.