Repolode
gruns

gruns/icecream

Помощник для отладки Python: ic() заменяет print(), показывая имена переменных, выражения и их значения в форматированном выводе с подсветкой синтаксиса.

Звёзды
10,109
Форки
235
Открытые issues
77
Последний коммит
позавчера

Что это?

IceCream — библиотека для отладки Python с функцией ic(), которая служит более удобной заменой print(). Передайте ей переменную или выражение — ic() выведет исходный текст вместе с вычисленным значением, чтобы было видно, что именно ей передали, без необходимости вручную подписывать вывод. Структуры данных выводятся в форматированном виде с подсветкой синтаксиса.

Если вызвать ic() без аргументов, она сообщит имя вызывающего файла, номер строки и родительскую функцию. Это удобно, чтобы отслеживать, какие ветви кода выполняются и в каком порядке. ic() также возвращает переданные аргументы, поэтому её можно обернуть вокруг существующих выражений, не меняя их поведение. Вызовы ic.disable() и ic.enable() позволяют одним действием отключить и включить весь вывод.

Формат вывода, префикс, место назначения и сериализацию значений можно настроить с помощью configureOutput, в том числе зарегистрировать собственные форматтеры для отдельных типов. Библиотека поддерживает Python 3 и PyPy3, а ic.format() возвращает вывод в виде строки, которую можно использовать для логирования.

Ключевые возможности

  • 01Выводит исходное выражение и его значение для переменных и выражений.
  • 02Выводит структуры данных в форматированном виде с подсветкой синтаксиса.
  • 03При вызове без аргументов сообщает вызывающий файл, номер строки и родительскую функцию.
  • 04Возвращает переданные аргументы, поэтому вызов можно вставить в существующий код.
  • 05Позволяет отключать и включать весь вывод, а также устанавливать функцию в builtins.
  • 06Позволяет настраивать префикс вывода, место назначения и форматирование значений.

Сценарии использования

  • Быстро проверять значения переменных при отладке скрипта на Python.
  • Отслеживать, какие ветви или функции выполняются и в каком порядке.
  • Передавать отладочный вывод в логгер с помощью ic.format().
  • Оставлять вызовы отладки в коде и отключать их в рабочей среде с помощью disable().

Быстрый старт

  1. 1

    Установите IceCream с помощью pip

    pip install icecream
  2. 2

    Импортируйте ic и вызовите его для переменной или выражения, чтобы вывести их имя и значение

Темы

Частые вопросы

Что такое icecream?
Помощник для отладки Python: ic() заменяет print(), показывая имена переменных, выражения и их значения в форматированном выводе с подсветкой синтаксиса. IceCream — библиотека для отладки Python с функцией ic(), которая служит более удобной заменой print(). Передайте ей переменную или выражение — ic() выведет исходный текст вместе с вычисленным значением, чтобы было видно, что именно ей передали, без необходимости вручную подписывать вывод. Структуры данных выводятся в форматированном виде с подсветкой синтаксиса.
icecream можно использовать бесплатно? Какая у него лицензия?
icecream распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
icecream всё ещё поддерживается?
Активно поддерживается. Последний коммит в icecream — 19 окт. 2026 г..
Для чего можно использовать icecream?
Быстро проверять значения переменных при отладке скрипта на Python. Отслеживать, какие ветви или функции выполняются и в каком порядке. Передавать отладочный вывод в логгер с помощью ic.format(). Оставлять вызовы отладки в коде и отключать их в рабочей среде с помощью disable().
Как установить icecream?
Установите IceCream с помощью pip: pip install icecream Импортируйте ic и вызовите его для переменной или выражения, чтобы вывести их имя и значение
Где скачать icecream?
Исходный код и инструкции по установке — на GitHub: https://github.com/gruns/icecream

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты