log_setup.py

"""
Handles logging globally
"""

import os
from datetime import datetime
import logging
from logging.handlers import RotatingFileHandler

from directories import LOG_DIR

def setup_logging(name: str = "canoe_app") -> logging.Logger:
    """
    Creates or returns a logger with consistent configuration.
    Args:
        name: The logger name (defaults to "canoe_app")
    Returns:
        A configured logger instance
    """
    # Get or create logger
    logger = logging.getLogger(name)
    
    # Only add handlers if none exist (prevents duplicate handlers)
    if not logger.handlers:
        logger.setLevel(logging.DEBUG)

        # Build logfile name with current datetime
        timestamp = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
        log_file = os.path.join(LOG_DIR, f"canoe_app_{timestamp}.log")

        # Rotating file handler
        fh = RotatingFileHandler(log_file, maxBytes=5 * 1024 * 1024, backupCount=3, encoding="utf-8")
        fh.setLevel(logging.DEBUG)
        fh_formatter = logging.Formatter("%(asctime)s %(levelname)s %(name)s %(module)s:%(lineno)d - %(message)s")
        fh.setFormatter(fh_formatter)
        logger.addHandler(fh)

        # Console handler
        ch = logging.StreamHandler()
        ch.setLevel(logging.INFO)
        ch_formatter = logging.Formatter("%(asctime)s %(levelname)s - %(message)s", "%H:%M:%S")
        ch.setFormatter(ch_formatter)
        logger.addHandler(ch)

        # Avoid duplicate logs
        logger.propagate = False

    return logger