mtcli 3.7.0.dev2__tar.gz → 3.7.0.dev4__tar.gz

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

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

mtcli-3.7.0.dev4/mtcli/plugin_loader.py

@@ -0,0 +1,98 @@
+"""
+Sistema de carregamento de plugins do mtcli.
+
+Este módulo carrega automaticamente:
+
+1. Plugins internos localizados em `mtcli.plugins`
+2. Plugins externos registrados via entry points `mtcli.plugins`
+
+Plugins devem expor uma função:
+
+    register(cli)
+
+onde `cli` é o grupo principal do Click.
+"""
+
+import importlib
+import pkgutil
+
+import click
+
+try:
+    from importlib.metadata import entry_points
+except ImportError:  # Python < 3.10
+    from importlib_metadata import entry_points
+
+import mtcli.plugins
+
+
+def load_internal_plugins(cli: click.Group) -> None:
+    """
+    Carrega plugins internos do pacote `mtcli.plugins`.
+
+    Cada módulo encontrado deve expor a função:
+
+        register(cli)
+
+    Args:
+        cli: grupo principal do Click.
+    """
+
+    for module_info in pkgutil.iter_modules(mtcli.plugins.__path__):
+
+        module_name = f"mtcli.plugins.{module_info.name}"
+
+        module = importlib.import_module(module_name)
+
+        if hasattr(module, "register"):
+            module.register(cli)
+
+
+def load_external_plugins(cli: click.Group) -> None:
+    """
+    Carrega plugins externos instalados via entry points.
+
+    Os plugins devem declarar no pyproject.toml:
+
+        [project.entry-points."mtcli.plugins"]
+        nome = "pacote.plugin:register"
+
+    Args:
+        cli: grupo principal do Click.
+    """
+
+    eps = entry_points()
+
+    plugins = (
+        eps.select(group="mtcli.plugins")
+        if hasattr(eps, "select")
+        else eps.get("mtcli.plugins", [])
+    )
+
+    for ep in plugins:
+
+        plugin = ep.load()
+
+        if callable(plugin) and not isinstance(plugin, click.Command):
+            plugin(cli)
+
+        elif isinstance(plugin, click.Command):
+            cli.add_command(plugin)
+
+        else:
+            raise TypeError(
+                f"Plugin {ep.name} inválido: deve ser um comando Click ou função register."
+            )
+
+
+def load_plugins(cli: click.Group) -> None:
+    """
+    Carrega todos os plugins (internos e externos).
+
+    Args:
+        cli: grupo principal do Click.
+    """
+
+    load_internal_plugins(cli)
+    load_external_plugins(cli)
+

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

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

mtcli-3.7.0.dev2/mtcli/plugin_loader.py

@@ -1,147 +0,0 @@
-"""
-Sistema de carregamento de plugins do mtcli.
-
-Responsável por descobrir e registrar plugins externos
-instalados via entry points.
-
-Plugins devem declarar entry points no grupo:
-
-    mtcli.plugins
-"""
-
-from __future__ import annotations
-
-import logging
-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
-
-
-logger = logging.getLogger(__name__)
-
-PLUGIN_GROUP = "mtcli.plugins"
-
-
-def discover_plugins() -> Iterable[EntryPoint]:
-    """
-    Descobre plugins registrados via entry points.
-
-    Returns
-    -------
-    Iterable[EntryPoint]
-        Entry points encontrados no grupo ``mtcli.plugins``.
-    """
-
-    try:
-
-        # Python moderno
-        try:
-            return entry_points(group=PLUGIN_GROUP)
-        except TypeError:
-            # Compatibilidade Python antigo
-            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: %s", exc)
-        return []
-
-
-def register_plugin(cli: click.Group, ep: EntryPoint) -> None:
-    """
-    Carrega e registra um plugin individual.
-
-    O plugin pode expor:
-
-    - função ``register(cli)``
-    - objeto ``click.Command``
-
-    Parameters
-    ----------
-    cli : click.Group
-        CLI principal.
-    ep : EntryPoint
-        Entry point do plugin.
-    """
-
-    plugin = ep.load()
-
-    if callable(plugin) and not isinstance(plugin, click.Command):
-
-        plugin(cli)
-
-        logger.debug(
-            "Plugin '%s' registrado via função register() (%s)",
-            ep.name,
-            ep.value,
-        )
-
-    elif isinstance(plugin, click.Command):
-
-        cli.add_command(plugin)
-
-        logger.debug(
-            "Plugin '%s' registrado como comando Click (%s)",
-            ep.name,
-            ep.value,
-        )
-
-    else:
-
-        raise TypeError(
-            f"Plugin '{ep.name}' inválido: "
-            "não é click.Command nem função register(cli)"
-        )
-
-
-def load_plugins(cli: click.Group) -> List[str]:
-    """
-    Descobre e carrega todos os plugins instalados.
-
-    Parameters
-    ----------
-    cli : click.Group
-        CLI principal do mtcli.
-
-    Returns
-    -------
-    list[str]
-        Lista de plugins carregados com sucesso.
-    """
-
-    loaded: List[str] = []
-    seen = set()
-
-    for ep in discover_plugins():
-
-        if ep.name in seen:
-            logger.warning("Plugin duplicado ignorado: %s", ep.name)
-            continue
-
-        try:
-
-            register_plugin(cli, ep)
-
-            seen.add(ep.name)
-            loaded.append(ep.name)
-
-        except Exception as exc:
-
-            logger.error(
-                "Falha ao carregar plugin '%s': %s",
-                ep.name,
-                exc,
-            )
-
-    logger.info("Plugins carregados: %d", len(loaded))
-
-    return loaded