mirror of
https://github.com/koloideal/Argenta.git
synced 2026-06-10 18:15:28 +03:00
39 lines
3.3 KiB
ReStructuredText
39 lines
3.3 KiB
ReStructuredText
.. _root_overriding_formatting:
|
|
|
|
Управление форматированием вывода
|
|
=================================
|
|
|
|
По умолчанию ``Argenta`` использует библиотеку ``rich`` для вывода текста с расширенным форматированием. Она позволяет применять цвета и стили, создавать таблицы, подсвечивать синтаксис и многое другое, что улучшает визуальное восприятие информации.
|
|
|
|
------
|
|
|
|
Управление стандартным форматированием
|
|
--------------------------------------
|
|
|
|
При создании экземпляра ``App`` можно использовать параметр ``override_system_messages: bool`` (по умолчанию ``False``), который позволяет отключать стандартное форматирование.
|
|
|
|
Если установить его в ``True``, стилизация текста и ASCII-арт будут отключены, а системные сообщения — выводиться в «сыром» виде.
|
|
|
|
-----
|
|
|
|
Приветственное и прощальное сообщения
|
|
--------------------------------------
|
|
|
|
Приветственное (``initial_message``) и прощальное (``farewell_message``) сообщения по умолчанию выводятся в виде ASCII-графики.
|
|
|
|
.. warning::
|
|
Библиотека ``art`` ориентирована на работу с ASCII-символами и **не поддерживает кириллицу**. Это приводит к искажению символов русского и других кириллических алфавитов. Если ваше сообщение содержит кириллицу, рекомендуется отключить форматирование с помощью ``override_system_messages=True`` или использовать только латинские символы.
|
|
|
|
-----
|
|
|
|
Кастомизация вывода
|
|
-------------------
|
|
|
|
Для полной замены логики вывода текста в конструкторе ``App`` предусмотрен параметр ``print_func``.
|
|
|
|
* **print_func**: ``Callable[[str], None]``
|
|
Этот параметр позволяет передать любую вызываемую сущность (например, функцию), которая будет использоваться для вывода всех системных сообщений. По умолчанию это ``rich.console.Console().print``. Вы можете передать сюда свою функцию, чтобы, например, логировать вывод в файл или отправлять его по сети.
|
|
|
|
.. important::
|
|
При переопределении функции вывода вам следует убедиться, что она поддерживает разметку ``rich``, иначе системные сообщения будут выводиться в сыром виде, в этом случае рекомендуется переопределить стандартное форматирование с помощью ``override_system_messages=True``.
|