logger_config.py

"""
Centralized logging configuration for LedgerLens.
Provides structured logging with file rotation.
"""

import logging
import logging.handlers
from pathlib import Path


def setup_logging(log_level=logging.INFO):
    """
    Configure structured logging with file rotation.

    Args:
        log_level: Logging level (default: INFO)
    """
    # Create logs directory
    log_dir = Path("logs")
    log_dir.mkdir(exist_ok=True)

    # Configure formatters
    # JSON-like structured format for easy parsing
    file_formatter = logging.Formatter(
        '{"timestamp":"%(asctime)s","level":"%(levelname)s","logger":"%(name)s","message":"%(message)s","function":"%(funcName)s","line":%(lineno)d}'
    )

    # Simpler format for console
    console_formatter = logging.Formatter(
        '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
        datefmt='%Y-%m-%d %H:%M:%S'
    )

    # File handlers with rotation
    app_handler = logging.handlers.TimedRotatingFileHandler(
        log_dir / "app.log",
        when="midnight",
        interval=1,
        backupCount=30
    )
    app_handler.setFormatter(file_formatter)
    app_handler.setLevel(logging.DEBUG)

    error_handler = logging.FileHandler(log_dir / "error.log")
    error_handler.setFormatter(file_formatter)
    error_handler.setLevel(logging.ERROR)

    console_handler = logging.StreamHandler()
    console_handler.setFormatter(console_formatter)
    console_handler.setLevel(logging.INFO)

    # Configure root logger
    root_logger = logging.getLogger()
    root_logger.setLevel(log_level)

    # Remove existing handlers to avoid duplicates
    root_logger.handlers.clear()

    # Add handlers
    root_logger.addHandler(app_handler)
    root_logger.addHandler(error_handler)
    root_logger.addHandler(console_handler)

    # Log initialization
    root_logger.info("Logging system initialized")
    root_logger.info(f"Log directory: {log_dir.absolute()}")


def get_logger(name):
    """
    Get a logger instance.

    Args:
        name: Logger name (typically __name__)

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