Какие знаешь способы для печати в stderr?

Способы печати в stderr на Python

Вывод в стандартный поток ошибок (stderr) — критический навык для продакшена. Это отличает нормальный логирующий код от кода с захардкоженным выводом, который попадает в stdout.

1. Функция print() с параметром file

Самый простой и читаемый способ:

import sys

print("Это ошибка!", file=sys.stderr)
print(f"Ошибка: {error_message}", file=sys.stderr)

# Несколько аргументов
print("Error:", error_code, error_message, file=sys.stderr)

# С кастомным separatором
print(error_code, error_message, sep=" | ", file=sys.stderr)

Это работает потому что sys.stderr — это файловый объект.

2. Прямой доступ к sys.stderr

Ниже-уровневый способ, когда нужен больше контроль:

import sys

sys.stderr.write("Это сообщение об ошибке\\n")
sys.stderr.flush()  # Важно! Иначе буфер может не вывести

# Без автоматического добавления \\n
sys.stderr.write(f"Error {error_code}: {message}")
sys.stderr.write("\\n")
sys.stderr.flush()

Важно помнить: write() не добавляет автоматически перевод строки, как print().

3. Модуль logging (рекомендуемый способ)

Для production-кода нужно использовать логирование:

import logging

# Минимальная настройка
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)

logger = logging.getLogger(__name__)

# Логирование в stderr (по умолчанию)
logger.error("Это критическая ошибка")
logger.warning("Это предупреждение")
logger.info("Информационное сообщение")
logger.debug("Debug информация")

По умолчанию logging пишет в stderr. Это самый профессиональный подход.

4. Кастомный обработчик логирования

Для большего контроля над форматированием:

import logging
import sys

# Создать логгер
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

# Обработчик для stderr
stderr_handler = logging.StreamHandler(sys.stderr)
stderr_handler.setLevel(logging.ERROR)

# Форматтер
formatter = logging.Formatter(
    "%(asctime)s - %(levelname)s - %(message)s"
)
stderr_handler.setFormatter(formatter)

# Подключить обработчик
logger.addHandler(stderr_handler)

logger.error("Ошибка в приложении")

5. Контекстный менеджер для перенаправления

Времененное перенаправление вывода:

import sys
from io import StringIO

# Сохранить оригинальный stderr
original_stderr = sys.stderr

# Перенаправить в буфер
sys.stderr = StringIO()

try:
    # Код здесь пишет в stderr
    print("Это будет в буфере", file=sys.stderr)
    error_output = sys.stderr.getvalue()
finally:
    # Восстановить оригинальный stderr
    sys.stderr = original_stderr
    print(f"Перехвачено: {error_output}")

Используется в тестах для проверки вывода.

6. Использование контекстного менеджера contextlib

Елегантный способ перенаправления:

import sys
import contextlib
from io import StringIO

@contextlib.contextmanager
def capture_stderr():
    old_stderr = sys.stderr
    sys.stderr = StringIO()
    try:
        yield sys.stderr
    finally:
        sys.stderr = old_stderr

# Использование
with capture_stderr() as stderr:
    print("Ошибка", file=sys.stderr)
    error_text = stderr.getvalue()
    print(f"Перехвачено: {error_text}")

7. Тестирование вывода с pytest

В тестах часто проверяют stderr:

import sys
import pytest

def test_error_message(capsys):
    """capsys — встроенный фикстур pytest"""
    print("Ошибка", file=sys.stderr)
    
    captured = capsys.readouterr()
    assert captured.err == "Ошибка\\n"

def test_with_caplog(caplog):
    """Проверка логирования"""
    logger = logging.getLogger()
    logger.error("Критическая ошибка")
    
    assert "Критическая ошибка" in caplog.text

8. Цветной вывод в stderr

Для удобства разработки можно добавить цвета:

import sys

class Colors:
    RED = "\\033[91m"
    YELLOW = "\\033[93m"
    RESET = "\\033[0m"

def error(msg: str):
    print(f"{Colors.RED}ERROR: {msg}{Colors.RESET}", file=sys.stderr)

def warning(msg: str):
    print(f"{Colors.YELLOW}WARNING: {msg}{Colors.RESET}", file=sys.stderr)

# Использование
error("Критическая ошибка")
warning("Предупреждение")

Или использовать библиотеку colorama:

from colorama import Fore, init
import sys

init()

print(f"{Fore.RED}Ошибка!{Fore.RESET}", file=sys.stderr)
print(f"{Fore.YELLOW}Предупреждение{Fore.RESET}", file=sys.stderr)

Сравнение подходов

Best Practice

• В production: используй logging.Logger
• В скриптах: используй print(..., file=sys.stderr)
• В тестах: используй capsys или caplog от pytest
• Всегда помни: обычный print() пишет в stdout, а не stderr!