"""
Logging configuration for EPyR Tools.
This module provides centralized logging configuration for the entire package.
"""
import logging
import sys
from pathlib import Path
from typing import Optional
[docs]
def setup_logging(
level: str = "INFO",
log_file: Optional[Path] = None,
format_string: Optional[str] = None,
) -> logging.Logger:
"""Set up logging configuration for EPyR Tools.
Args:
level: Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
log_file: Optional file path for logging output
format_string: Optional custom format string
Returns:
Configured logger instance
"""
if format_string is None:
format_string = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
# Create formatter
formatter = logging.Formatter(format_string)
# Get root logger for EPyR
logger = logging.getLogger("epyr")
logger.setLevel(getattr(logging, level.upper()))
# Remove existing handlers to avoid duplicates
for handler in logger.handlers[:]:
logger.removeHandler(handler)
# Console handler
console_handler = logging.StreamHandler(sys.stdout)
console_handler.setLevel(getattr(logging, level.upper()))
console_handler.setFormatter(formatter)
logger.addHandler(console_handler)
# File handler (if specified)
if log_file:
file_handler = logging.FileHandler(log_file)
file_handler.setLevel(getattr(logging, level.upper()))
file_handler.setFormatter(formatter)
logger.addHandler(file_handler)
return logger
[docs]
def get_logger(name: str) -> logging.Logger:
"""Get a logger for a specific module.
Args:
name: Module name (typically __name__)
Returns:
Logger instance
"""
return logging.getLogger(f"epyr.{name}")
# Default logger setup
_default_logger = setup_logging()