| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273 |
- import os
- import logging
- from logging.handlers import RotatingFileHandler
- # Holds internal logger instance, defaults to Root Logger to avoid uninitialized errors
- _active_logger = logging.getLogger()
- def set_active_logger(logger: logging.Logger):
- """Called by external logging configuration utilities to redirect all macro output."""
- global _active_logger
- _active_logger = logger
- # --- Macro definitions (supports group_id structured extra metadata) ---
- def VSC_INFO(tag, message, *args, group_id: str = ""):
- _active_logger.info(f"[{tag}] {message}", *args, extra={"group_id": group_id})
- def VSC_DEBUG(tag, message, *args, group_id: str = ""):
- _active_logger.debug(f"[{tag}] {message}", *args, extra={"group_id": group_id})
- def VSC_WARN(tag, message, *args, group_id: str = ""):
- _active_logger.warning(f"[{tag}] {message}", *args, extra={"group_id": group_id})
- def VSC_ERROR(tag, message, *args, group_id: str = ""):
- _active_logger.error(f"[{tag}] {message}", *args, extra={"group_id": group_id})
- def setup_app_logger(app_name: str, log_dir: str = "logs", extra_handlers=None) -> logging.Logger:
- """
- Configures and returns a standard Logger with console and rotating file handlers.
- """
- if not os.path.exists(log_dir):
- os.makedirs(log_dir)
- logger = logging.getLogger(app_name)
- logger.setLevel(logging.INFO)
- # Avoid adding duplicate handlers
- if not logger.handlers:
- log_file = os.path.join(log_dir, f"{app_name.lower()}.log")
- # 1. Console handler
- console_handler = logging.StreamHandler()
- console_handler.setLevel(logging.INFO)
- # 2. File handler
- file_handler = RotatingFileHandler(
- log_file, maxBytes=10 * 1024 * 1024, backupCount=10, encoding='utf-8'
- )
- file_handler.setLevel(logging.INFO)
- # Formatter
- formatter = logging.Formatter('[%(asctime)s] [%(levelname)s] %(message)s', datefmt='%Y-%m-%d %H:%M:%S')
- console_handler.setFormatter(formatter)
- file_handler.setFormatter(formatter)
- logger.addHandler(console_handler)
- logger.addHandler(file_handler)
- if extra_handlers:
- for h in extra_handlers:
- if h not in logger.handlers:
- logger.addHandler(h)
- # Inject logger into active macro logger
- set_active_logger(logger)
- return logger
|