plugin_factory.py 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. # plugin_factory.py
  2. import importlib.util
  3. import sys
  4. import os
  5. from plugin import IPlugin
  6. from log_macros import VSC_ERROR, VSC_INFO
  7. class PluginFactory:
  8. """
  9. @brief Plugin factory class
  10. Responsible for dynamically loading and creating IPlugin implementation instances.
  11. """
  12. def __init__(self):
  13. self._registered_plugins = {} # {plugin_name: (module_name, class_name)}
  14. def register_plugin(self, plugin_name: str, module_path: str, class_name: str):
  15. """
  16. @brief Registers a plugin
  17. @param plugin_name Logical name of plugin
  18. @param module_path Python file path of plugin module (e.g. "plugins/concrete_plugin.py")
  19. @param class_name Name of plugin implementation class (e.g. "ConcretePlugin")
  20. """
  21. self._registered_plugins[plugin_name] = (module_path, class_name)
  22. VSC_INFO("factory", "Registered plugin '%s' from '%s' class '%s'", plugin_name, module_path, class_name)
  23. def create(self, group_id: str, plugin_name: str) -> IPlugin:
  24. """
  25. @brief Creates an IPlugin instance
  26. @param group_id Group ID to which instance belongs
  27. @param plugin_name Registered name of plugin to instantiate
  28. @return IPlugin instance
  29. """
  30. if plugin_name not in self._registered_plugins:
  31. VSC_ERROR("factory", "Plugin '%s' not registered.", plugin_name)
  32. raise ValueError(f"Plugin '{plugin_name}' not registered.")
  33. module_path, class_name = self._registered_plugins[plugin_name]
  34. try:
  35. # Dynamically load module
  36. spec = importlib.util.spec_from_file_location(plugin_name, module_path)
  37. if spec is None:
  38. VSC_ERROR("factory", "Failed to find module spec for '%s' at '%s'", plugin_name, module_path)
  39. raise ImportError(f"Could not find module spec for {plugin_name} at {module_path}")
  40. module = importlib.util.module_from_spec(spec)
  41. sys.modules[plugin_name] = module
  42. spec.loader.exec_module(module)
  43. # Fetch class and instantiate
  44. plugin_class = getattr(module, class_name)
  45. instance = plugin_class(group_id)
  46. if not isinstance(instance, IPlugin):
  47. VSC_ERROR("factory", "Created instance for '%s' is not an IPlugin.", plugin_name)
  48. raise TypeError(f"Plugin '{plugin_name}' class '{class_name}' does not implement IPlugin.")
  49. VSC_INFO("factory", "Successfully created instance for group '%s' with plugin '%s'", group_id, plugin_name)
  50. return instance
  51. except Exception as e:
  52. VSC_ERROR("factory", "Failed to create plugin instance '%s': %s", plugin_name, str(e))
  53. raise