__init__.py

"""
PySide_References - Project Level Initialization

Provides centralized loguru setup for consistent logging across all widgets.
"""

import sys
from pathlib import Path
from datetime import datetime
from loguru import logger

__version__ = "0.1.0"
__all__ = ["setup_project_logging", "logger"]


def setup_project_logging(
    console_level="DEBUG",
    file_level="DEBUG", 
    log_dir=None,
    rotation="100 MB",
    retention="10 files",
    include_process_thread=True
):
    """
    Setup project-wide logging configuration.
    
    Args:
        console_level: Console logging level
        file_level: File logging level
        log_dir: Directory for log files (defaults to ./logs)
        rotation: When to rotate log files
        retention: How many log files to keep
        include_process_thread: Include process/thread info in console logs
    
    Returns:
        tuple: (console_handler_id, file_handler_id)
    """
    # Remove any existing handlers
    logger.remove()
    
    # Setup log directory
    if log_dir is None:
        log_dir = Path.cwd() / "logs"
    else:
        log_dir = Path(log_dir)
    log_dir.mkdir(exist_ok=True)
    
    # Generate log filename
    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
    log_file = log_dir / f"pyside_widgets_{timestamp}.log"
    
    # Filter for noisy libraries
    def log_filter(record):
        noisy_modules = {"urllib3", "matplotlib", "PIL", "asyncio", "websockets"}
        module_root = record["name"].split(".")[0]
        return module_root not in noisy_modules
    
    # Console format
    if include_process_thread:
        console_format = (
            "<level>{level: <8}</level> | "
            "<level>{message}</level> | "
            "<cyan>{name}</cyan>:<cyan>{function}</cyan> | "
            "<green>{time:HH:mm:ss.SSS}</green> | "
            "Process:{process.id};Thread:{thread.id}"
        )
    else:
        console_format = (
            "<level>{level: <8}</level> | "
            "<level>{message}</level> | "
            "<cyan>{name}</cyan>:<cyan>{function}</cyan> | "
            "<green>{time:HH:mm:ss.SSS}</green>"
        )
    
    # Add console handler
    console_id = logger.add(
        sys.stdout,
        format=console_format,
        level=console_level,
        colorize=True,
        filter=log_filter,
        enqueue=False,  # Must be False for Jupyter compatibility
        backtrace=True,
        diagnose=True
    )
    
    # Add file handler
    file_id = logger.add(
        log_file,
        format=(
            "{time:YYYY-MM-DD HH:mm:ss.SSS} | "
            "{level: <8} | "
            "{process.id}:{thread.id} | "
            "{name}:{function}:{line} | "
            "{message}"
        ),
        level=file_level,
        rotation=rotation,
        retention=retention,
        compression="zip",
        enqueue=True,
        backtrace=True,
        diagnose=True
    )
    
    logger.success(f"✓ Logging configured: {log_file.name}")
    logger.info(f"📁 Log directory: {log_dir.absolute()}")
    
    return console_id, file_id


# Optional: Auto-setup for notebooks
def setup_notebook_logging(**kwargs):
    """Convenience function for notebook usage with sensible defaults."""
    kwargs.setdefault("include_process_thread", False)
    return setup_project_logging(**kwargs)