Забудьте о print(): 8 библиотек для отладки Python-кода, которые вы полюбите

Мы все начинали с print(): вывел значение — увидел проблему. Но когда проект разрастается, а в консоли мешанина из десятков строк, начинаешь мечтать о чём-то большем. К счастью, Python-сообщество создало множество инструментов, которые делают отладку не только эффективной, но и… приятной. Вот 8 библиотек, которые изменят ваш подход к поиску ошибок.

Содержание

🍦 1. IceCream — эволюция `print()`

Автор библиотеки так устал писать print(f"var: {var}"), что создал идеальную замену. IceCream автоматически показывает имя переменной и её значение.

from icecream import ic

user = "Alice"
age = 30

ic(user)      # ic| user: 'Alice'
ic(age * 2)   # ic| age * 2: 60

# А если вызвать без аргументов — увидите, где именно в коде оказались
def greet():
    ic()      # ic| example.py:12 in greet()
    return "Hello"

greet()

Фишки:

Выводит имя файла и номер строки (включается опцией).
Красиво форматирует словари и списки.
Можно глобально отключить (ic.disable()) — и все ic() исчезнут из вывода.
Возвращает переданное значение, так что легко встроить в существующий код.

Установка: pip install icecream

✨ 2. LitPrinter — IceCream на стероидах

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

from litprinter import lit, log
from litprinter.traceback import install as install_tb

# Включаем красивый вывод ошибок (в стиле Dracula)
install_tb(theme="dracula", show_locals=True)

x, y = 10, 20
lit(x, y)          # LIT| [test.py:6] в <module> >>> x: 10, y: 20

# Разные уровни логирования
log("Сервер запущен", level="info")

Установка: pip install litprinter

🕵️ 3. Snoop — автоматический детектив для функций

Добавьте один декоратор — и Snoop распечатает каждую строку кода вместе со значениями всех переменных. Идеально для сложных алгоритмов.

import snoop

@snoop(depth=2)
def factorial(n):
    if n == 1:
        return 1
    return n * factorial(n-1)

factorial(4)

В консоль выведется нечто вроде:

text

14:35:21.29 >>> Call to factorial in test.py (line 5)
14:35:21.29     n = 4
14:35:21.29     | ... if n == 1 ... (line 6)
...

Можно использовать и как контекстный менеджер:

with snoop:
    result = 100 / (50 - 25)

Установка: pip install snoop

🔍 4. Peek — простота и бенчмаркинг

Peek — лёгкая альтернатива с неожиданным бонусом: она умеет замерять время выполнения функций.

import peek

my_var = 42
peek(my_var)     # peek| my_var: 42

@peek()          # обязательно скобки!
def slow(data):
    return sum(data) * 2

slow([1,2,3,4,5]) # выведет called, потом returned ... in 0.000123s

Установка: pip install peek

⚡ 5. q — минимализм и скорость

Библиотека с философией «чем короче, тем лучше». Вместо print() пишете q() — результат уходит в отдельный файл /tmp/q, а в консоли вы видите только ссылку. Но есть и магия: q/выражение прямо в коде.

import q

name = "Alice"
q(name)           # Вывод: 'Alice' (сохранён в /tmp/q, смотри через tail -f)

# Волшебный синтаксис для отладки внутри выражения
result = q/prefix + (sep or '').join(items)  # Покажет prefix

# Открыть интерактивную консоль в любом месте
q.d()

Установка: pip install q

🎭 6. PySnooper — предшественник Snoop

Если Snoop по каким-то причинам не подходит, есть его старший брат. PySnooper делает то же самое: логирует выполнение функции построчно.

import pysnooper

@pysnooper.snoop('/tmp/debug.log')   # можно сохранить в файл
def number_to_bits(number):
    bits = []
    while number:
        number, remainder = divmod(number, 2)
        bits.insert(0, remainder)
    return bits or [0]

number_to_bits(6)

Установка: pip install pysnooper

🧩 7. icecream-truck — для больших проектов

Если вы работаете над приложением, где нужно логировать разные модули с разным уровнем детализации, пригодится эта библиотека. Она расширяет IceCream, добавляя систему «флейворов» и интеграцию со стандартным logging.

from ictruck import install, register_module

install(trace_levels=3)
register_module(prefix="[MY_MODULE]")

# Интеграция с logging
from ictruck.recipes.logging import produce_truck
truck = produce_truck()
truck('warning')('Something went wrong')

Установка: pip install icecream-truck

🎨 8. Rich — визуальный пир

Rich не просто заменяет print(), а открывает целый мир красивой печати: таблицы, панели, живые прогресс-бары, инспекция объектов. Отладка превращается в удовольствие.

from rich.console import Console
from rich.panel import Panel
from rich.progress import track
from rich.table import Table

console = Console()

# Панель с ошибкой
console.print(Panel("[red]Ошибка[/red]: Файл не найден", title="Debug"))

# Таблица с переменными
table = Table(title="Debug Data")
table.add_column("Variable", style="cyan")
table.add_column("Value", style="magenta")
table.add_row("user", "John Doe")
console.print(table)

# Живой прогресс-бар
for i in track(range(100), description="Processing..."):
    pass

Установка: pip install rich

💡 Какую выбрать?

Если нужно…	Берите…
Просто заменить `print()`	IceCream
Красивые трейсбеки и цвета	LitPrinter, Rich
Автоматически отслеживать функции	Snoop, PySnooper
Минимализм и скорость	q, Peek
Гибкость для больших проектов	icecream-truck

Начните с IceCream — он уже сделает вашу жизнь легче. А когда захочется большего, пробуйте остальные. И помните: отладка — это не наказание, а всего лишь поиск приключений в коде. 🚀

🍦 1. IceCream — эволюция print()