src/logger.py

"""Logging configuration for Francis Botcon project."""

import logging
import sys
from pathlib import Path
from typing import Optional


class LoggerSetup:
    """Setup and manage application logging."""

    _logger_instance: Optional[logging.Logger] = None

    @classmethod
    def setup(cls, log_level: str = "INFO", log_file: Optional[str] = None) -> logging.Logger:
        """Setup logging configuration.

        Args:
            log_level: Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
            log_file: Optional file path for logging output

        Returns:
            Configured logger instance
        """
        if cls._logger_instance is not None:
            return cls._logger_instance

        logger = logging.getLogger("francis_botcon")
        logger.setLevel(getattr(logging, log_level.upper()))

        # Console handler
        console_handler = logging.StreamHandler(sys.stdout)
        console_handler.setLevel(getattr(logging, log_level.upper()))

        formatter = logging.Formatter(
            '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
            datefmt='%Y-%m-%d %H:%M:%S'
        )
        console_handler.setFormatter(formatter)
        logger.addHandler(console_handler)

        # File handler (if log_file provided)
        if log_file:
            log_path = Path(log_file)
            log_path.parent.mkdir(parents=True, exist_ok=True)

            file_handler = logging.FileHandler(log_path)
            file_handler.setLevel(getattr(logging, log_level.upper()))
            file_handler.setFormatter(formatter)
            logger.addHandler(file_handler)

        cls._logger_instance = logger
        return logger

    @classmethod
    def get_logger(cls) -> logging.Logger:
        """Get logger instance (creates with defaults if not yet setup)."""
        if cls._logger_instance is None:
            cls.setup()
        return cls._logger_instance


def get_logger(name: str = "francis_botcon") -> logging.Logger:
    """Get a logger instance.

    Args:
        name: Logger name

    Returns:
        Logger instance
    """
    return logging.getLogger(name)