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

mtcli/plugin_loader.py

@@ -1,38 +1,27 @@
 """
 Sistema de carregamento de plugins do mtcli.
 
-Este módulo é responsável por descobrir e registrar plugins externos
-instalados via entry points do Python.
+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:
 
-Um plugin pode expor:
+• função ``register(cli)``
+• objeto ``click.Command``
 
-1. Uma função ``register(cli)``
-2. Um objeto ``click.Command``
-
-Exemplo de entry point no pyproject.toml:
+Entry point exemplo:
 
     [project.entry-points."mtcli.plugins"]
     renko = "mtcli_renko.plugin:register"
-
-Ou diretamente um comando:
-
-    renko = "mtcli_renko.cli:renko"
-
-Este loader garante:
-
-- compatibilidade com Python 3.8+
-- proteção contra plugins duplicados
-- logging estruturado
-- isolamento de falhas de plugins
 """
 
 from __future__ import annotations
 
+import importlib
 import logging
+import pkgutil
 from typing import Iterable, List
 
 import click
@@ -42,20 +31,27 @@ 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
     -------
     Iterable[EntryPoint]
-        Lista de entry points encontrados no grupo ``mtcli.plugins``.
+        Entry points encontrados no grupo ``mtcli.plugins``.
     """
 
     try:
@@ -67,73 +63,123 @@ def discover_plugins() -> Iterable[EntryPoint]:
         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 ser:
 
-    - função register(cli)
-    - objeto click.Command
+    • função ``register(cli)``
+    • objeto ``click.Command``
 
     Parameters
     ----------
     cli : click.Group
-        CLI principal do mtcli.
-    ep : EntryPoint
-        Entry point do plugin.
+        CLI principal.
+    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 register()", ep.name)
+        logger.debug("Plugin '%s' registrado via register()", name)
 
     elif isinstance(plugin, click.Command):
         cli.add_command(plugin)
-        logger.debug("Plugin '%s' registrado como comando", ep.name)
+        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 com os nomes dos 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:
-            register_plugin(cli, ep)
+            plugin = ep.load()
+
+            register_plugin(cli, plugin, ep.name)
 
-            seen.add(ep.name)
             loaded.append(ep.name)
+            seen.add(ep.name)
 
         except Exception as exc:
             logger.error(
@@ -142,6 +188,39 @@ def load_plugins(cli: click.Group) -> List[str]:
                 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.dev1.dist-info → mtcli-3.7.0.dev3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.7.0.dev1
+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.dev1.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=N4gNjNh6dp05iwpIvlJAybsQPdc7WPmLDpzvhn8eNQQ,3378
+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.dev1.dist-info/entry_points.txt,sha256=sFL07BcOh-MKaij-M26bNlRbmlw9Xx0CTYTPtHegfI8,99
-mtcli-3.7.0.dev1.dist-info/licenses/LICENSE,sha256=Z-2ANeRgM9IjXnHeg9mA2gillM6eTQj8sIExAGNe2-8,1092
-mtcli-3.7.0.dev1.dist-info/METADATA,sha256=nRc1fXuF9bl9I5Gyi2tjnWIlS1erd3Twi_m_jp8H_MY,3650
-mtcli-3.7.0.dev1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mtcli-3.7.0.dev1.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,,