""" Logging configuration utilities """ import logging import sys from pathlib import Path from typing import Optional def setup_logging( level: str = "INFO", log_file: Optional[str] = None, format_string: Optional[str] = None, ) -> logging.Logger: """ Setup logging configuration Args: level: Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) log_file: Optional path to log file format_string: Optional custom format string Returns: Configured logger instance """ if format_string is None: format_string = "%(asctime)s - %(name)s - %(levelname)s - %(message)s" # Create formatter formatter = logging.Formatter(format_string) # Setup root logger root_logger = logging.getLogger() root_logger.setLevel(getattr(logging, level.upper())) # Remove existing handlers root_logger.handlers.clear() # Console handler console_handler = logging.StreamHandler(sys.stdout) console_handler.setLevel(getattr(logging, level.upper())) console_handler.setFormatter(formatter) root_logger.addHandler(console_handler) # File handler (optional) if log_file: log_path = Path(log_file) log_path.parent.mkdir(parents=True, exist_ok=True) file_handler = logging.FileHandler(log_file) file_handler.setLevel(getattr(logging, level.upper())) file_handler.setFormatter(formatter) root_logger.addHandler(file_handler) return root_logger def get_logger(name: str) -> logging.Logger: """ Get a logger instance with the given name Args: name: Logger name (usually __name__) Returns: Logger instance """ return logging.getLogger(name)