Black — форматтер Python-кода с заданным стилем и предсказуемым результатом, который перезаписывает файлы с минимальными diff.
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
Установите IceCream с помощью pip
pip install icecream - 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 обновляется ежедневно.
Похожие проекты
Быстрый и расширяемый индикатор выполнения для циклов, итерируемых объектов и конвейеров командной строки в Python.
Профилировщик памяти для Python: отслеживает выделения памяти в Python-коде, нативных расширениях и интерпретаторе и формирует отчёты нескольких типов.
Расширение для браузера и компонент React для анализа состояния Redux, повторного воспроизведения действий и горячей перезагрузки.
Внутриигровая консоль на uGUI для Unity: показывает логи во время выполнения и позволяет запускать зарегистрированные отладочные команды в сборках.
Набор инструментов для отладки iOS-приложений прямо в приложении: плавающее меню помогает проверять сетевой трафик, производительность, представления, логи и данные приложения.