logger_setup.py 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. import os
  2. import logging
  3. from logging.handlers import RotatingFileHandler
  4. # Holds internal logger instance, defaults to Root Logger to avoid uninitialized errors
  5. _active_logger = logging.getLogger()
  6. def set_active_logger(logger: logging.Logger):
  7. """Called by external logging configuration utilities to redirect all macro output."""
  8. global _active_logger
  9. _active_logger = logger
  10. # --- Macro definitions (supports group_id structured extra metadata) ---
  11. def VSC_INFO(tag, message, *args, group_id: str = ""):
  12. _active_logger.info(f"[{tag}] {message}", *args, extra={"group_id": group_id})
  13. def VSC_DEBUG(tag, message, *args, group_id: str = ""):
  14. _active_logger.debug(f"[{tag}] {message}", *args, extra={"group_id": group_id})
  15. def VSC_WARN(tag, message, *args, group_id: str = ""):
  16. _active_logger.warning(f"[{tag}] {message}", *args, extra={"group_id": group_id})
  17. def VSC_ERROR(tag, message, *args, group_id: str = ""):
  18. _active_logger.error(f"[{tag}] {message}", *args, extra={"group_id": group_id})
  19. def setup_app_logger(app_name: str, log_dir: str = "logs", extra_handlers=None) -> logging.Logger:
  20. """
  21. Configures and returns a standard Logger with console and rotating file handlers.
  22. """
  23. if not os.path.exists(log_dir):
  24. os.makedirs(log_dir)
  25. logger = logging.getLogger(app_name)
  26. logger.setLevel(logging.INFO)
  27. # Avoid adding duplicate handlers
  28. if not logger.handlers:
  29. log_file = os.path.join(log_dir, f"{app_name.lower()}.log")
  30. # 1. Console handler
  31. console_handler = logging.StreamHandler()
  32. console_handler.setLevel(logging.INFO)
  33. # 2. File handler
  34. file_handler = RotatingFileHandler(
  35. log_file, maxBytes=10 * 1024 * 1024, backupCount=10, encoding='utf-8'
  36. )
  37. file_handler.setLevel(logging.INFO)
  38. # Formatter
  39. formatter = logging.Formatter('[%(asctime)s] [%(levelname)s] %(message)s', datefmt='%Y-%m-%d %H:%M:%S')
  40. console_handler.setFormatter(formatter)
  41. file_handler.setFormatter(formatter)
  42. logger.addHandler(console_handler)
  43. logger.addHandler(file_handler)
  44. if extra_handlers:
  45. for h in extra_handlers:
  46. if h not in logger.handlers:
  47. logger.addHandler(h)
  48. # Inject logger into active macro logger
  49. set_active_logger(logger)
  50. return logger