"""
结构化日志配置

使用 structlog 实现结构化、可观测的日志，便于生产环境排查与聚合。
"""

import logging
import sys
from typing import Any

# 尝试使用 structlog，若未安装则回退到标准 logging
try:
    import structlog

    USE_STRUCTLOG = True
except ImportError:
    USE_STRUCTLOG = False


def configure_logging(debug: bool = False) -> None:
    """
    配置应用日志

    Args:
        debug: 是否为调试模式
    """
    log_level = logging.DEBUG if debug else logging.INFO

    if USE_STRUCTLOG:
        structlog.configure(
            processors=[
                structlog.stdlib.filter_by_level,
                structlog.stdlib.add_logger_name,
                structlog.stdlib.add_log_level,
                structlog.stdlib.PositionalArgumentsFormatter(),
                structlog.processors.TimeStamper(fmt="iso"),
                structlog.processors.StackInfoRenderer(),
                structlog.processors.format_exc_info,
                structlog.processors.UnicodeDecoder(),
                structlog.dev.ConsoleRenderer() if debug else structlog.processors.JSONRenderer(),
            ],
            wrapper_class=structlog.stdlib.BoundLogger,
            context_class=dict,
            logger_factory=structlog.stdlib.LoggerFactory(),
            cache_logger_on_first_use=True,
        )
    else:
        logging.basicConfig(
            level=log_level,
            format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
            stream=sys.stdout,
        )


def get_logger(name: str):
    """获取 logger 实例"""
    if USE_STRUCTLOG:
        return structlog.get_logger(name)
    return logging.getLogger(name)