import os
import logging
from django.conf import settings  # wr导入Django配置，用于获取插件相关设置

# wr创建当前模块的日志记录器，用于记录插件加载过程中的日志信息
logger = logging.getLogger(__name__)

# wr全局插件注册表：存储所有已成功加载的插件实例
_loaded_plugins = []


def load_plugins():
    """
    wr动态加载并初始化'plugins'目录中的插件。
    此函数应在Django应用注册表就绪时调用（确保Django环境已初始化）。
    """
    global _loaded_plugins  # wr声明使用全局变量_loaded_plugins
    _loaded_plugins = []  # wr清空现有插件列表，重新加载

    # wr遍历配置中激活的插件列表（settings.ACTIVE_PLUGINS定义了需要加载的插件名）
    for plugin_name in settings.ACTIVE_PLUGINS:
        # wr构建插件目录的绝对路径：PLUGINS_DIR（插件根目录） + 插件名
        plugin_path = os.path.join(settings.PLUGINS_DIR, plugin_name)

        # wr检查插件目录是否存在，且目录下是否有必要的'plugin.py'文件（插件入口）
        if os.path.isdir(plugin_path) and os.path.exists(os.path.join(plugin_path, 'plugin.py')):
            try:
                # wr导入插件模块：格式为'plugins.插件名.plugin'（对应plugin.py文件）
                plugin_module = __import__(f'plugins.{plugin_name}.plugin', fromlist=['plugin'])

                # wr检查插件模块中是否有'plugin'属性（通常是插件类的实例）
                if hasattr(plugin_module, 'plugin'):
                    plugin_instance = plugin_module.plugin  # wr获取插件实例
                    _loaded_plugins.append(plugin_instance)  # wr添加到全局注册表
                    # wr记录成功加载的日志，包含插件名和插件元数据中的名称
                    logger.info(f"Successfully loaded plugin: {plugin_name} - {plugin_instance.PLUGIN_NAME}")
                else:
                    # wr插件模块中没有'plugin'实例时记录警告
                    logger.warning(f"Plugin {plugin_name} does not have 'plugin' instance")

            except ImportError as e:
                # wr导入插件模块失败时记录错误（如文件缺失、语法错误等）
                logger.error(f"Failed to import plugin: {plugin_name}", exc_info=e)
            except AttributeError as e:
                # wr获取插件实例时发生属性错误（如缺少必要属性）
                logger.error(f"Failed to get plugin instance: {plugin_name}", exc_info=e)
            except Exception as e:
                # wr其他未预料的错误
                logger.error(f"Unexpected error loading plugin: {plugin_name}", exc_info=e)


def get_loaded_plugins():
    """
    wr获取所有已加载的插件实例列表。

    Returns:
        list: 已初始化的插件实例集合
    """
    return _loaded_plugins


def get_plugin_by_name(plugin_name):
    """
    wr根据插件名称（slug）查找插件实例。
    注：实际通过插件的plugin_slug属性匹配（与函数名对应，可能存在命名统一设计）。

    Args:
        plugin_name: 插件的slug名称（通常为插件目录名）

    Returns:
        匹配的插件实例，若未找到则返回None
    """
    for plugin in _loaded_plugins:
        if plugin.plugin_slug == plugin_name:
            return plugin
    return None


def get_plugin_by_slug(plugin_slug):
    """
    wr根据插件slug查找插件实例（与get_plugin_by_name功能一致，可能为兼容保留）。

    Args:
        plugin_slug: 插件的唯一标识符（slug）

    Returns:
        匹配的插件实例，若未找到则返回None
    """
    for plugin in _loaded_plugins:
        if plugin.plugin_slug == plugin_slug:
            return plugin
    return None


def get_plugins_info():
    """
    wr获取所有已加载插件的信息字典列表。
    信息由插件的get_plugin_info()方法提供（包含元数据和配置）。

    Returns:
        list: 每个元素为一个插件的信息字典
    """
    return [plugin.get_plugin_info() for plugin in _loaded_plugins]


def get_plugins_by_position(position):
    """
    wr筛选出支持指定显示位置的插件实例。

    Args:
        position: 位置标识（如'sidebar'、'article_bottom'等）

    Returns:
        list: 所有支持该位置的插件实例
    """
    return [plugin for plugin in _loaded_plugins if position in plugin.SUPPORTED_POSITIONS]