mtcli 3.7.0.dev5__py3-none-any.whl → 3.7.0.dev7__py3-none-any.whl

mtcli/cli.py

@@ -1,34 +1,72 @@
-"""
-CLI principal do mtcli.
-
-Este módulo define o grupo principal `mt`
-e inicializa o carregamento de plugins.
-"""
-
-import click
-
-from mtcli.plugin_loader import load_plugins
-from .commands.bars import bars
-
-
-@click.group(context_settings={"max_content_width": 120})
-@click.version_option(package_name="mtcli")
-def mt():
-    """
-    CLI principal do mtcli.
-
-    Exibe gráficos e informações de mercado
-    em formato textual compatível com leitores de tela.
-    """
-    pass
-
-
-mt.add_command(bars, name="bars")
-
-
-# Carrega plugins automaticamente
-load_plugins(mt)
-
-
-if __name__ == "__main__":
-    mt()
+"""
+CLI principal do mtcli.
+
+Este módulo define o grupo principal `mt`
+e inicializa o carregamento de plugins.
+"""
+
+import click
+
+from mtcli.plugin_loader import load_plugins
+from mtcli.logger import setup_logger
+
+from .commands.bars import bars
+
+
+logger = setup_logger(__name__)
+
+
+@click.group(context_settings={"max_content_width": 120})
+@click.version_option(package_name="mtcli")
+def mt():
+    """
+    CLI principal do mtcli.
+
+    Exibe gráficos e informações de mercado
+    em formato textual compatível com leitores de tela.
+    """
+    pass
+
+
+# ---------------------------------------------------------
+# Comandos internos
+# ---------------------------------------------------------
+
+mt.add_command(bars, name="bars")
+
+
+# ---------------------------------------------------------
+# Carregamento de plugins
+# ---------------------------------------------------------
+
+loaded_plugins = load_plugins(mt)
+
+logger.info("Plugins carregados: %s", loaded_plugins)
+
+
+# ---------------------------------------------------------
+# Comando utilitário: listar plugins
+# ---------------------------------------------------------
+
+@mt.command(name="plugins")
+def list_plugins():
+    """
+    Lista os plugins atualmente carregados no mtcli.
+    """
+
+    if not loaded_plugins:
+        click.echo("Nenhum plugin carregado.")
+        return
+
+    click.echo("Plugins carregados:\n")
+
+    for name in loaded_plugins:
+        click.echo(f"  {name}")
+
+
+# ---------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------
+
+if __name__ == "__main__":
+    mt()

mtcli/plugin_loader.py

@@ -1,27 +1,21 @@
 """
 Sistema de carregamento de plugins do mtcli.
 
-Este módulo descobre e registra plugins de duas fontes:
+Descobre e registra plugins instalados via entry points.
 
-1. Plugins internos localizados em ``mtcli.plugins``
-2. Plugins externos registrados via entry points ``mtcli.plugins``
+Plugins devem declarar:
 
-Plugins podem expor:
-
- função ``register(cli)``
- objeto ``click.Command``
+    [project.entry-points."mtcli.plugins"]
+    nome = "pacote.plugin:register"
 
-Entry point exemplo:
+O plugin pode fornecer:
 
-    [project.entry-points."mtcli.plugins"]
-    renko = "mtcli_renko.plugin:register"
+1. register(cli)
+2. um objeto click.Command
 """
 
 from __future__ import annotations
 
-import importlib
-import logging
-import pkgutil
 from typing import Iterable, List
 
 import click
@@ -31,196 +25,99 @@ try:
 except ImportError:  # pragma: no cover
     from importlib_metadata import EntryPoint, entry_points
 
-import mtcli.plugins
+from mtcli.logger import setup_logger
 
 
-logger = logging.getLogger(__name__)
+logger = setup_logger(__name__)
 
 PLUGIN_GROUP = "mtcli.plugins"
 
 
-# ---------------------------------------------------------
-# Descoberta de plugins externos
-# ---------------------------------------------------------
-
-
-def discover_external_plugins() -> Iterable[EntryPoint]:
+def discover_plugins() -> Iterable[EntryPoint]:
     """
-    Descobre plugins externos via entry points.
+    Descobre plugins registrados via entry points.
 
     Returns
     -------
     Iterable[EntryPoint]
-        Entry points encontrados no grupo ``mtcli.plugins``.
+        Entry points encontrados.
     """
 
     try:
         eps = entry_points()
 
         if hasattr(eps, "select"):
-            return eps.select(group=PLUGIN_GROUP)
+            plugins = eps.select(group=PLUGIN_GROUP)
+        else:
+            plugins = eps.get(PLUGIN_GROUP, [])
 
-        return eps.get(PLUGIN_GROUP, [])
-
-    except Exception as exc:  # pragma: no cover
-        logger.error("Erro ao descobrir plugins externos: %s", exc)
-        return []
+        logger.debug("Plugins descobertos: %s", [ep.name for ep in plugins])
 
+        return plugins
 
-# ---------------------------------------------------------
-# Registro de plugin
-# ---------------------------------------------------------
+    except Exception as exc:
+        logger.exception("Erro ao descobrir plugins: %s", exc)
+        return []
 
 
-def register_plugin(cli: click.Group, plugin, name: str) -> None:
+def register_plugin(cli: click.Group, ep: EntryPoint) -> None:
+    """
+    Carrega e registra um plugin individual.
     """
-    Registra um plugin no CLI.
-
-    O plugin pode ser:
 
-     função ``register(cli)``
-     objeto ``click.Command``
+    logger.debug("Carregando plugin: %s -> %s", ep.name, ep.value)
 
-    Parameters
-    ----------
-    cli : click.Group
-        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()", name)
+
+        logger.info("Plugin registrado via register(): %s", ep.name)
 
     elif isinstance(plugin, click.Command):
+
         cli.add_command(plugin)
-        logger.debug("Plugin '%s' registrado como comando", name)
+
+        logger.info("Plugin registrado como comando: %s", ep.name)
 
     else:
+
         raise TypeError(
-            f"Plugin '{name}' inválido: não é click.Command nem register(cli)"
+            f"Plugin '{ep.name}' inválido: "
+            "não é click.Command nem função 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]:
+def load_plugins(cli: click.Group) -> List[str]:
     """
-    Carrega plugins externos instalados via entry points.
-
-    Returns
-    -------
-    list[str]
-        Lista de plugins carregados.
+    Descobre e carrega todos os plugins instalados.
     """
 
-    loaded = []
+    loaded: List[str] = []
     seen = set()
 
-    for ep in discover_external_plugins():
+    for ep in discover_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)
+            register_plugin(cli, ep)
 
-            loaded.append(ep.name)
             seen.add(ep.name)
+            loaded.append(ep.name)
 
         except Exception as exc:
-            logger.error(
+
+            logger.exception(
                 "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))
+    logger.info("Total de plugins carregados: %d", len(loaded))
 
     return loaded

{mtcli-3.7.0.dev5.dist-info → mtcli-3.7.0.dev7.dist-info}/METADATA

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

{mtcli-3.7.0.dev5.dist-info → mtcli-3.7.0.dev7.dist-info}/RECORD

@@ -1,5 +1,5 @@
 mtcli/__init__.py,sha256=guFO5EmCfuH8MNujJH8hw_oPg8Ee__QlQgVd-4A3N6o,84
-mtcli/cli.py,sha256=VOPMvrRQE8hiQ4qhoRikncl-slOYddMAaV3IVX1eJMA,607
+mtcli/cli.py,sha256=3ujncFjY1DFQBCo3rj4FnmU7mdSVOsUVTVIIZcFYZNE,1687
 mtcli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mtcli/commands/bars.py,sha256=JXXq9HIeFU-VKf8e2rOKTMXx_h5SRcuvKER-mlOjxjM,4205
 mtcli/commands/conf.py,sha256=UshpB9-uq1FdKwnDg2zFbdtzeEzZhiJjqFY4Ra1LeLY,910
@@ -28,8 +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 - Copia.py,sha256=8c0PPsKuOfacV2UgZkH6MmaipV7lXH4_GHrhmggP12g,2220
-mtcli/plugin_loader.py,sha256=tjLDxxGEU_29WMWjmRwYKF1kaAvHsqd8NbueVtTnAdU,5283
+mtcli/plugin_loader.py,sha256=5709Az6SEYLdyDEblzfeLWH_R7HXpZpW6pY6fgJ9btM,2746
 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
@@ -66,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.dev5.dist-info/entry_points.txt,sha256=sFL07BcOh-MKaij-M26bNlRbmlw9Xx0CTYTPtHegfI8,99
-mtcli-3.7.0.dev5.dist-info/licenses/LICENSE,sha256=Z-2ANeRgM9IjXnHeg9mA2gillM6eTQj8sIExAGNe2-8,1092
-mtcli-3.7.0.dev5.dist-info/METADATA,sha256=80GUTSdwxGX2vaql6enilI3MnUh_eJj81KbnpEg9FZQ,3650
-mtcli-3.7.0.dev5.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-mtcli-3.7.0.dev5.dist-info/RECORD,,
+mtcli-3.7.0.dev7.dist-info/entry_points.txt,sha256=sFL07BcOh-MKaij-M26bNlRbmlw9Xx0CTYTPtHegfI8,99
+mtcli-3.7.0.dev7.dist-info/licenses/LICENSE,sha256=Z-2ANeRgM9IjXnHeg9mA2gillM6eTQj8sIExAGNe2-8,1092
+mtcli-3.7.0.dev7.dist-info/METADATA,sha256=rNVn3lA9qhZc1oz59j-3pRP6TSTsSuYS_CWCfrqFgF4,3650
+mtcli-3.7.0.dev7.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mtcli-3.7.0.dev7.dist-info/RECORD,,

mtcli/plugin_loader - Copia.py

@@ -1,98 +0,0 @@
-"""
-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)
-