pluginforge 0.4.0__tar.gz → 0.5.0__tar.gz

{pluginforge-0.4.0 → pluginforge-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pluginforge
-Version: 0.4.0
+Version: 0.5.0
 Summary: Application-agnostic plugin framework built on pluggy
 License: MIT
 License-File: LICENSE
@@ -105,18 +105,24 @@ for plugin in pm.get_active_plugins():
 # Mount FastAPI routes
 from fastapi import FastAPI
 app = FastAPI()
-pm.mount_routes(app)  # Routes at /api/plugins/{name}/
+pm.mount_routes(app)  # Routes under /api/ (configurable prefix)
 ```
 
 ## Features
 
 - **YAML Configuration** - App config, per-plugin config, and i18n strings
 - **Plugin Lifecycle** - init, activate, deactivate with error handling
+- **Hot-Reload** - Swap plugins at runtime without app restart
 - **Enable/Disable** - Control plugins via config lists
 - **Dependency Resolution** - Topological sorting with circular dependency detection
-- **FastAPI Integration** - Auto-mount plugin routes under `/api/plugins/{name}/`
+- **Extension Points** - Query plugins by interface with `get_extensions(type)`
+- **Config Schema Validation** - Declare expected config types per plugin
+- **Health Checks** - Monitor plugin status via `health_check()`
+- **Pre-Activate Hooks** - Reject plugins before activation (license checks, etc.)
+- **FastAPI Integration** - Mount plugin routes with configurable prefix
 - **Alembic Support** - Collect migration directories from plugins
 - **i18n** - Multi-language strings from YAML with fallback
+- **Security** - Plugin name validation and path traversal prevention
 
 For detailed documentation, see the [Wiki](https://github.com/astrapi69/pluginforge/wiki).
 
@@ -161,10 +167,13 @@ The full documentation is available in the [Wiki](https://github.com/astrapi69/p
 - [Discovery and Dependencies](https://github.com/astrapi69/pluginforge/wiki/Discovery-and-Dependencies)
 - [Lifecycle](https://github.com/astrapi69/pluginforge/wiki/Lifecycle)
 - [Hooks](https://github.com/astrapi69/pluginforge/wiki/Hooks)
+- [Extensions](https://github.com/astrapi69/pluginforge/wiki/Extensions)
 - [FastAPI Integration](https://github.com/astrapi69/pluginforge/wiki/FastAPI-Integration)
 - [Alembic Integration](https://github.com/astrapi69/pluginforge/wiki/Alembic-Integration)
 - [i18n](https://github.com/astrapi69/pluginforge/wiki/i18n)
+- [Security](https://github.com/astrapi69/pluginforge/wiki/Security)
 - [Examples](https://github.com/astrapi69/pluginforge/wiki/Examples)
+- [Changelog](https://github.com/astrapi69/pluginforge/wiki/Changelog)
 
 ## Development
 

{pluginforge-0.4.0 → pluginforge-0.5.0}/README.md

@@ -80,18 +80,24 @@ for plugin in pm.get_active_plugins():
 # Mount FastAPI routes
 from fastapi import FastAPI
 app = FastAPI()
-pm.mount_routes(app)  # Routes at /api/plugins/{name}/
+pm.mount_routes(app)  # Routes under /api/ (configurable prefix)
 ```
 
 ## Features
 
 - **YAML Configuration** - App config, per-plugin config, and i18n strings
 - **Plugin Lifecycle** - init, activate, deactivate with error handling
+- **Hot-Reload** - Swap plugins at runtime without app restart
 - **Enable/Disable** - Control plugins via config lists
 - **Dependency Resolution** - Topological sorting with circular dependency detection
-- **FastAPI Integration** - Auto-mount plugin routes under `/api/plugins/{name}/`
+- **Extension Points** - Query plugins by interface with `get_extensions(type)`
+- **Config Schema Validation** - Declare expected config types per plugin
+- **Health Checks** - Monitor plugin status via `health_check()`
+- **Pre-Activate Hooks** - Reject plugins before activation (license checks, etc.)
+- **FastAPI Integration** - Mount plugin routes with configurable prefix
 - **Alembic Support** - Collect migration directories from plugins
 - **i18n** - Multi-language strings from YAML with fallback
+- **Security** - Plugin name validation and path traversal prevention
 
 For detailed documentation, see the [Wiki](https://github.com/astrapi69/pluginforge/wiki).
 
@@ -136,10 +142,13 @@ The full documentation is available in the [Wiki](https://github.com/astrapi69/p
 - [Discovery and Dependencies](https://github.com/astrapi69/pluginforge/wiki/Discovery-and-Dependencies)
 - [Lifecycle](https://github.com/astrapi69/pluginforge/wiki/Lifecycle)
 - [Hooks](https://github.com/astrapi69/pluginforge/wiki/Hooks)
+- [Extensions](https://github.com/astrapi69/pluginforge/wiki/Extensions)
 - [FastAPI Integration](https://github.com/astrapi69/pluginforge/wiki/FastAPI-Integration)
 - [Alembic Integration](https://github.com/astrapi69/pluginforge/wiki/Alembic-Integration)
 - [i18n](https://github.com/astrapi69/pluginforge/wiki/i18n)
+- [Security](https://github.com/astrapi69/pluginforge/wiki/Security)
 - [Examples](https://github.com/astrapi69/pluginforge/wiki/Examples)
+- [Changelog](https://github.com/astrapi69/pluginforge/wiki/Changelog)
 
 ## Development
 

{pluginforge-0.4.0 → pluginforge-0.5.0}/pluginforge/__init__.py

@@ -5,7 +5,7 @@ from pluginforge.discovery import CircularDependencyError
 from pluginforge.manager import PluginManager
 from pluginforge.security import InvalidPluginNameError
 
-__version__ = "0.3.0"
+__version__ = "0.5.0"
 __all__ = [
     "BasePlugin",
     "CircularDependencyError",

{pluginforge-0.4.0 → pluginforge-0.5.0}/pluginforge/manager.py

@@ -305,18 +305,90 @@ class PluginManager:
     def call_hook(self, hook_name: str, **kwargs: Any) -> list[Any]:
         """Call a named hook on all registered plugins.
 
+        Individual hook implementations that raise exceptions are caught and
+        logged. Other implementations still execute (graceful degradation).
+
+        Args:
+            hook_name: Name of the hook to call.
+            **kwargs: Arguments to pass to hook implementations.
+
+        Returns:
+            List of results from all hook implementations (failed ones are skipped).
+        """
+        hook = getattr(self._pm.hook, hook_name, None)
+        if hook is None:
+            logger.warning("Hook '%s' not found", hook_name)
+            return []
+        try:
+            return hook(**kwargs)
+        except Exception as e:
+            logger.error("Hook '%s' raised an exception: %s", hook_name, e)
+            return []
+
+    def call_hook_safe(self, hook_name: str, **kwargs: Any) -> list[Any]:
+        """Call a hook, collecting results and skipping failed implementations.
+
+        Unlike call_hook(), this calls each implementation individually so one
+        failure does not prevent others from executing.
+
         Args:
             hook_name: Name of the hook to call.
             **kwargs: Arguments to pass to hook implementations.
 
         Returns:
-            List of results from all hook implementations.
+            List of successful results (failed implementations are logged and skipped).
         """
         hook = getattr(self._pm.hook, hook_name, None)
         if hook is None:
             logger.warning("Hook '%s' not found", hook_name)
             return []
-        return hook(**kwargs)
+        results: list[Any] = []
+        callers = hook.get_hookimpls()
+        for impl in callers:
+            try:
+                result = impl.function(**kwargs)
+                results.append(result)
+            except Exception as e:
+                plugin_name = impl.plugin_name or "unknown"
+                logger.error(
+                    "Hook '%s' implementation from '%s' failed: %s",
+                    hook_name,
+                    plugin_name,
+                    e,
+                )
+        return results
+
+    def get_plugin_hooks(self, name: str) -> list[str]:
+        """Return hook names implemented by a specific plugin.
+
+        Useful for debugging, settings UIs, and plugin marketplaces.
+
+        Args:
+            name: Plugin name.
+
+        Returns:
+            List of hook names the plugin implements, or empty list if not found.
+        """
+        plugin = self._lifecycle.get_plugin(name)
+        if plugin is None:
+            return []
+        impl_marker = f"{self._entry_point_group}_impl"
+        hooks: list[str] = []
+        for attr_name in dir(plugin):
+            if attr_name.startswith("_"):
+                continue
+            method = getattr(plugin, attr_name, None)
+            if callable(method) and hasattr(method, impl_marker):
+                hooks.append(attr_name)
+        return hooks
+
+    def get_all_hook_names(self) -> list[str]:
+        """Return all registered hook spec names.
+
+        Returns:
+            List of hook names from all registered specs.
+        """
+        return [name for name in dir(self._pm.hook) if not name.startswith("_")]
 
     def mount_routes(self, app: object, prefix: str = "/api") -> None:
         """Mount FastAPI routes from all active plugins.

{pluginforge-0.4.0 → pluginforge-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pluginforge"
-version = "0.4.0"
+version = "0.5.0"
 description = "Application-agnostic plugin framework built on pluggy"
 authors = ["Asterios Raptis"]
 license = "MIT"