В этой статье вы прочитаете про что за Python библиотека Rich, научитесь её основам, и поймёте, надо вам её использовать для вашей работы или нет.
Также если вам интересны Python библиотеки, то советую почитать статью «Python библиотека Pytest для простого тестирования», думаю будет крайне интересно.
Основы Python библиотеки Rich:
Тут стоит сказать, что по сути это перевод официальной документации, оригинал, вы сможете посмотреть здесь.
Вступление:
Rich — это библиотека Python для вывода форматированного текста (с цветом и стилем) в терминал и для отображения расширенного содержимого, такого как таблицы, оценка и код с выделенным синтаксисом.
Используйте Rich, чтобы сделать ваши приложения в терминале визуально привлекательными и представить данные в более удобочитаемом виде. Rich также может быть полезным подспорьем при отладке за счет красивой печати и синтаксической подсветки структуры данных.
Требования:
Rich работает с операционными системами MacOS, Linux и Windows.
В Windows поддерживается как (старый) терминал cmd.exe, так и новый терминал Windows PowerShell. В последнем значительно улучшена поддержка цвета и стиля.
Rich требует Python 3.6.1 и выше. Обратите внимание, что Python 3.6.0 не поддерживается из-за отсутствия поддержки методов в NamedTuples.
Примечание:
Пользователи PyCharm должны будут включить «emulate terminal» в опции консоли вывода в конфигурации запуска / отладки, чтобы увидеть стилизованный вывод.
Установка:
Вы можете установить Rich из PyPI с помощью pip или вашего любимого менеджера пакетов:
1 | pip install rich |
Добавьте ключ -U
для обновления до текущей версии, если Rich уже установлен.
Если вы собираетесь использовать Rich с Jupyter, есть некоторые дополнительные зависимости, которые вы можете установить с помощью следующей команды:
1 | pip install rich[jupyter] |
Быстрый старт:
Самый быстрый способ начать работу с Rich — это импортировать альтернативную функцию print()
, которая принимает те же аргументы, что и встроенный print()
, и может использоваться в качестве замены. Вот как бы вы это сделали:
1 | from rich import print |
Затем вы можете выводить строки или объекты в терминал как обычно. Rich сделает базовую подсветку синтаксиса и отформатирует структуру данных, чтобы их было легче читать.
Строки могут содержать разметку консоли, которую можно использовать для вставки цвета и стилей вывода.
Следующий пример показывает как разметку консоли, так и красивое форматирование объектов Python:
1 | print("[italic red]Hello[/italic red] World!", locals()) |
В терминал будет записан следующие (включая все цвета и стили):
Если вы предпочитаете не заменять встроенный print
Python, вы можете импортировать rich.print
как println
(например):
1 | from rich import print as rprint |
Продолжайте читать, чтобы узнать о более продвинутых функциях Rich.
Rich в REPL:
Rich может быть установлен в REPL, чтобы структуры данных Python автоматически печатались с подсветкой синтаксиса. Вот как:
1 2 3 | >>> from rich import pretty >>> pretty.install() >>> ["Rich and pretty", True] |
Вы также можете использовать эту функцию, чтобы опробовать Rich визуализацию. Вот пример:
1 2 | >>> from rich.panel import Panel >>> Panel.fit("[bold yellow]Hi, I'm a Panel", border_style="red") |
Расширение IPython:
Rich также включает расширение IPython, которое будет делать такую же красивую установку + красивые трассировки. Вот как это загрузить:
1 | In [1]: %load_ext rich |
Вы также можете загрузить его по умолчанию, добавив «rich» в переменную c.InteractiveShellApp.extension
в конфигурации IPython.
Rich inspect:
У Rich есть функция inspect()
, которая может генерировать отчет по любому объекту Python. Это фантастическое средство отладки и хороший пример вывода, который может сгенерировать Rich. Вот простой пример:
1 2 3 4 | >>> from rich import inspect >>> from rich.color import Color >>> color = Color.parse("red") >>> inspect(color, methods=True) |
Вывод:
В статье вы прочитали что за Python библиотека Rich, думаю вам было интересно и полезно, и теперь вы будите использовать эту библиотеку, а если вы хотите узнать про неё побольше, то смотрите официальную документацию.