<img src="../banner.png" width="100%" alt="plugin-system banner">

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, version y execute() 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