chutils 2.2.1__tar.gz → 2.3.0__tar.gz

{chutils-2.2.1 → chutils-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chutils
-Version: 2.2.1
+Version: 2.3.0
 Summary: Набор простых и удобных утилит для Python, который избавляет от рутины при работе с конфигурацией и логированием в новых проектах.
 License: MIT
 License-File: LICENSE
@@ -49,7 +49,8 @@ Description-Content-Type: text/markdown
 ## Ключевые возможности
 
 - **✨ Ноль конфигурации:** Библиотека **автоматически** находит корень вашего проекта и файл `config.yml` или
-  `config.ini`. Если файл не найден, используются безопасные настройки по умолчанию (например, логирование только в консоль).
+  `config.ini`. Если файл не найден, используются безопасные настройки по умолчанию (например, логирование только в
+  консоль).
 - **⚙️ Гибкая конфигурация:** Поддержка `YAML` и `INI` форматов. Простые функции для получения типизированных данных.
 - **✍️ Продвинутый логгер:** Функция `setup_logger()` "из коробки" настраивает логирование в консоль и в ротируемые
   файлы. Возвращает кастомный логгер с дополнительными уровнями отладки (`devdebug`, `mediumdebug`).
@@ -86,7 +87,8 @@ pip install -e .
 
 ### 1. Работа с конфигурацией
 
-1. (Опционально) Создайте файл `config.yml` в корне вашего проекта. Если этого не сделать, библиотека будет использовать настройки по умолчанию:
+1. (Опционально) Создайте файл `config.yml` в корне вашего проекта. Если этого не сделать, библиотека будет использовать
+   настройки по умолчанию:
 
    ```yaml
    # config.yml
@@ -115,8 +117,9 @@ pip install -e .
    Вы можете создать локальный файл конфигурации (например, `config.local.yml` или `config.local.ini`) рядом с основным
    файлом (`config.yml` или `config.ini`). Значения из локального файла будут **переопределять** соответствующие
    значения из основного файла. Это удобно для:
-   - Хранения чувствительных данных, которые не должны попадать в систему контроля версий (добавьте `config.local.yml` в `.gitignore`).
-   - Переопределения настроек для локальной разработки без изменения основного файла.
+    - Хранения чувствительных данных, которые не должны попадать в систему контроля версий (добавьте `config.local.yml`
+      в `.gitignore`).
+    - Переопределения настроек для локальной разработки без изменения основного файла.
 
    Пример:
    Если `config.yml` содержит:
@@ -188,7 +191,8 @@ pip install -e .
 
    #### Создание нескольких логгеров
 
-   Вы можете создавать разные логгеры для разных частей вашего приложения, передавая уникальное имя в `setup_logger`. Это
+   Вы можете создавать разные логгеры для разных частей вашего приложения, передавая уникальное имя в `setup_logger`.
+   Это
    помогает фильтровать и разделять логи.
 
    ```python
@@ -206,12 +210,46 @@ pip install -e .
    В лог-файлах вы увидите сообщения от соответствующих логгеров.
    Более подробный пример можно найти в [`/examples/05_different_log_levels.py`](./examples/05_different_log_levels.py).
 
+   #### Конфигурация нескольких логгеров через файл
+
+   Вы можете централизованно управлять настройками разных логгеров, используя параметр `config_section_name`.
+
+    1. **Добавьте секции в `config.yml`**:
+       Секция `[Logging]` используется для настроек по умолчанию. Остальные секции можно использовать для специфичных
+       логгеров.
+       ```yaml
+       # config.yml
+       Logging:
+         log_level: INFO
+         rotation_type: time
+         compress: true
+ 
+       AuditLogger:
+         log_level: DEBUG
+         log_file_name: "audit.log"
+       ```
+
+    2. **Используйте `config_section_name` в коде**:
+       ```python
+       # main.py
+       from chutils import setup_logger
+ 
+       # Этот логгер возьмет настройки из секции [Logging]
+       main_logger = setup_logger("main")
+       main_logger.info("Сообщение от основного логгера.")
+ 
+       # А этот логгер - из секции [AuditLogger], которая переопределит настройки из [Logging]
+       audit_logger = setup_logger("audit", config_section_name="AuditLogger")
+       audit_logger.debug("Детальное сообщение для аудита.")
+       ```
+
 ### 3. Управление секретами
 
 `SecretManager` ищет секреты в следующем порядке:
-1.  **Системное хранилище (`keyring`)**: Наиболее безопасный способ.
-2.  **Файл `.env`**: Если секрет не найден в `keyring`, менеджер будет искать его в файле `.env` в корне вашего проекта.
-3.  **Переменные окружения**: Если секрета нет и там, будет произведен поиск в переменных окружения ОС.
+
+1. **Системное хранилище (`keyring`)**: Наиболее безопасный способ.
+2. **Файл `.env`**: Если секрет не найден в `keyring`, менеджер будет искать его в файле `.env` в корне вашего проекта.
+3. **Переменные окружения**: Если секрета нет и там, будет произведен поиск в переменных окружения ОС.
 
 #### Способ 1: Keyring (рекомендуемый)
 
@@ -345,7 +383,8 @@ pip install -e .
 
 - `setup_logger(name='app_logger', log_level_str='')`: Настраивает и возвращает экземпляр `ChutilsLogger`.
 - `logger.mediumdebug("message")`: Логирование с уровнем 15. Промежуточный уровень между `DEBUG` и `INFO`.
-- `logger.devdebug("message")`: Логирование с уровнем 9. Самый подробный уровень для глубокой отладки (например, для вывода дампов переменных).
+- `logger.devdebug("message")`: Логирование с уровнем 9. Самый подробный уровень для глубокой отладки (например, для
+  вывода дампов переменных).
 
 ### Управление секретами (`chutils.secret_manager`)
 

{chutils-2.2.1 → chutils-2.3.0}/README.md

@@ -26,7 +26,8 @@
 ## Ключевые возможности
 
 - **✨ Ноль конфигурации:** Библиотека **автоматически** находит корень вашего проекта и файл `config.yml` или
-  `config.ini`. Если файл не найден, используются безопасные настройки по умолчанию (например, логирование только в консоль).
+  `config.ini`. Если файл не найден, используются безопасные настройки по умолчанию (например, логирование только в
+  консоль).
 - **⚙️ Гибкая конфигурация:** Поддержка `YAML` и `INI` форматов. Простые функции для получения типизированных данных.
 - **✍️ Продвинутый логгер:** Функция `setup_logger()` "из коробки" настраивает логирование в консоль и в ротируемые
   файлы. Возвращает кастомный логгер с дополнительными уровнями отладки (`devdebug`, `mediumdebug`).
@@ -63,7 +64,8 @@ pip install -e .
 
 ### 1. Работа с конфигурацией
 
-1. (Опционально) Создайте файл `config.yml` в корне вашего проекта. Если этого не сделать, библиотека будет использовать настройки по умолчанию:
+1. (Опционально) Создайте файл `config.yml` в корне вашего проекта. Если этого не сделать, библиотека будет использовать
+   настройки по умолчанию:
 
    ```yaml
    # config.yml
@@ -92,8 +94,9 @@ pip install -e .
    Вы можете создать локальный файл конфигурации (например, `config.local.yml` или `config.local.ini`) рядом с основным
    файлом (`config.yml` или `config.ini`). Значения из локального файла будут **переопределять** соответствующие
    значения из основного файла. Это удобно для:
-   - Хранения чувствительных данных, которые не должны попадать в систему контроля версий (добавьте `config.local.yml` в `.gitignore`).
-   - Переопределения настроек для локальной разработки без изменения основного файла.
+    - Хранения чувствительных данных, которые не должны попадать в систему контроля версий (добавьте `config.local.yml`
+      в `.gitignore`).
+    - Переопределения настроек для локальной разработки без изменения основного файла.
 
    Пример:
    Если `config.yml` содержит:
@@ -165,7 +168,8 @@ pip install -e .
 
    #### Создание нескольких логгеров
 
-   Вы можете создавать разные логгеры для разных частей вашего приложения, передавая уникальное имя в `setup_logger`. Это
+   Вы можете создавать разные логгеры для разных частей вашего приложения, передавая уникальное имя в `setup_logger`.
+   Это
    помогает фильтровать и разделять логи.
 
    ```python
@@ -183,12 +187,46 @@ pip install -e .
    В лог-файлах вы увидите сообщения от соответствующих логгеров.
    Более подробный пример можно найти в [`/examples/05_different_log_levels.py`](./examples/05_different_log_levels.py).
 
+   #### Конфигурация нескольких логгеров через файл
+
+   Вы можете централизованно управлять настройками разных логгеров, используя параметр `config_section_name`.
+
+    1. **Добавьте секции в `config.yml`**:
+       Секция `[Logging]` используется для настроек по умолчанию. Остальные секции можно использовать для специфичных
+       логгеров.
+       ```yaml
+       # config.yml
+       Logging:
+         log_level: INFO
+         rotation_type: time
+         compress: true
+ 
+       AuditLogger:
+         log_level: DEBUG
+         log_file_name: "audit.log"
+       ```
+
+    2. **Используйте `config_section_name` в коде**:
+       ```python
+       # main.py
+       from chutils import setup_logger
+ 
+       # Этот логгер возьмет настройки из секции [Logging]
+       main_logger = setup_logger("main")
+       main_logger.info("Сообщение от основного логгера.")
+ 
+       # А этот логгер - из секции [AuditLogger], которая переопределит настройки из [Logging]
+       audit_logger = setup_logger("audit", config_section_name="AuditLogger")
+       audit_logger.debug("Детальное сообщение для аудита.")
+       ```
+
 ### 3. Управление секретами
 
 `SecretManager` ищет секреты в следующем порядке:
-1.  **Системное хранилище (`keyring`)**: Наиболее безопасный способ.
-2.  **Файл `.env`**: Если секрет не найден в `keyring`, менеджер будет искать его в файле `.env` в корне вашего проекта.
-3.  **Переменные окружения**: Если секрета нет и там, будет произведен поиск в переменных окружения ОС.
+
+1. **Системное хранилище (`keyring`)**: Наиболее безопасный способ.
+2. **Файл `.env`**: Если секрет не найден в `keyring`, менеджер будет искать его в файле `.env` в корне вашего проекта.
+3. **Переменные окружения**: Если секрета нет и там, будет произведен поиск в переменных окружения ОС.
 
 #### Способ 1: Keyring (рекомендуемый)
 
@@ -322,7 +360,8 @@ pip install -e .
 
 - `setup_logger(name='app_logger', log_level_str='')`: Настраивает и возвращает экземпляр `ChutilsLogger`.
 - `logger.mediumdebug("message")`: Логирование с уровнем 15. Промежуточный уровень между `DEBUG` и `INFO`.
-- `logger.devdebug("message")`: Логирование с уровнем 9. Самый подробный уровень для глубокой отладки (например, для вывода дампов переменных).
+- `logger.devdebug("message")`: Логирование с уровнем 9. Самый подробный уровень для глубокой отладки (например, для
+  вывода дампов переменных).
 
 ### Управление секретами (`chutils.secret_manager`)
 

{chutils-2.2.1 → chutils-2.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "chutils"
-version = "2.2.1"
+version = "2.3.0"
 description = "Набор простых и удобных утилит для Python, который избавляет от рутины при работе с конфигурацией и логированием в новых проектах."
 authors = ["Chu4hel <sergeiivanov636@gmail.com>"]
 license = "MIT"
@@ -8,6 +8,7 @@ readme = "README.md"
 packages = [{ include = "chutils", from = "src" }]
 exclude = [
     "tests/",
+    "site/",
     "examples/",
     "docs/",
     ".github/",

{chutils-2.2.1 → chutils-2.3.0}/src/chutils/config.py

@@ -181,18 +181,56 @@ def _load_yaml(path: str) -> Dict:
         return {}
 
 
+def _nest_ini_dict(flat_dict: Dict[str, Dict[str, Any]]) -> Dict:
+    """
+    Преобразует плоский словарь INI-секций (с точками в именах секций)
+    во вложенную структуру словарей.
+    Например: {'Logging.default': {'key': 'value'}} -> {'Logging': {'default': {'key': 'value'}}}
+    """
+    nested_dict = {}
+    for section_key, section_values in flat_dict.items():
+        current_level = nested_dict
+        parts = section_key.split('.')
+        for i, part in enumerate(parts):
+            if i == len(parts) - 1: # Последняя часть - это название секции
+                current_level[part] = section_values
+            else:
+                current_level = current_level.setdefault(part, {})
+    return nested_dict
+
+
 def _load_ini(path: str) -> Dict:
     """Загружает и парсит INI-файл."""
     try:
         with open(path, 'r', encoding='utf-8') as f:
             parser = configparser.ConfigParser()
             parser.read_string(f.read())
-            return {s: dict(parser.items(s)) for s in parser.sections()}
+            flat_ini_config = {s: dict(parser.items(s)) for s in parser.sections()}
+            # Преобразуем плоскую структуру вложенных секций в иерархическую
+            return _nest_ini_dict(flat_ini_config)
     except (configparser.Error, FileNotFoundError) as e:
         logger.critical("Ошибка чтения INI файла конфигурации %s: %s", path, e)
         return {}
 
 
+def _nest_ini_dict(flat_dict: Dict[str, Dict[str, Any]]) -> Dict:
+    """
+    Преобразует плоский словарь INI-секций (с точками в именах секций)
+    во вложенную структуру словарей.
+    Например: {'Logging.default': {'key': 'value'}} -> {'Logging': {'default': {'key': 'value'}}}
+    """
+    nested_dict = {}
+    for section_key, section_values in flat_dict.items():
+        current_level = nested_dict
+        parts = section_key.split('.')
+        for i, part in enumerate(parts):
+            if i == len(parts) - 1: # Последняя часть - это название секции
+                current_level[part] = section_values
+            else:
+                current_level = current_level.setdefault(part, {})
+    return nested_dict
+
+
 def save_config_value(
         section: str,
         key: str,

{chutils-2.2.1 → chutils-2.3.0}/src/chutils/logger.py

@@ -6,6 +6,7 @@
 Директория для логов ('logs') создается автоматически в корне проекта.
 """
 
+import datetime
 import logging
 import logging.handlers
 import os
@@ -271,120 +272,210 @@ def _get_log_dir() -> Optional[str]:
 
 def setup_logger(
         name: str = 'app_logger',
+        config_section_name: Optional[str] = None,
         log_level: Optional[LogLevel] = None,
         log_file_name: Optional[str] = None,
         force_reconfigure: bool = False,
-        rotation_type: str = 'time',
-        max_bytes: int = 0,
-        compress: bool = False,
-        backup_count: int = 3
+        rotation_type: Optional[str] = None,
+        max_bytes: Optional[int] = None,
+        compress: Optional[bool] = None,
+        backup_count: Optional[int] = None,
+        encoding: Optional[str] = None,
+        when: Optional[str] = None,
+        interval: Optional[int] = None,
+        utc: Optional[bool] = None,
+        at_time: Optional[datetime.time] = None,
+        **kwargs: Any
 ) -> ChutilsLogger:
     """
-    Настраивает и возвращает логгер, всегда обновляя его уровень.
+    Настраивает и возвращает логгер с гибким приоритетом конфигурации.
 
-    При первом вызове для логгера с указанным именем она настраивает его
-    обработчики (для консоли и файла). При последующих вызовах она только
-    обновляет уровень логирования, не трогая обработчики, если не указан
-    `force_reconfigure=True`.
+    Приоритет настроек:
+    1. Явные аргументы, переданные в эту функцию.
+    2. Объединенные настройки из `Logging.loggers.{name}` (если есть) поверх `Logging.default` (если есть).
+    3. Для обратной совместимости: если `Logging.default` и `Logging.loggers` отсутствуют,
+       используются прямые настройки из `Logging` (как в старом формате).
+    4. Значения по умолчанию, зашитые в коде.
 
     Args:
         name: Имя логгера. `app_logger` используется как стандартное имя.
+        config_section_name: Имя специфичной секции в конфиге (например, 'MyAuditLogger').
+            Если указана, настройки из этой секции переопределяют настройки из общей секции `[Logging]`.
+            Если не указана, используется только общая секция `[Logging]`.
         log_level: Явное указание уровня логирования (строкой или LogLevel).
                    Если не задан, значение берется из конфигурационного файла.
         log_file_name: Имя файла для логирования. Если не указано, имя берется
                        из конфигурации ('Logging', 'log_file_name').
         force_reconfigure: Если True, принудительно удаляет все существующие
                            обработчики и настраивает логгер заново.
-        rotation_type: Тип ротации: 'time' (ежедневная) или 'size'.
+        rotation_type: Тип ротации: 'time' или 'size'.
         max_bytes: Максимальный размер файла для ротации по 'size'.
         compress: Сжимать ли ротированные логи в .gz.
         backup_count: Количество хранимых ротированных файлов.
+        encoding: Кодировка файла (по умолчанию 'utf-8').
+        when: Для 'time'. Тип интервала ('S', 'M', 'H', 'D', 'midnight', 'W0'-'W6').
+        interval: Для 'time'. Длина интервала.
+        utc: Для 'time'. Использовать UTC время.
+        at_time: Для 'time'. Время ротации (при when='midnight').
+
+        **kwargs: Дополнительные параметры для FileHandler (например, `delay=True`, `errors='ignore'`, `mode='a'`).
 
     Returns:
        Настроенный экземпляр ChutilsLogger.
     """
     global _initialization_message_shown
     logger = logging.getLogger(name)
+    cfg = config.get_config()
 
-    # --- 1. Определение и установка уровня логирования ---
-    # Этот блок выполняется всегда, чтобы уровень можно было изменить в любой момент.
-    cfg = config.get_config()  # Загружаем конфигурацию
+    # --- Определение словаря настроек для данного логгера ---
+    # По умолчанию используем секцию [Logging]
+    default_settings = cfg.get('Logging', {})
 
-    log_level_enum: LogLevel
-    if isinstance(log_level, str):
-        try:
-            log_level_enum = LogLevel(log_level.upper())
-        except ValueError:
-            log_level_enum = LogLevel.INFO
-    elif log_level is None:
-        level_from_config = config.get_config_value('Logging', 'log_level', 'INFO', cfg)
-        try:
-            log_level_enum = LogLevel(level_from_config.upper())
-        except ValueError:
-            log_level_enum = LogLevel.INFO
+    # Если указана специфичная секция, ее настройки переопределяют дефолтные
+    specific_settings = {}
+    if config_section_name:
+        specific_settings = cfg.get(config_section_name, {})
+
+    final_logger_settings = {**default_settings, **specific_settings}
+
+    # --- 1. Определение и установка уровня логирования ---
+    # Приоритет: аргумент функции > настройки из конфига > 'INFO'
+    final_log_level_str: str
+    if log_level is not None:
+        final_log_level_str = log_level.value if isinstance(log_level, LogLevel) else str(log_level).upper()
     else:
-        log_level_enum = log_level
+        level_val = final_logger_settings.get('log_level', 'INFO')
+        final_log_level_str = str(level_val).upper()
+
+    try:
+        log_level_enum = LogLevel(final_log_level_str)
+        level_int = getattr(logging, log_level_enum.value, logging.INFO)
+    except ValueError:
+        log_level_enum = LogLevel.INFO
+        level_int = logging.INFO
 
-    level_int = getattr(logging, log_level_enum.value, logging.INFO)
     logger.setLevel(level_int)
     logger.propagate = False
     logging.debug("Уровень логирования для '%s' установлен на: %s (%s)", name, log_level_enum.value, level_int)
 
-    # --- 2. Настройка обработчиков (только при необходимости) ---
+    # --- Настройка обработчиков (только при необходимости) ---
     if logger.hasHandlers() and not force_reconfigure:
         logging.debug("Обработчики для логгера '%s' уже настроены. Пропускаем настройку.", name)
         return logger  # type: ignore
 
-    # Если требуется принудительная перенастройка, очищаем старые обработчики
     if force_reconfigure:
         logging.debug("Принудительная перенастройка для '%s'. Удаление старых обработчиков...", name)
         for handler in logger.handlers[:]:
             handler.close()
             logger.removeHandler(handler)
 
-    # Получаем директорию для логов.
-    log_dir = _get_log_dir()
-    logging.debug("setup_logger() получил log_dir: %s", log_dir)
-
-    # Определяем имя файла лога
-    if log_file_name is None:
-        log_file_name = config.get_config_value('Logging', 'log_file_name', 'app.log', cfg)
-    logging.debug("Имя файла лога для '%s' определено как: %s", name, log_file_name)
+    # --- Определение параметров на основе приоритетов ---
+    # Приоритет: аргумент функции > настройки из конфига > жестко заданное значение
+    final_log_file_name = log_file_name if log_file_name is not None else final_logger_settings.get('log_file_name',
+                                                                                                    'app.log')
+    final_rotation_type = rotation_type if rotation_type is not None else final_logger_settings.get('rotation_type',
+                                                                                                    'time')
+
+    # Для типизированных значений нужна безопасная обработка
+    try:
+        max_bytes_from_config = int(final_logger_settings.get('max_bytes', 5 * 1024 * 1024))
+    except (ValueError, TypeError):
+        max_bytes_from_config = 5 * 1024 * 1024
+    final_max_bytes = max_bytes if max_bytes is not None else max_bytes_from_config
+
+    compress_val = final_logger_settings.get('compress', False)
+    if isinstance(compress_val, str):
+        compress_from_config = compress_val.lower() in ['true', '1', 't', 'y', 'yes']
+    else:
+        compress_from_config = bool(compress_val)
+    final_compress = compress if compress is not None else compress_from_config
+
+    try:
+        backup_count_from_config = int(final_logger_settings.get('log_backup_count', 3))
+    except (ValueError, TypeError):
+        backup_count_from_config = 3
+    final_backup_count = backup_count if backup_count is not None else backup_count_from_config
+
+    final_encoding = encoding if encoding is not None else final_logger_settings.get('encoding', 'utf-8')
+    final_when = when if when is not None else final_logger_settings.get('when', 'D')
+
+    try:
+        interval_from_config = int(final_logger_settings.get('interval', 1))
+    except (ValueError, TypeError):
+        interval_from_config = 1
+    final_interval = interval if interval is not None else interval_from_config
+
+    utc_val = final_logger_settings.get('utc', False)
+    if isinstance(utc_val, str):
+        utc_from_config = utc_val.lower() in ['true', '1', 't', 'y', 'yes']
+    else:
+        utc_from_config = bool(utc_val)
+    final_utc = utc if utc is not None else utc_from_config
 
-    # Определяем параметры ротации
-    rotation_type = config.get_config_value('Logging', 'rotation_type', rotation_type, cfg)
-    max_bytes = config.get_config_int('Logging', 'max_bytes', max_bytes, cfg)
-    compress = config.get_config_boolean('Logging', 'compress', compress, cfg)
-    backup_count = config.get_config_int('Logging', 'log_backup_count', 3, cfg)
+    final_at_time = at_time if at_time is not None else final_logger_settings.get('at_time', None)
 
+    # --- 4. Настройка обработчиков ---
+    log_dir = _get_log_dir()
     formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
 
-    # Обработчик для вывода в консоль
     console_handler = logging.StreamHandler()
     console_handler.setFormatter(formatter)
     logger.addHandler(console_handler)
 
-    # Обработчик для записи в файл
-    if log_dir and log_file_name:
-        log_file_path = Path(log_file_name) if Path(log_file_name).is_absolute() else Path(log_dir) / log_file_name
+    if log_dir and final_log_file_name:
+        log_file_path = Path(final_log_file_name) if Path(
+            final_log_file_name).is_absolute() else Path(log_dir) / final_log_file_name
         logging.debug("Попытка настроить файловый обработчик для %s в %s", name, log_file_path)
         try:
             file_handler: Optional[logging.FileHandler] = None
-            if rotation_type == 'size':
-                handler_class = CompressingRotatingFileHandler if compress else logging.handlers.RotatingFileHandler
-                file_handler = handler_class(log_file_path, maxBytes=max_bytes, backupCount=backup_count, encoding='utf-8')
+            common_kwargs = {
+                'encoding': final_encoding,
+                'backupCount': final_backup_count,
+            }
+            common_kwargs.update(kwargs)
+
+            if final_rotation_type == 'size':
+                handler_class = CompressingRotatingFileHandler if final_compress else logging.handlers.RotatingFileHandler
+                rotation_kwargs = {'maxBytes': final_max_bytes}
+                final_kwargs = {**common_kwargs, **rotation_kwargs}
+                file_handler = handler_class(str(log_file_path), **final_kwargs)
             else:  # 'time'
-                handler_class = CompressingTimedRotatingFileHandler if compress else SafeTimedRotatingFileHandler
-                file_handler = handler_class(log_file_path, when="D", interval=1, backupCount=backup_count, encoding='utf-8')
+                handler_class = CompressingTimedRotatingFileHandler if final_compress else SafeTimedRotatingFileHandler
+
+                rotation_kwargs = {
+                    'when': final_when,
+                    'interval': final_interval,
+                    'utc': final_utc,
+                }
+                # `at_time` может быть строкой из конфига, нужно преобразовать
+                if isinstance(final_at_time, str):
+                    try:
+                        final_at_time = datetime.time.fromisoformat(final_at_time)
+                    except (TypeError, ValueError):
+                        logger.error(
+                            "Неверный формат времени '%s' для 'at_time' в конфиге. Используется None.", final_at_time)
+                        final_at_time = None
+
+                if final_at_time is not None:
+                    rotation_kwargs['atTime'] = final_at_time
+
+                final_kwargs = {**common_kwargs, **rotation_kwargs}
+
+                file_handler = handler_class(str(log_file_path), **final_kwargs)
 
             if file_handler:
                 file_handler.setFormatter(formatter)
                 logger.addHandler(file_handler)
 
                 if not _initialization_message_shown:
+                    info_msg = "."
+                    if final_rotation_type == 'time':
+                        info_msg = f", интервал: {final_interval}{final_when}"
+                    else:
+                        info_msg = f", макс. размер: {final_max_bytes}"
                     logger.debug(
-                        "Логирование настроено. Уровень: %s. Файл: %s, ротация: %s, сжатие: %s.",
-                        log_level_enum.value, log_file_path, rotation_type, compress
+                        "Логирование настроено. Уровень: %s. Файл: %s, ротация: %s, сжатие: %s%s",
+                        log_level_enum.value, log_file_path, final_rotation_type, final_compress, info_msg
                     )
                     _initialization_message_shown = True
         except Exception as e: