mtcli 3.7.0.dev4__tar.gz → 3.7.0.dev5__tar.gz

{mtcli-3.7.0.dev4 → mtcli-3.7.0.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.7.0.dev4
+Version: 3.7.0.dev5
 Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly
 License-Expression: MIT
 License-File: LICENSE

mtcli-3.7.0.dev5/mtcli/plugin_loader.py

@@ -0,0 +1,226 @@
+"""
+Sistema de carregamento de plugins do mtcli.
+
+Este módulo descobre e registra plugins de duas fontes:
+
+1. Plugins internos localizados em ``mtcli.plugins``
+2. Plugins externos registrados via entry points ``mtcli.plugins``
+
+Plugins podem expor:
+
+ função ``register(cli)``
+ objeto ``click.Command``
+
+Entry point exemplo:
+
+    [project.entry-points."mtcli.plugins"]
+    renko = "mtcli_renko.plugin:register"
+"""
+
+from __future__ import annotations
+
+import importlib
+import logging
+import pkgutil
+from typing import Iterable, List
+
+import click
+
+try:
+    from importlib.metadata import EntryPoint, entry_points
+except ImportError:  # pragma: no cover
+    from importlib_metadata import EntryPoint, entry_points
+
+import mtcli.plugins
+
+
+logger = logging.getLogger(__name__)
+
+PLUGIN_GROUP = "mtcli.plugins"
+
+
+# ---------------------------------------------------------
+# Descoberta de plugins externos
+# ---------------------------------------------------------
+
+
+def discover_external_plugins() -> Iterable[EntryPoint]:
+    """
+    Descobre plugins externos via entry points.
+
+    Returns
+    -------
+    Iterable[EntryPoint]
+        Entry points encontrados no grupo ``mtcli.plugins``.
+    """
+
+    try:
+        eps = entry_points()
+
+        if hasattr(eps, "select"):
+            return eps.select(group=PLUGIN_GROUP)
+
+        return eps.get(PLUGIN_GROUP, [])
+
+    except Exception as exc:  # pragma: no cover
+        logger.error("Erro ao descobrir plugins externos: %s", exc)
+        return []
+
+
+# ---------------------------------------------------------
+# Registro de plugin
+# ---------------------------------------------------------
+
+
+def register_plugin(cli: click.Group, plugin, name: str) -> None:
+    """
+    Registra um plugin no CLI.
+
+    O plugin pode ser:
+
+     função ``register(cli)``
+     objeto ``click.Command``
+
+    Parameters
+    ----------
+    cli : click.Group
+        CLI principal.
+    plugin : Any
+        Objeto do plugin carregado.
+    name : str
+        Nome do plugin.
+    """
+
+    if callable(plugin) and not isinstance(plugin, click.Command):
+        plugin(cli)
+        logger.debug("Plugin '%s' registrado via register()", name)
+
+    elif isinstance(plugin, click.Command):
+        cli.add_command(plugin)
+        logger.debug("Plugin '%s' registrado como comando", name)
+
+    else:
+        raise TypeError(
+            f"Plugin '{name}' inválido: não é click.Command nem register(cli)"
+        )
+
+
+# ---------------------------------------------------------
+# Plugins internos
+# ---------------------------------------------------------
+
+
+def load_internal_plugins(cli: click.Group) -> List[str]:
+    """
+    Carrega plugins internos do pacote ``mtcli.plugins``.
+
+    Cada módulo deve expor a função:
+
+        register(cli)
+
+    Returns
+    -------
+    list[str]
+        Lista de plugins carregados.
+    """
+
+    loaded = []
+
+    for module_info in pkgutil.iter_modules(mtcli.plugins.__path__):
+
+        module_name = f"mtcli.plugins.{module_info.name}"
+
+        try:
+            module = importlib.import_module(module_name)
+
+            if hasattr(module, "register"):
+                module.register(cli)
+                loaded.append(module_info.name)
+
+                logger.debug("Plugin interno carregado: %s", module_info.name)
+
+        except Exception as exc:
+            logger.error(
+                "Falha ao carregar plugin interno '%s': %s",
+                module_info.name,
+                exc,
+            )
+
+    return loaded
+
+
+# ---------------------------------------------------------
+# Plugins externos
+# ---------------------------------------------------------
+
+
+def load_external_plugins(cli: click.Group) -> List[str]:
+    """
+    Carrega plugins externos instalados via entry points.
+
+    Returns
+    -------
+    list[str]
+        Lista de plugins carregados.
+    """
+
+    loaded = []
+    seen = set()
+
+    for ep in discover_external_plugins():
+
+        if ep.name in seen:
+            logger.warning("Plugin duplicado ignorado: %s", ep.name)
+            continue
+
+        try:
+            plugin = ep.load()
+
+            register_plugin(cli, plugin, ep.name)
+
+            loaded.append(ep.name)
+            seen.add(ep.name)
+
+        except Exception as exc:
+            logger.error(
+                "Falha ao carregar plugin '%s': %s",
+                ep.name,
+                exc,
+            )
+
+    return loaded
+
+
+# ---------------------------------------------------------
+# Loader principal
+# ---------------------------------------------------------
+
+
+def load_plugins(cli: click.Group) -> List[str]:
+    """
+    Carrega todos os plugins do mtcli.
+
+    Isso inclui:
+
+    • plugins internos
+    • plugins externos
+
+    Parameters
+    ----------
+    cli : click.Group
+        CLI principal.
+
+    Returns
+    -------
+    list[str]
+        Lista com todos os plugins carregados.
+    """
+
+    loaded = []
+
+    loaded.extend(load_internal_plugins(cli))
+    loaded.extend(load_external_plugins(cli))
+
+    logger.info("Plugins carregados: %d", len(loaded))
+
+    return loaded

{mtcli-3.7.0.dev4 → mtcli-3.7.0.dev5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli"
-version = "3.7.0.dev4"
+version = "3.7.0.dev5"
 description = "Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly"
 authors = [
     {name = "Valmir França da Silva",email = "vfranca3@gmail.com"}