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

mtcli/plugin_loader - Copia.py

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

mtcli/plugin_loader.py

@@ -8,8 +8,8 @@ Este módulo descobre e registra plugins de duas fontes:
 
 Plugins podem expor:
 
-• função ``register(cli)``
-• objeto ``click.Command``
+ função ``register(cli)``
+ objeto ``click.Command``
 
 Entry point exemplo:
 
@@ -78,8 +78,8 @@ def register_plugin(cli: click.Group, plugin, name: str) -> None:
 
     O plugin pode ser:
 
-    • função ``register(cli)``
-    • objeto ``click.Command``
+     função ``register(cli)``
+     objeto ``click.Command``
 
     Parameters
     ----------

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

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

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

@@ -28,7 +28,8 @@ 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=tuL2dVYvyJpat5qagG1j3lJhEJRgAhKcn6lspNZr67w,5295
+mtcli/plugin_loader - Copia.py,sha256=8c0PPsKuOfacV2UgZkH6MmaipV7lXH4_GHrhmggP12g,2220
+mtcli/plugin_loader.py,sha256=tjLDxxGEU_29WMWjmRwYKF1kaAvHsqd8NbueVtTnAdU,5283
 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 +66,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.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,,
+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,,