chutils 2.2.0__tar.gz → 2.3.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chutils
-Version: 2.2.0
+Version: 2.3.0
 Summary: Набор простых и удобных утилит для Python, который избавляет от рутины при работе с конфигурацией и логированием в новых проектах.
 License: MIT
 License-File: LICENSE
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: dotenv (>=0.9.9,<0.10.0)
-Requires-Dist: keyring (>=25.6.0,<26.0.0)
+Requires-Dist: keyring (>=25.7.0,<26.0.0)
 Requires-Dist: python-dotenv (>=1.2.1,<2.0.0)
 Requires-Dist: pyyaml (>=6.0.3,<7.0.0)
 Description-Content-Type: text/markdown
@@ -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.0 → 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.0 → chutils-2.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "chutils"
-version = "2.2.0"
+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/",
@@ -20,11 +21,14 @@ exclude = [
     ".ruff_cache/",
     "coverage.xml",
     ".coverage",
+    "PUBLISHING.md",
+    "project.txt",
+    "changelog.txt",
 ]
 
 [tool.poetry.dependencies]
 python = ">=3.9"
-keyring = "^25.6.0"
+keyring = "^25.7.0"
 pyyaml = "^6.0.3"
 python-dotenv = "^1.2.1"
 dotenv = "^0.9.9"

{chutils-2.2.0 → 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.0 → chutils-2.3.0}/src/chutils/logger.py

@@ -6,6 +6,7 @@
 Директория для логов ('logs') создается автоматически в корне проекта.
 """
 
+import datetime
 import logging
 import logging.handlers
 import os
@@ -214,8 +215,6 @@ logging.setLoggerClass(ChutilsLogger)
 
 # Кэш для пути к директории логов. Изначально пуст.
 _LOG_DIR: Optional[str] = None
-# Глобальный экземпляр основного логгера приложения
-_logger_instance: Optional[ChutilsLogger] = None
 # Флаг, чтобы сообщение об инициализации выводилось только один раз
 _initialization_message_shown = False
 
@@ -273,161 +272,216 @@ 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:
     """
-    Настраивает и возвращает логгер с нужным именем.
+    Настраивает и возвращает логгер с гибким приоритетом конфигурации.
 
-    Функция идемпотентна: она предотвращает повторную настройку уже
-    существующего логгера. Настройки (уровень, имя файла и т.д.) читаются
-    из конфигурационного файла. По умолчанию добавляются обработчики для
-    вывода в консоль и в файл с ежедневной ротацией.
+    Приоритет настроек:
+    1. Явные аргументы, переданные в эту функцию.
+    2. Объединенные настройки из `Logging.loggers.{name}` (если есть) поверх `Logging.default` (если есть).
+    3. Для обратной совместимости: если `Logging.default` и `Logging.loggers` отсутствуют,
+       используются прямые настройки из `Logging` (как в старом формате).
+    4. Значения по умолчанию, зашитые в коде.
 
     Args:
-        name: Имя логгера. `app_logger` используется для основного логгера
-            приложения и его экземпляр кэшируется.
-        log_level: Явное указание уровня логирования. Если не задан,
-            значение берется из конфигурационного файла, а если и там нет -
-            используется 'INFO'.
-        log_file_name: Опциональное имя файла для логирования. Если указано,
-            логгер будет писать в этот файл. Если не указано, имя файла
-            берется из конфигурационного файла ('Logging', 'log_file_name').
+        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' (по размеру файла).
-        max_bytes: Максимальный размер файла лога в байтах перед ротацией,
-                   если `rotation_type` установлен в 'size'. По умолчанию 0 (без лимита).
-        compress: Если True, ротированные файлы логов будут сжиматься в формат .gz.
-                  По умолчанию False.
-        backup_count: Количество хранимых ротированных файлов логов.
-                      Старые файлы будут удаляться. По умолчанию 3.
+        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:
-       logging.Logger: Настроенный экземпляр ChutilsLogger.
+       Настроенный экземпляр ChutilsLogger.
     """
-    global _logger_instance, _initialization_message_shown
-    logging.debug(
-        "Вызов setup_logger() для логгера '%s'. log_file_name: %s, force_reconfigure: %s",
-        name,
-        log_file_name,
-        force_reconfigure
-    )
-
-    # Если логгер с таким именем уже имеет обработчики, значит он настроен.
-    # Просто возвращаем его, чтобы не дублировать вывод.
-    existing_logger = logging.getLogger(name)
-    if existing_logger.hasHandlers() and not force_reconfigure:
-        logging.debug("Логгер '%s' уже настроен, возвращаем существующий экземпляр.", name)
-        return existing_logger  # type: ignore
-
-    # Если требуется принудительная перенастройка, очищаем старые обработчики
-    if force_reconfigure:
-        logging.debug("Принудительная перенастройка для '%s'. Удаление старых обработчиков...", name)
-        for handler in existing_logger.handlers[:]:
-            handler.close()  # Закрываем файлы, если они были открыты
-            existing_logger.removeHandler(handler)
+    global _initialization_message_shown
+    logger = logging.getLogger(name)
+    cfg = config.get_config()
 
-    # Если запрашивается основной логгер приложения и он уже есть в кэше.
-    if name == 'app_logger' and _logger_instance:
-        logging.debug("Возвращаем кэшированный основной логгер.")
-        return _logger_instance
+    # --- Определение словаря настроек для данного логгера ---
+    # По умолчанию используем секцию [Logging]
+    default_settings = cfg.get('Logging', {})
 
-    # Получаем директорию для логов. Это первая точка, где запускается вся магия поиска путей.
-    log_dir = _get_log_dir()
-    logging.debug("setup_logger() получил log_dir: %s", log_dir)
+    # Если указана специфичная секция, ее настройки переопределяют дефолтные
+    specific_settings = {}
+    if config_section_name:
+        specific_settings = cfg.get(config_section_name, {})
 
-    # Загружаем конфигурацию для получения настроек логирования.
-    cfg = config.get_config()
+    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:
+        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
 
-    # Определяем уровень логирования
-    if log_level is None:
-        level_from_config = config.get_config_value('Logging', 'log_level', 'INFO', cfg)
-        try:
-            log_level = LogLevel(level_from_config.upper())
-        except ValueError:
-            log_level = LogLevel.INFO
-
-    level_int = getattr(logging, log_level.value, logging.INFO)
-    existing_logger.setLevel(level_int)
-    logging.debug("Уровень логирования для '%s' установлен на: %s (%s)", name, log_level.value, level_int)
-
-    # Определяем имя файла лога
-    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)
-
-    # Определяем параметры ротации
-    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)
-
-    # Создаем и настраиваем новый экземпляр логгера
-    logger = existing_logger
     logger.setLevel(level_int)
+    logger.propagate = False
+    logging.debug("Уровень логирования для '%s' установлен на: %s (%s)", name, log_level_enum.value, level_int)
+
+    # --- Настройка обработчиков (только при необходимости) ---
+    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)
+
+    # --- Определение параметров на основе приоритетов ---
+    # Приоритет: аргумент функции > настройки из конфига > жестко заданное значение
+    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
+
+    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')
 
-    # Обработчик для вывода в консоль (StreamHandler)
     console_handler = logging.StreamHandler()
     console_handler.setFormatter(formatter)
     logger.addHandler(console_handler)
 
-    # Обработчик для записи в файл (TimedRotatingFileHandler)
-    # Добавляем его, только если директория логов была успешно определена.
-    if log_dir and log_file_name:
-        # ЕСЛИ ПУТЬ ПЕРЕДАН ЯВНО И ОН АБСОЛЮТНЫЙ, ИСПОЛЬЗУЕМ ЕГО
-        # Это нужно для нашего отладочного теста, который работает во временной папке
-        if Path(log_file_name).is_absolute():
-            log_file_path = Path(log_file_name)
-        else:
-            log_file_path = 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.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:
             logger.error("Не удалось настроить файловый обработчик логов для %s: %s", log_file_path, e)
-    else:
-        if not _initialization_message_shown:
-            logger.warning("Директория для логов не настроена. Файловое логирование отключено.")
-            _initialization_message_shown = True
-
-    # Кэшируем основной логгер приложения
-    if name == 'app_logger':
-        _logger_instance = logger
+    elif not _initialization_message_shown:
+        logger.warning("Директория для логов не настроена. Файловое логирование отключено.")
+        _initialization_message_shown = True
 
     return logger  # type: ignore