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