ellmos-ai Español — Versión oficial en español de
plugin-system.
Sistema de Plugins (Español)
Sistema de plugins tolerante a fallos para aplicaciones CLI en Python. Un plugin defectuoso nunca interrumpe la ejecución del resto de la aplicación.
Características principales
- Detección automática: Encuentra automáticamente plugins en un directorio
- Validación: Comprueba
name,versionyexecute()en cada clase de plugin - Tolerancia a fallos: Los plugins defectuosos se registran en el log pero no se cargan
- Sin dependencias: Solo biblioteca estándar de Python
Archivos
scripts/
plugin_system.py Core: PluginBase (ABC) + PluginManager
cli_demo.py Demo CLI with argparse
test_plugin_system.py 16+ unit tests
examples/
hello.py Hello World plugin
calculator.py Calculator plugin
systeminfo.py System Info plugin
Inicio rápido
1. Crear un plugin
from plugin_system import PluginBase
class MyPlugin(PluginBase):
name = "MyPlugin"
version = "1.0.0"
def execute(self, *args, **kwargs):
return {"status": "ok", "message": "Hello!"}
2. Usar PluginManager
from plugin_system import PluginManager
manager = PluginManager(plugins_dir="./my_plugins")
plugins = manager.discover_plugins()
# List all plugins (Deutsch)
manager.list_plugins()
# Execute a plugin (Deutsch)
success, result = manager.execute_plugin("MyPlugin", param="value")
if success:
print(result)
3. Integrar en tu aplicación
class MyApp:
def __init__(self):
self.plugins = PluginManager("./plugins")
self.plugins.discover_plugins()
def run_command(self, command, **params):
success, result = self.plugins.execute_plugin(command, **params)
return result if success else None
Interfaz de plugin
Cada plugin debe:
| Requisito | Detalles |
|---|---|
Heredar de PluginBase |
from plugin_system import PluginBase |
Definir name |
Atributo de clase, no vacío |
Definir version |
Atributo de clase, versionado semántico |
Implementar execute() |
Parámetros arbitrarios *args, **kwargs |
Tolerancia a fallos
| Tipo de error | Comportamiento |
|---|---|
| SyntaxError en plugin | Se omite el plugin, el resto se carga |
| Atributos faltantes | El plugin se marca como is_valid=False |
Excepción en execute() |
Devuelve (False, error_message) |
| Sin plugins en el directorio | Lista vacía, sin caídas |
Historial de cambios
1.0.0 (2026-03-12)
- Migración desde MODULAR_AGENTS/plugins a la biblioteca de skills
- PluginBase ABC + PluginManager
- 3 plugins de ejemplo (Hello, Calculator, SystemInfo)
- Más de 16 pruebas unitarias
- Demo CLI con argparse