| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263 |
- # plugin_factory.py
- import importlib.util
- import sys
- import os
- from plugin import IPlugin
- from log_macros import VSC_ERROR, VSC_INFO
- class PluginFactory:
- """
- @brief Plugin factory class
- Responsible for dynamically loading and creating IPlugin implementation instances.
- """
- def __init__(self):
- self._registered_plugins = {} # {plugin_name: (module_name, class_name)}
- def register_plugin(self, plugin_name: str, module_path: str, class_name: str):
- """
- @brief Registers a plugin
- @param plugin_name Logical name of plugin
- @param module_path Python file path of plugin module (e.g. "plugins/concrete_plugin.py")
- @param class_name Name of plugin implementation class (e.g. "ConcretePlugin")
- """
- self._registered_plugins[plugin_name] = (module_path, class_name)
- VSC_INFO("factory", "Registered plugin '%s' from '%s' class '%s'", plugin_name, module_path, class_name)
- def create(self, group_id: str, plugin_name: str) -> IPlugin:
- """
- @brief Creates an IPlugin instance
- @param group_id Group ID to which instance belongs
- @param plugin_name Registered name of plugin to instantiate
- @return IPlugin instance
- """
- if plugin_name not in self._registered_plugins:
- VSC_ERROR("factory", "Plugin '%s' not registered.", plugin_name)
- raise ValueError(f"Plugin '{plugin_name}' not registered.")
-
- module_path, class_name = self._registered_plugins[plugin_name]
-
- try:
- # Dynamically load module
- spec = importlib.util.spec_from_file_location(plugin_name, module_path)
- if spec is None:
- VSC_ERROR("factory", "Failed to find module spec for '%s' at '%s'", plugin_name, module_path)
- raise ImportError(f"Could not find module spec for {plugin_name} at {module_path}")
-
- module = importlib.util.module_from_spec(spec)
- sys.modules[plugin_name] = module
- spec.loader.exec_module(module)
-
- # Fetch class and instantiate
- plugin_class = getattr(module, class_name)
- instance = plugin_class(group_id)
-
- if not isinstance(instance, IPlugin):
- VSC_ERROR("factory", "Created instance for '%s' is not an IPlugin.", plugin_name)
- raise TypeError(f"Plugin '{plugin_name}' class '{class_name}' does not implement IPlugin.")
-
- VSC_INFO("factory", "Successfully created instance for group '%s' with plugin '%s'", group_id, plugin_name)
- return instance
- except Exception as e:
- VSC_ERROR("factory", "Failed to create plugin instance '%s': %s", plugin_name, str(e))
- raise
|