logger.py

# logger.py
import logging
from logging.handlers import TimedRotatingFileHandler
from pathlib import Path

# Use a single canonical name everywhere
_LOGGER_NAME = "AskMe-FAQ-Bot"
_INITIALIZED = False

def setup_logging() -> logging.Logger:
    """
    Configure application logging (idempotent).

    Handlers:
      - Console (INFO)
      - Daily rotating file: logs/daily.log (rotates at midnight, keeps 14)
      - Aggregate file:     logs/app.log (append)

    Returns
    -------
    logging.Logger
        The configured 'AskMe-FAQ-Bot' logger.
    """
    global _INITIALIZED
    logger = logging.getLogger(_LOGGER_NAME)
    if _INITIALIZED or logger.handlers:
        return logger

    logger.setLevel(logging.INFO)
    logger.propagate = False

    log_dir = Path("logs")
    log_dir.mkdir(parents=True, exist_ok=True)

    fmt = logging.Formatter(
        "%(asctime)s | %(levelname)s | %(name)s:%(lineno)d - %(message)s",
        "%Y-%m-%d %H:%M:%S",
    )

    # Console
    ch = logging.StreamHandler()
    ch.setLevel(logging.INFO)
    ch.setFormatter(fmt)
    logger.addHandler(ch)

    # Daily rotating file
    rh = TimedRotatingFileHandler(
        log_dir / "daily.log",
        when="midnight",
        interval=1,
        backupCount=14,
        encoding="utf-8"
    )
    rh.setLevel(logging.INFO)
    rh.setFormatter(fmt)
    logger.addHandler(rh)

    # Aggregate file
    fh = logging.FileHandler(log_dir / "app.log", encoding="utf-8", mode="a")
    fh.setLevel(logging.INFO)
    fh.setFormatter(fmt)
    logger.addHandler(fh)

    _INITIALIZED = True
    logger.info("Logging initialized. Daily: %s | Aggregate: %s", log_dir / "daily.log", log_dir / "app.log")
    return logger

def get_logger() -> logging.Logger:
    """Return the configured logger without reconfiguring handlers."""
    return logging.getLogger(_LOGGER_NAME)