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

mtcli/plugin_loader.py

@@ -1,81 +1,147 @@
 """
-Carregador de plugins do mtcli.
+Sistema de carregamento de plugins do mtcli.
 
-Responsável por descobrir e registrar plugins internos e externos
-utilizando entry points.
+Este módulo é responsável por descobrir e registrar plugins externos
+instalados via entry points do Python.
 
-Plugins podem expor:
+Plugins devem declarar entry points no grupo:
 
-1. função register(cli)
-2. objeto click.Command
+    mtcli.plugins
+
+Um plugin pode expor:
+
+1. Uma função ``register(cli)``
+2. Um objeto ``click.Command``
+
+Exemplo de entry point no pyproject.toml:
+
+    [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 logging
+from typing import Iterable, List
+
 import click
 
 try:
-    from importlib.metadata import entry_points
+    from importlib.metadata import EntryPoint, entry_points
 except ImportError:  # pragma: no cover
-    from importlib_metadata import entry_points
+    from importlib_metadata import EntryPoint, entry_points
 
 
 logger = logging.getLogger(__name__)
 
+PLUGIN_GROUP = "mtcli.plugins"
+
 
-def load_plugins(cli):
+def discover_plugins() -> Iterable[EntryPoint]:
     """
-    Descobre e carrega plugins registrados via entry points.
+    Descobre plugins registrados via entry points.
 
-    Args:
-        cli (click.Group): CLI principal.
+    Returns
+    -------
+    Iterable[EntryPoint]
+        Lista de entry points encontrados no grupo ``mtcli.plugins``.
     """
 
     try:
         eps = entry_points()
 
-        plugins = (
-            eps.select(group="mtcli.plugins")
-            if hasattr(eps, "select")
-            else eps.get("mtcli.plugins", [])
-        )
+        if hasattr(eps, "select"):
+            return eps.select(group=PLUGIN_GROUP)
 
-    except Exception as exc:
+        return eps.get(PLUGIN_GROUP, [])
+
+    except Exception as exc:  # pragma: no cover
         logger.error("Erro ao descobrir plugins: %s", exc)
-        return
+        return []
 
-    loaded = set()
 
-    for ep in plugins:
+def register_plugin(cli: click.Group, ep: EntryPoint) -> None:
+    """
+    Carrega e registra um plugin individual.
 
-        if ep.name in loaded:
-            logger.warning("Plugin duplicado ignorado: %s", ep.name)
-            continue
+    O plugin pode ser:
 
-        try:
+    - função register(cli)
+    - objeto click.Command
 
-            plugin = ep.load()
+    Parameters
+    ----------
+    cli : click.Group
+        CLI principal do mtcli.
+    ep : EntryPoint
+        Entry point do plugin.
+    """
 
-            # função register(cli)
-            if callable(plugin) and not isinstance(plugin, click.Command):
-                plugin(cli)
+    plugin = ep.load()
 
-            # comando click direto
-            elif isinstance(plugin, click.Command):
-                cli.add_command(plugin)
+    if callable(plugin) and not isinstance(plugin, click.Command):
+        plugin(cli)
+        logger.debug("Plugin '%s' registrado via register()", ep.name)
 
-            else:
-                raise TypeError(
-                    "Plugin não é comando Click nem função register(cli)"
-                )
+    elif isinstance(plugin, click.Command):
+        cli.add_command(plugin)
+        logger.debug("Plugin '%s' registrado como comando", ep.name)
 
-            loaded.add(ep.name)
+    else:
+        raise TypeError(
+            f"Plugin '{ep.name}' inválido: "
+            "não é click.Command nem função register(cli)"
+        )
 
-            logger.debug("Plugin carregado: %s", ep.name)
 
-        except Exception as exc:
+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 com os nomes dos 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

{mtcli-3.7.0.dev0.dist-info → mtcli-3.7.0.dev1.dist-info}/METADATA

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

{mtcli-3.7.0.dev0.dist-info → mtcli-3.7.0.dev1.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=d1hemrZeGRZcUnXzF6_lv2JFmpE6pg51AJhpwj69UhY,1850
+mtcli/plugin_loader.py,sha256=N4gNjNh6dp05iwpIvlJAybsQPdc7WPmLDpzvhn8eNQQ,3378
 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.dev0.dist-info/entry_points.txt,sha256=sFL07BcOh-MKaij-M26bNlRbmlw9Xx0CTYTPtHegfI8,99
-mtcli-3.7.0.dev0.dist-info/licenses/LICENSE,sha256=Z-2ANeRgM9IjXnHeg9mA2gillM6eTQj8sIExAGNe2-8,1092
-mtcli-3.7.0.dev0.dist-info/METADATA,sha256=6Q_T3LztXHUaDL3dtrIpelmZHZSyPDPXz08rakwY9uI,3650
-mtcli-3.7.0.dev0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mtcli-3.7.0.dev0.dist-info/RECORD,,
+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,,