"""
通用单例模式基类
"""
from typing import Any, Optional, Type, TypeVar
import functools

T = TypeVar('T')

class Singleton:
    """
    一个通用的单例基类

    任何继承自该类的子类都将自动成为单例。
    它通过重写 __new__ 方法来确保每个类只有一个实例。
    同时，它处理了重复初始化的问题，确保 __init__ 方法只在第一次实例化时被调用。
    """
    _instance: Optional[Any] = None
    _initialized: bool = False

    def __new__(cls: Type[T], *args: Any, **kwargs: Any) -> T:
        """
        创建或返回现有的实例

        Args:
            *args: 传递给构造函数的位置参数
            **kwargs: 传递给构造函数的关键字参数

        Returns:
            T: 单例实例
        """
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance

    def __init__(self) -> None:
        """
        确保初始化逻辑只执行一次
        """
        if self._initialized:
            return
        self._initialized = True


def singleton(cls: Type[T]) -> Type[T]:
    """
    单例装饰器
    
    将普通类转换为单例类，确保整个应用程序中只有一个实例。
    
    Args:
        cls: 要转换为单例的类
    
    Returns:
        Type[T]: 单例类
    """
    _instance: Optional[T] = None
    _initialized: bool = False
    
    @functools.wraps(cls)
    def wrapper(*args: Any, **kwargs: Any) -> T:
        nonlocal _instance, _initialized
        
        if _instance is None:
            _instance = cls(*args, **kwargs)
        return _instance
    
    return wrapper