mtcli 3.7.0.dev2__py3-none-any.whl → 3.7.0.dev3__py3-none-any.whl

mtcli/plugin_loader.py

@@ -1,17 +1,27 @@
 """
 Sistema de carregamento de plugins do mtcli.
 
-Responsável por descobrir e registrar plugins externos
-instalados via entry points.
+Este módulo descobre e registra plugins de duas fontes:
 
-Plugins devem declarar entry points no grupo:
+1. Plugins internos localizados em ``mtcli.plugins``
+2. Plugins externos registrados via entry points ``mtcli.plugins``
 
-    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
@@ -21,15 +31,22 @@ try:
 except ImportError:  # pragma: no cover
     from importlib_metadata import EntryPoint, entry_points
 
+import mtcli.plugins
+
 
 logger = logging.getLogger(__name__)
 
 PLUGIN_GROUP = "mtcli.plugins"
 
 
-def discover_plugins() -> Iterable[EntryPoint]:
+# ---------------------------------------------------------
+# Descoberta de plugins externos
+# ---------------------------------------------------------
+
+
+def discover_external_plugins() -> Iterable[EntryPoint]:
     """
-    Descobre plugins registrados via entry points.
+    Descobre plugins externos via entry points.
 
     Returns
     -------
@@ -38,110 +55,172 @@ def discover_plugins() -> Iterable[EntryPoint]:
     """
 
     try:
+        eps = entry_points()
 
-        # 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)
+        if hasattr(eps, "select"):
+            return eps.select(group=PLUGIN_GROUP)
 
-            return eps.get(PLUGIN_GROUP, [])
+        return eps.get(PLUGIN_GROUP, [])
 
     except Exception as exc:  # pragma: no cover
-        logger.error("Erro ao descobrir plugins: %s", exc)
+        logger.error("Erro ao descobrir plugins externos: %s", exc)
         return []
 
 
-def register_plugin(cli: click.Group, ep: EntryPoint) -> None:
+# ---------------------------------------------------------
+# Registro de plugin
+# ---------------------------------------------------------
+
+
+def register_plugin(cli: click.Group, plugin, name: str) -> None:
     """
-    Carrega e registra um plugin individual.
+    Registra um plugin no CLI.
 
-    O plugin pode expor:
+    O plugin pode ser:
 
-    - função ``register(cli)``
-    - objeto ``click.Command``
+    • função ``register(cli)``
+    • objeto ``click.Command``
 
     Parameters
     ----------
     cli : click.Group
         CLI principal.
-    ep : EntryPoint
-        Entry point do plugin.
+    plugin : Any
+        Objeto do plugin carregado.
+    name : str
+        Nome 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,
-        )
+        logger.debug("Plugin '%s' registrado via register()", name)
 
     elif isinstance(plugin, click.Command):
-
         cli.add_command(plugin)
-
-        logger.debug(
-            "Plugin '%s' registrado como comando Click (%s)",
-            ep.name,
-            ep.value,
-        )
+        logger.debug("Plugin '%s' registrado como comando", name)
 
     else:
-
         raise TypeError(
-            f"Plugin '{ep.name}' inválido: "
-            "não é click.Command nem função register(cli)"
+            f"Plugin '{name}' inválido: não é click.Command nem register(cli)"
         )
 
 
-def load_plugins(cli: click.Group) -> List[str]:
+# ---------------------------------------------------------
+# Plugins internos
+# ---------------------------------------------------------
+
+
+def load_internal_plugins(cli: click.Group) -> List[str]:
     """
-    Descobre e carrega todos os plugins instalados.
+    Carrega plugins internos do pacote ``mtcli.plugins``.
 
-    Parameters
-    ----------
-    cli : click.Group
-        CLI principal do mtcli.
+    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 com sucesso.
+        Lista de plugins carregados.
     """
 
-    loaded: List[str] = []
+    loaded = []
     seen = set()
 
-    for ep in discover_plugins():
+    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, ep)
+            register_plugin(cli, plugin, ep.name)
 
-            seen.add(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.dev2.dist-info → mtcli-3.7.0.dev3.dist-info}/METADATA

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

{mtcli-3.7.0.dev2.dist-info → mtcli-3.7.0.dev3.dist-info}/RECORD

@@ -28,7 +28,7 @@ mtcli/models/signals_model.py,sha256=XhyCErgyuHF0o85vnjIVJlgsCF7XFsWQltSbLZ3Aals
 mtcli/models/unconsecutive_bar_model.py,sha256=AiClcoyYnk3K6D1YkC0E2PRUhbGwsjdSnh1vIHZsIe8,2079
 mtcli/mt5_context.py,sha256=oLevCe4nYeZ6VtGoaO-j7U4xzACE09wGmX38P0oRg5A,2147
 mtcli/plugin.py,sha256=Wabbr22BVi32D-XNM7XS45bRdgKob7EKO6TuWtq9_ZM,414
-mtcli/plugin_loader.py,sha256=vj3vUf_kfl6w4l7enUoTAbJlmdvPmUX1aBaC8P3H-Gk,3218
+mtcli/plugin_loader.py,sha256=tuL2dVYvyJpat5qagG1j3lJhEJRgAhKcn6lspNZr67w,5295
 mtcli/plugin_manager.py,sha256=JTK6rmhjLa9MdyUiGgufAAnaaBhUI1Bm4g4t6p18WdU,555
 mtcli/plugins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mtcli/plugins/exemplo.py-dist,sha256=q8H_sBpI-IZej9RvkCl2o_br9q2z_WXXn_qA1MRRbBo,538
@@ -65,8 +65,8 @@ mtcli/views/ranges_view.py,sha256=5gA2bAJuco-Xj964nsjs87tZ-079O7xKvaeif1UJ-PQ,12
 mtcli/views/rates_view.py,sha256=Jkdbg-Q_OVJuID-Q9HFUVICCF1jE82d-qfZWNm1JJ_4,1214
 mtcli/views/vars_view.py,sha256=Vpcej41qnZSvvSyvXYyW8W7CEFdqTxBd8NczV84XPJY,1635
 mtcli/views/volumes_view.py,sha256=d_6YxM0vA1revwoPwnwUjV19KcqnddVgdpBHTt5Vqms,1575
-mtcli-3.7.0.dev2.dist-info/entry_points.txt,sha256=sFL07BcOh-MKaij-M26bNlRbmlw9Xx0CTYTPtHegfI8,99
-mtcli-3.7.0.dev2.dist-info/licenses/LICENSE,sha256=Z-2ANeRgM9IjXnHeg9mA2gillM6eTQj8sIExAGNe2-8,1092
-mtcli-3.7.0.dev2.dist-info/METADATA,sha256=_eWz6YOhk378zYlsV--M4yD-l0kNDy1PcaoPSqZrBxU,3650
-mtcli-3.7.0.dev2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mtcli-3.7.0.dev2.dist-info/RECORD,,
+mtcli-3.7.0.dev3.dist-info/entry_points.txt,sha256=sFL07BcOh-MKaij-M26bNlRbmlw9Xx0CTYTPtHegfI8,99
+mtcli-3.7.0.dev3.dist-info/licenses/LICENSE,sha256=Z-2ANeRgM9IjXnHeg9mA2gillM6eTQj8sIExAGNe2-8,1092
+mtcli-3.7.0.dev3.dist-info/METADATA,sha256=GFkl2N34O4Pj9I0P-ikGqTtkuDi48PW8L-K-jYQhG9M,3650
+mtcli-3.7.0.dev3.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mtcli-3.7.0.dev3.dist-info/RECORD,,