Перейти к содержанию

Добро пожаловать в chutils!

chutils — это набор простых утилит для Python, который избавляет от повторяющейся настройки конфигурации, логирования и секретов в ваших проектах.

Эта документация поможет вам быстро освоить все возможности пакета.

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

  • Конфигурация (chutils.config): Автоматический поиск и загрузка конфигурации из config.yml или config.ini. Поддерживает вложенные структуры, относительные пути и переопределение локальными файлами (config.local.yml).

  • Логирование (chutils.logger): Быстрая настройка логгеров с выводом в консоль и ротируемые файлы. Позволяет гибко управлять настройками разных логгеров через конфигурационный файл или переменные окружения.

  • Управление секретами (chutils.secret_manager): Безопасное хранение и получение секретов (API-ключи, пароли) с использованием системной связки ключей (Keyring) и/или .env файлов.

  • Неизменяемый журнал событий (chutils.audit): Неизменяемый журнал аудита. Ведение криптографически защищенного журнала событий безопасности и бизнес-логики с использованием хэш-цепочек.

  • Веб-инструменты (chutils.web, chutils.scraping, chutils.captcha):

    • Умный HTTP-клиент: Клиент с автоматическими повторами запросов, поддержкой прокси и ротацией User-Agent.
    • Имитация поведения: Инструменты для безопасного сбора данных (эмуляция задержек, заголовков).
    • Решение капчи: Интеграция с популярными сервисами автоматического распознавания капчи.

Основные разделы