mtcli 3.7.0.dev1__tar.gz → 3.7.0.dev2__tar.gz

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

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

{mtcli-3.7.0.dev1 → mtcli-3.7.0.dev2}/mtcli/plugin_loader.py

@@ -1,33 +1,12 @@
 """
 Sistema de carregamento de plugins do mtcli.
 
-Este módulo é responsável por descobrir e registrar plugins externos
-instalados via entry points do Python.
+Responsável por descobrir e registrar plugins externos
+instalados via entry points.
 
 Plugins devem declarar entry points no grupo:
 
     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
@@ -55,16 +34,22 @@ def discover_plugins() -> Iterable[EntryPoint]:
     Returns
     -------
     Iterable[EntryPoint]
-        Lista de entry points encontrados no grupo ``mtcli.plugins``.
+        Entry points encontrados no grupo ``mtcli.plugins``.
     """
 
     try:
-        eps = entry_points()
 
-        if hasattr(eps, "select"):
-            return eps.select(group=PLUGIN_GROUP)
+        # 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, [])
+            return eps.get(PLUGIN_GROUP, [])
 
     except Exception as exc:  # pragma: no cover
         logger.error("Erro ao descobrir plugins: %s", exc)
@@ -75,15 +60,15 @@ def register_plugin(cli: click.Group, ep: EntryPoint) -> None:
     """
     Carrega e registra um plugin individual.
 
-    O plugin pode ser:
+    O plugin pode expor:
 
-    - função register(cli)
-    - objeto click.Command
+    - função ``register(cli)``
+    - objeto ``click.Command``
 
     Parameters
     ----------
     cli : click.Group
-        CLI principal do mtcli.
+        CLI principal.
     ep : EntryPoint
         Entry point do plugin.
     """
@@ -91,14 +76,27 @@ def register_plugin(cli: click.Group, ep: EntryPoint) -> None:
     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 função register() (%s)",
+            ep.name,
+            ep.value,
+        )
 
     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 Click (%s)",
+            ep.name,
+            ep.value,
+        )
 
     else:
+
         raise TypeError(
             f"Plugin '{ep.name}' inválido: "
             "não é click.Command nem função register(cli)"
@@ -117,7 +115,7 @@ def load_plugins(cli: click.Group) -> List[str]:
     Returns
     -------
     list[str]
-        Lista com os nomes dos plugins carregados com sucesso.
+        Lista de plugins carregados com sucesso.
     """
 
     loaded: List[str] = []
@@ -130,12 +128,14 @@ def load_plugins(cli: click.Group) -> List[str]:
             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,

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

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