import logging # 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})