archive_exports rework

superset_tool/utils/logger.py

@@ -1,9 +1,18 @@
-# utils/logger.py
+# [MODULE] Superset Tool Logger Utility
+# @contract: Этот модуль предоставляет утилиту для настройки логирования в приложении.
+# @semantic_layers:
+#   - [CONFIG]: Настройка логгера.
+#   - [UTILITY]: Вспомогательные функции.
+# @coherence: Модуль должен быть семантически когерентен со стандартной библиотекой `logging`.
+
 import logging
+import sys
 from datetime import datetime
 from pathlib import Path
 from typing import Optional
 
+# [CONSTANTS]
+
 class SupersetLogger:
     def __init__(
         self,
@@ -59,3 +68,38 @@ class SupersetLogger:
 
     def exception(self, message: str):
         self.logger.exception(message)
+
+def setup_logger(name: str, level: int = logging.INFO) -> logging.Logger:
+    # [FUNCTION] setup_logger
+    # [CONTRACT]
+    """
+    Настраивает и возвращает логгер с заданным именем и уровнем.
+
+    @pre:
+        - `name` является непустой строкой.
+        - `level` является допустимым уровнем логирования из модуля `logging`.
+    @post:
+        - Возвращает настроенный экземпляр `logging.Logger`.
+        - Логгер имеет StreamHandler, выводящий в sys.stdout.
+        - Форматтер логгера включает время, уровень, имя и сообщение.
+    @side_effects:
+        - Создает и добавляет StreamHandler к логгеру.
+    @invariant:
+        - Логгер с тем же именем всегда возвращает один и тот же экземпляр.
+    """
+    # [CONFIG] Настройка логгера
+    # [COHERENCE_CHECK_PASSED] Логика настройки соответствует описанию.
+    logger = logging.getLogger(name)
+    logger.setLevel(level)
+
+    # Создание форматтера
+    formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(name)s - %(message)s')
+
+    # Проверка наличия существующих обработчиков
+    if not logger.handlers:
+        # Создание StreamHandler для вывода в sys.stdout
+        handler = logging.StreamHandler(sys.stdout)
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    return logger